Ashley Whetter
Ashley Whetter
Sphinx 7.4.0 introduced this feature so we should now be able to proceed with proper type alias support.
Sphinx 4 introduced a `:canonical:` option to some of the directives (https://www.sphinx-doc.org/en/master/usage/domains/python.html#directive-option-py-class-canonical). We should make use of this in the templates.
To any newcomers looking to resolve this issue, the parser currently retrieves the attributes of base classes in this for loop: https://github.com/readthedocs/sphinx-autoapi/blob/7872ed00b0c8052d13372b2ec2bddf237dbfc60c/autoapi/mappers/python/parser.py#L126 The loop will need to check if it...
Thank you so much for providing a reproducible case. This helped greatly. The issue here is partly AutoAPI's fault and partly Sphinx's. AutoAPI documents file3 something like this: ``` .....
Do you have a branch of pymor that's using autoapi that I can test with? I don't think the conditionals are the problem but I can't tell what the problem...
I'm afraid that I don't have a better answer to this problem other than to override the entire template. Exactly how templates should be overridden, if at all, needs some...
You'd be using undocumented parts of AutoAPI, but I think you can achieve what you're looking for. `obj` has an attribute `obj`, which is a dictionary of values that it...
We currently don't document much of the API of objects. They get used in templates and in hooks like this. So by not documenting that bit of the API, we...
Actually, `original_path` is only set for imported members. Not inherited ones. So I don't think that my suggested workaround will work after all. Furthermore, the implementation will require setting `original_path`...
I wouldn't want to have to maintain two sets of templates (one in rst and one in markdown) so I think it makes sense to let users do that themselves...