How to show the table of contents

[yihui]

It depends on whether your post is R Markdown or plain Markdown. For R Markdown, it is easy -- just add this to YAML:

output:
  blogdown::html_page:
    toc: true

Example: https://deploy-preview-7--hugo-xmin.netlify.com/post/2017/06/22/rmd-toc/

For plain Markdown posts, the template single.html has to be modified. For example, we can use a YAML parameter toc to control whether to write out .TableOfContents. Example: https://deploy-preview-7--hugo-xmin.netlify.com/about/

The CSS style was defined in style.css (a lightgray border).

[enersto]

So there is still no toc_float for html_page?

[phnaharris]

Hi,

Just wondering if there’s any reason this hasn’t been merged into the master branch yet. I’m really looking forward to using this feature, but keeping it maintained downstream has been a bit inconvenient. I think it would be great to have it supported out of the box upstream.

Thanks a lot for your work on this theme — really appreciate it.. Happy coding.

[yihui]

@phnaharris The reason is here: https://yihui.org/en/2017/09/pull-requests-as-a-teaching-tool/ These PRs are often simple enough and I'll leave them to you to merge by yourself. Thanks for the nice words!