Content: Add option to display Table of Contents

[palmierieugenio]

Is it possible to put a table of Contents with links inside a post? For long posts it can be useful.

I've tried with toc: true in the header of the file, but it just gives a "true" at the beginning of the post.

[gcushen]

Thanks for the feature request - the feature has just been added. Please update the theme and then use {{% toc %}} in your content where you wish to display the table of contents. If using non-English translation, you may also need to update your language file. Refer to the example in 06dc780 for more info.

Also note that there is currently a minor bug in Hugo concerning the nesting of the generated list - see gohugoio/hugo#1778 .

Let me know if you have any feedback. I'll re-open this if there are any issues.

[palmierieugenio]

I've updated the en.yaml (since I'm using english) and I've created the toc.html file in the shortcodes folder, but I'm getting just the title "Table of Contents", without the actual list below.

I've seen the topic 1778, but I have little experience with css and html and I wasn't able to make it work. Maybe the problem is that I'm using Rmarkdown files instead of Markdown. I just get this as output, like a normal code chunk:

      {{ partial "banner" . }}
      {{ partial "table-of-contents" . }}
      <!-- supports emoji -->
      {{ .Content | emojify }}

[palmierieugenio]

Yes: it works with Markdown files, but not with Rmarkdown files. :)

[pat-s]

@palmierieugenio see rstudio/blogdown#58