Hard-coding the "Table of Contents" heading to h2 now looked like a
bad idea.. it seems semantically incorrect. So now it is a div tag.
This also allows more flexibility on how to show that "Table of
Contents" heading. See
https://ox-hugo.scripter.co/doc/org-toc/#table-of-contents-heading
for more info.
This is a "breaking change" in the sense that that heading will no
longer auto-render looking like a heading. So user might need to add
some CSS to make it look just like before. See example CSS in the
above doc link.
- Add <!--endtoc--> comment at end of Org-inserted TOC's.
That acts as an aid to help filter out the TOC from Hugo
summaries. See the new test added in this commit for example:
https://ox-hugo.scripter.co/test/posts/no-toc-in-summary
This commit changes the TOC style quite a bit from the earlier
version. Read the below mini-blog-in-commit for more info.
- Add new function org-hugo--get-headline-number
- org-hugo-heading - Use above.
- org-hugo--build-toc - Generate unordered list instead of ordered
- Update/add tests!
@punchagan: You are most likely one of the few affected by the
backward incompatible change in this commit. To get sort of the old
style of numbered headings in TOC (while unnumbered headings in post
body), set `num' to `onlytoc`. Let me know how it works.
=== mini blog ===
Earlier, the TOC was exported as ordered list in Markdown. That
imposed a limitation that allowed exporting only the last number from
a section number.
So instead of:
1. Section 1
1.1 Section 1.1
1.2 Section 1.2
It would export as:
1. Section 1
1. Section 1.1
2. Section 1.2
Now the TOC is generated as an *unordered* list in Markdown.
- 1. Section 1
- 1.1 Section 1.1
- 1.2 Section 1.2
That would cause both bullets and numbers to show in HTML, so I am
using a nifty little trick I discovered in
https://github.com/kaushalmodi/ox-hugo/issues/93 to hide those
bullets **if the section numbers are present**.
In addition, I also wrap the section numbers in "section-num" class so
that user can choose to format them however they like using CSS (May
be even hide them).
===
Fixes https://github.com/kaushalmodi/ox-hugo/issues/76
- Add new defcustom org-hugo-export-with-section-numbers
- Default of this option is set to 'onlytoc
- So there will be no numbers in the body of the exported post. But
if TOC (Org) is enabled, the items will be numbered.
This is part 1 of a multi-part patch series to make the num and toc
options work together the "right way".
Kaushal Modi