[
https://issues.apache.org/jira/browse/SOLR-10612?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15999401#comment-15999401
]
Cassandra Targett commented on SOLR-10612:
------------------------------------------
bq. but in jekyll, asciidoctor isn't responsible for generating the TOC –
instead it's done by some javascript
Just to be technically accurate, the javascript doesn't come from Jekyll. It
comes from the theme for Jekyll that I adapted for our use
(https://github.com/tomjohnson1492/documentation-theme-jekyll).
We could rip it out entirely pretty easily and replace it with a global
{{:toc:}} directive, and allow pages to declare their own {{:toclevels:}} as
appropriate. This might be a simpler approach for ongoing management: all the
"rules" would be in the asciidoctor attributes so it would be clear what's
going on - but would require a little bit of work to get it to look similar
(probably mostly CSS tweaks).
> make ':toclevels:' work in our jekyll templates
> -----------------------------------------------
>
> Key: SOLR-10612
> URL: https://issues.apache.org/jira/browse/SOLR-10612
> Project: Solr
> Issue Type: Sub-task
> Security Level: Public(Default Security Level. Issues are Public)
> Components: documentation
> Reporter: Hoss Man
> Assignee: Hoss Man
>
> asciidoc has a concept called {{:toclevels:}} which is suppose to determine
> which how deep down a page's section/header depth the generated table of
> contents will show -- ie: some LONG pages have a huge number of level 2
> headings, and on those pages we only want to show level 1.
> but in jekyll, asciidoctor isn't responsible for generating the TOC --
> instead it's done by some javascript (which is better for a variety of
> reasons) and at the moment this javascript doesn't know anything about
> {{:toclevels:}}
> But it should be possible to tweak our rendering templates to include
> {{:toclevels:}} as an attribute in the generated HTML, and then we can tweak
> the javascript call made to generate the TOC so that it respects it on a
> per-page basis
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
