Improve logical information for labels to Ansible objects#216
Improve logical information for labels to Ansible objects#216felixfontein wants to merge 3 commits intoansible-community:mainfrom
Conversation
|
One problem is that the current solution works well with HTML generation, but not at all with LaTeX. I tried to play around with that the last days, but didn't had much time, and the only way I got it to work with both HTML and LaTeX writers resulted in a large amount of WARNINGS and CRITICAL errors (which did not impact functionality, since the collisions they complained about were intentional). I'll try to spend some more time figuring out how to do this properly... |
fc96a1f to
8709d51
Compare
8709d51 to
c887263
Compare
|
I think a better way is to allow doc2dash to change/remove labels with a (say) JSON file, and then dump such a JSON file from antsibull-docs. That allows us to obtain all these extra details without doing dirty tricks to try to make Sphinx output the titles for references that we want in the Interspinx file. |



Fixes #203.
Current version (Zeal 'Sections' screenshot of HTML docsite converted with doc2dash):

The n-fold 'Requirements' section still shows up, but at least the references to all return values and options look much better! Also, there's now an index with all modules, plugins, and roles (if you tell Sphinx to generate it):