OrgWiki/go-org-orgwiki
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

html: Add support for #+TOC keyword

Browse source 
org mode allows rendering the toc anywhere in the html document using the `TOC`
keyword [1]. There's more options but `#+TOC: headlines $n` should be enough
for starters. Note that org mode still requires setting `#+OPTIONS: toc:nil` to
disable the default toc

[1] https://orgmode.org/manual/Table-of-Contents.html
This commit is contained in:
Niklas Fasching 2021-03-28 16:59:36 +02:00
parent bf7f957af2
commit 7c239a7aeb
4 changed files with 63 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

31
org/testdata/keywords.html vendored
View file

@ -1,3 +1,8 @@
<div id="outline-container-headline-1" class="outline-2">
<h2 id="headline-1">
captions, custom attributes and more
</h2>
<div id="outline-text-headline-1" class="outline-text-2">
<figure>
<div class="src src-sh a b c d" id="it">
<div class="highlight">
@ -26,3 +31,29 @@ named block
</div>
</div>
<p>#not a comment because there&#39;s no space after the hashtag</p>
</div>
</div>
<div id="outline-container-headline-2" class="outline-2">
<h2 id="headline-2">
table of contents
</h2>
<div id="outline-text-headline-2" class="outline-text-2">
<p>A table of contents can be rendered anywhere in the document by using</p>
<div class="src src-org">
<div class="highlight">
<pre>
#+TOC: headlines $n
</pre>
</div>
</div>
<p>Where <code class="verbatim">$n</code> is the max headline lvl that will be included. You can use <code class="verbatim">headlines 0</code> to include all headlines.</p>
<nav>
<ul>
<li><a href="#headline-1">captions, custom attributes and more</a>
</li>
<li><a href="#headline-2">table of contents</a>
</li>
</ul>
</nav>
</div>
</div>

11
org/testdata/keywords.org vendored
View file

@ -1,4 +1,5 @@
#+OPTIONS: toc:nil
* captions, custom attributes and more
#+CAPTION: and _multiple_
#+CAPTION: lines of *captions*!
#+ATTR_HTML: :class a b
@ -23,3 +24,11 @@ named block
# comments must have whitespace after the hashtag
#not a comment because there's no space after the hashtag
* table of contents
A table of contents can be rendered anywhere in the document by using
#+begin_src org
,#+TOC: headlines $n
#+end_src
Where =$n= is the max headline lvl that will be included. You can use =headlines 0= to include all headlines.
#+TOC: headlines 0

11
org/testdata/keywords.pretty_org vendored
View file

@ -1,4 +1,5 @@
#+OPTIONS: toc:nil
* captions, custom attributes and more
#+CAPTION: and _multiple_
#+CAPTION: lines of *captions*!
#+ATTR_HTML: :class a b
@ -23,3 +24,11 @@ named block
# comments must have whitespace after the hashtag
#not a comment because there's no space after the hashtag
* table of contents
A table of contents can be rendered anywhere in the document by using
#+BEGIN_SRC org
,#+TOC: headlines $n
#+END_SRC
Where =$n= is the max headline lvl that will be included. You can use =headlines 0= to include all headlines.
#+TOC: headlines 0