[
https://issues.apache.org/jira/browse/SOLR-10612?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Hoss Man updated SOLR-10612:
----------------------------
Attachment: SOLR-10612.patch
bq. +1 for where you are so far.
Ok, cool .. glad you figured out that CSS thing.
Updated patch:
* css tweak so that right floating TOCs only float right on screens big enough
for it to look good -- otherwise they're just regular tocs
* hide section-toc macro in PDF output
* javascript refactoring and cleanup
* improve javascript so "section-toc" now works regardless of level -- so if
you put it under a {{==}} header, it will give you the TOC of everything in the
current section until the next {{==}} ... but if you put it under a {{===}}
header it will give you everything in the current _sub_-section until the next
{{===}}
** NOTE: because of how we're using an attribute for this, there is no control
of how deep the subsection-toc will go. it does all sub-headers in the current
"section"
i think between section-toc, page-toclevels, and page-tocclass we've got enough
stuff in our toolkit to solve every posisble situation we might want.
if there are no concerns i'll commit & backport all the "template" changes here
tomorrow (but none of the {{*.adoc}} changes i made just to demo the new
features)
> 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
> Attachments: lang-analysis-1-level-toc.png,
> solr-10612-largepage.patch, SOLR-10612.patch, SOLR-10612.patch,
> SOLR-10612.patch, SOLR-10612.patch
>
>
> 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]
