Table of contents on a post

[hermanp]

Get a table of contents (TOC, ToC) for a post page. Google search: hugo "table of contents" OR toc, hugo "table of contents" OR toc aside and hugo "table of contents" OR toc float* OR aside

• Table of contents - Hugo docs
• aside :arrow_left: preferred:
  • TOC for blog posts #1520 - used :heavy_check_mark:
  • Add sidebar navigation with table of contents #1362 - back to the previous :arrow_heading_up:
  • Adding a sticky table of contents in Hugo to posts - interesting and inspirational post for many
  • Adding a useful Table of Contents to Hugo sites - used :heavy_check_mark:
  • Preserve toc:true in YAML front matter for Hugo - no real solution :x:
  • Add a floating TOC to R blogdown's academic theme - rejected :x:
• part of content:
  • Table of Contents - Wowchemy docs - last chance
  • Hugo: Add Table of Contents Anywhere in Markdown File - interesting, reference for #2 because folding in markdown. :exclamation:

[hermanp]

Need to adjust the settings startLevel and endLevel for goldmark renderer in config.toml:

• How to configure TOC for Goldmark renderer
• Comment in Wowchemy issue 1520

[hermanp]

If single.html is modified as below (as Table of contents - Hugo docs suggests):

{{- define "main" -}}

<article class="article">
  {{ partial "page_header" . }}
  <div class="article-container">
    <div class="article-style">
      {{ .Content }}
    </div>
    {{ partial "page_footer" . }}
  </div>
</article>

<!--- Below is added --->
<aside>
  {{ .TableOfContents }}
</aside>
<!--- Above is added --->

{{- end -}}

Then the result is a TOC on the left side, as this picture shows:

[hermanp]

After searched in Google for hugo "table of contents" OR toc aside, found goHugo Table of Contents

Modified single.html as:

{{- define "main" -}}

<article class="article">
  {{ partial "page_header" . }}
  <div class="article-container">
    <div class="article-style">
      {{ .Content }}
    </div>
    {{ partial "page_footer" . }}
  </div>
</article>

<aside style="float: right;">
  {{ .TableOfContents }}
</aside>

{{- end -}}

This happened:

[hermanp]

In the end TOC for blog posts #1520 was modified at the if condition, according to Adding a useful Table of Contents to Hugo sites.