Hi,

not sure how helpful, but here are my 2 cents.

On Monday, 4 February 2019 20:13:20 UTC+1, KDMortimer wrote:
>
> Now, my best guess is that this is happening because manual.rst has these 
> Chapter headings at the highest level. This means that all of the 
> 'Chapters' end up on a single 'page' in the output, and the HTML title is 
> the title of Chapter 1 (even if you end up in Chapter 4). This also seems 
> to strip the the section id from Chapter 1 during the rst > html 
> translation, as navigation to the top of Chapter 1 uses "manual.html#", 
> instead of something like "manual.html#chapter1".
>
I find a bit difficult to visualise what you mean, I tried to quickly 
reproduce but without success. A minimum example would help...


> I can foresee two fixes right now but have problems with both.
> #1. Adding a 'title' heading above chapters. However, this would be an 
> extra superfluous level of TOC tree, which is a problem when my document 
> already has subsubsubsubsections! (Working on that too)
> #2. Splitting each chapter into a separate .rst. However, there are a 
> number of internal references inside tables which would need to be 
> refactored (just manual labour, really).
>
If you have used :ref:<label> for cross-referencing, you should not need 
any refactroring, since :ref: works on different source files as well.

Regards,
Stefano

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to