Markdown ToC about hyde

[atiw003]

Anyone, just need to know something is on the road map otherwise I can modify source on my side.

[navilan]

Hi,

It works fine for me.

You can test it with the basic template.

1. Create a new site with the basic template

   hyde -s ~/test create
   

2. Edit site.yaml and add this at the root level (this is the part you are missing I think)

markdown:
    extensions:
        - toc

3. Edit about.html and add this below the meta data:

   [TOC]
   
   # Header 1
   
   ## Header 2
   
   ## Header 22
   
   

Now if you generate the site, you should see the TOC generated nicely.

[atiw003]

Thanks a lot and sorry for troubling on this small issue which finally worked out .
cheers

[dandersson]

I found this issue post when searching for information regarding similar troubles with getting the [TOC] construct to work. If anyone else finds this same thread, I can mention that my problems had to do with that the default Hyde setting of the Jinja2 templating engine sets trim_blocks = True.

From the Jinja2 documentation:

trim_blocks

If this is set to True the first newline after a block is removed (block, not variable tag!). Defaults to False.

Because of this, the following does not work:

{% mark excerpt -%}

Dummy excerpt.

{%- endmark %}

[TOC]

After the whitespace gobbling by trim_blocks, [TOC] will be interpreted as being a continuation of the Dummy excerpt paragraph and will not be rendered as a special command.

However, this works:

{% mark excerpt -%}

Dummy excerpt.

{%- endmark %}


[TOC]

It is thus easily worked around, but it was not immediately apparent where the problem lay.