html: Allow limiting level of headlines to be included in toc

The org mode toc OPTION does not just support true/false - it also allows
specifying the max headline level [1] to be included in the toc.

[1] headline level as seen in org mode - not the html tag level
This commit is contained in:
Niklas Fasching 2020-01-20 18:03:45 +01:00
parent 7a2cd1abb1
commit f1361615ed
6 changed files with 59 additions and 5 deletions

View file

@ -14,6 +14,8 @@
</li>
<li><a href="#headline-7">malformed property drawer</a>
</li>
<li><a href="#headline-8">level limit for headlines to be included in the table of contents</a>
</li>
</ul>
</nav>
<h2 id="headline-1">
@ -88,3 +90,22 @@ not a property
<p>
:END:
</p>
<h2 id="headline-8">
level limit for headlines to be included in the table of contents
</h2>
<p>
The toc option allows setting a <a href="https://orgmode.org/manual/Export-settings.html">level limit</a>. For this file we set it to 1 - which means that the following headlines
won&#39;t be included in the table of contents.
</p>
<h3 id="headline-9">
headline 2 not in toc
</h3>
<h4 id="headline-10">
headline 3 not in toc
</h4>
<h3 id="headline-11">
anoter headline 2 not in toc
</h3>
<p>
you get the gist…
</p>

View file

@ -1,4 +1,5 @@
#+SETUPFILE: setup_file_org
#+OPTIONS: toc:1
* Simple Headline [1/2]
- [X] checked
- [ ] unchecked
@ -31,3 +32,10 @@ By default =EXCLUDE_TAGS= is just =:noexport:=.
:PROPERTIES:
not a property
:END:
* level limit for headlines to be included in the table of contents
The toc option allows setting a [[https://orgmode.org/manual/Export-settings.html][level limit]]. For this file we set it to 1 - which means that the following headlines
won't be included in the table of contents.
** headline 2 not in toc
*** headline 3 not in toc
** anoter headline 2 not in toc
you get the gist...

View file

@ -1,4 +1,5 @@
#+SETUPFILE: setup_file_org
#+OPTIONS: toc:1
* Simple Headline [1/2]
- [X] checked
- [ ] unchecked
@ -31,3 +32,10 @@ By default =EXCLUDE_TAGS= is just =:noexport:=.
:PROPERTIES:
not a property
:END:
* level limit for headlines to be included in the table of contents
The toc option allows setting a [[https://orgmode.org/manual/Export-settings.html][level limit]]. For this file we set it to 1 - which means that the following headlines
won't be included in the table of contents.
** headline 2 not in toc
*** headline 3 not in toc
** anoter headline 2 not in toc
you get the gist...

View file

@ -131,6 +131,7 @@ src block
<div class="highlight">
<pre>
#+SETUPFILE: setup_file_org
#+OPTIONS: toc:1
* Simple Headline [1/2]
- [X] checked
- [ ] unchecked
@ -163,6 +164,13 @@ By default =EXCLUDE_TAGS= is just =:noexport:=.
:PROPERTIES:
not a property
:END:
* level limit for headlines to be included in the table of contents
The toc option allows setting a [[https://orgmode.org/manual/Export-settings.html][level limit]]. For this file we set it to 1 - which means that the following headlines
won&#39;t be included in the table of contents.
** headline 2 not in toc
*** headline 3 not in toc
** anoter headline 2 not in toc
you get the gist...
</pre>
</div>
</div>