phpDocumentor / guides

Guides library to parse documentation
MIT License
32 stars 15 forks source link

Support Sphinx :reversed: on .. toctree:: #1148

Open d-s-codappix opened 1 week ago

d-s-codappix commented 1 week ago

Feature request

The .. toctree:: directive of Sphinx has an option :reversed: which will invert the order of entries: https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-option-toctree-reversed

This is useful for situations like:

.. _changelog:

Changelog
=========

.. toctree::
   :glob:
   :reversed:

   Changelog/*

That way newest versions are at the top.

Would be cool to have that supported. Right now the option seems to be ignored.

We use this here: https://github.com/werkraum-media/events/blob/main/Documentation/Changelog.rst rendered result: https://docs.typo3.org/p/werkraummedia/events/main/en-us/Changelog.html

jaapio commented 6 days ago

If I get this right it will only order the documents in reverse not the sub headings?