[TYPO3-doc] left nav menu is always collapsed?

[Jacob Floyd]

Quote: Philipp Gampe (pgampe) wrote on Thu, 18 July 2013 12:59
----------------------------------------------------
> You need to have the correct order of menus. If you use different styles say 
> both ''''''''''' and ^^^^^^^^ for the third level menu, then it will not 
> work.
> 
> Same thing happens if you mix the nesting in different parts of the reST 
> structure.
> 
> 
> Actually you use different ways to markup headlines ... you can verify that 
> if you look at the source of the given link (validators) and then compare 
> this to quickstart.

The Validation chapter[1] looks consistent to me. We use:

=========
HEADING 1
=========

HEADING 2
=========

HEADING 3
---------

In [1] where is the inconsistency? You mentioned heading 3, but they both look right to me. A line number might be helpful if the consistency issue is within this file.

Here's how we do it in the Quickstart guide:

HEADING 1
=========

HEADING 2
---------

HEADING 3
~~~~~~~~~

OK, the difference I see here is that heading 1 uses just underline and not both underline and overline. Is the overline confusing things?

Or, is the menu generator confused because we use the same character for both heading 1 and heading 2, the only difference being that heading 1 includes an overline?

Or are you saying that all rest files within the Flow package need to use headings consistently? So the character used must be the same in both Quickstart and The Definitive Guide?



I'm so excited to possibly maybe be able to fix the menus on docs.typo3.org. Thanks for looking into this Philipp!

I will gladly change all of the headings in all of the flow guides and push a changeset to gerrit tomorrow if such a change is necessary. Please help me to understand what to change and why the change is needed. My changeset will include a page in the Publications Style Guide that explains whatever the headings requirements are within our docs.

Thanks!
Jacob Floyd

[1] https://git.typo3.org/Packages/TYPO3.Flow.git/blob/HEAD:/Documentation/TheDefinitiveGuide/PartIII/Validation.rst
[2] https://git.typo3.org/Packages/TYPO3.Flow.git/blob/HEAD:/Documentation/Quickstart/Index.rst