For the record, we have exactly the same set of needs. A collapsing version 
of the HMTL left-hand side TOC would replicate more or less what a PDF 
reader does, and would make it much nicer.

- thomas

On Wednesday, October 28, 2015 at 5:49:15 AM UTC, Willem Ferguson wrote:
>
> I maintain a user manual for diving software (subsurface-divelog.org). 
> The html manual is becoming quite large in size and also in terms of the 
> number of headings. Consequently the toc is becoming very long and, 
> consequently, less useful. We believe that decreasing the number of heading 
> levels in the toc would be counterproductive. But I need to do something to 
> make the text more navigable by the first-time user. There are  a few 
> options, but all of these mean that the toc should be more interactive. I 
> am acutely aware that asciidoc is not meant to generate dynamic in-text 
> features but is in principle comparable to a layout language such as latex. 
> But I am trying to find out what is still possible within the asciidoc 
> environment.
>
> 1) Using a .toc2 instruction, the scrollable toc could be placed on the 
> left. However two problems: a) the width of the frame within the toc sits 
> is rather narrow, at least for heading that are more than just two or three 
> words, the width of the frame is, as far as i am aware not user-changeable. 
> Consequently a specific heading wraps around several times, making the text 
> less readable. can one control the font size in the .toc2 implementation at 
> all to try and reduce the amount of wrapping of individual toc items?
>
> 2) Using the .toc instruction, the toc is placed within the main text. 
> Ideally une would only list the chapter headings in the toc, but with each 
> chapter heading being expandable to see all the headings within that 
> chapter. But I have not seen that asciidoc has such a feature.
>
> Any suggestions on how to deal with long toc's would be highly appreciated.
> Kind regards,
> willem ferguson
>
>
>
>

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" 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 http://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to