Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Plugin "extract_toc" has outdated documentation #871

Open
macabeus opened this issue Mar 19, 2017 · 3 comments
Open

Plugin "extract_toc" has outdated documentation #871

macabeus opened this issue Mar 19, 2017 · 3 comments

Comments

@macabeus
Copy link
Contributor

As a Pelican 3.7, the MD_EXTENSIONS is deprecated, then we need use MARKDOWN instead. But, the extract_toc's documentation is outdated:

To enable table of contents generation for the Markdown reader you need to set MD_EXTENSIONS = (['toc']) in your Pelican configuration file.

And I don't know how to use MARKDOWN. How to solve this?

@macabeus
Copy link
Contributor Author

Update.
Using MARKDOWN = {'extensions': ['toc']} I can execute the plugin.
But, this causes bug in my codes inside tag ```.

@justinmayer
Copy link
Member

@macabeus: Were you able to find a solution to your problem here?

@raffienficiaud
Copy link

It seems to work if you take the default MARKDOWN setting and add the extract_toc to it:
I took the MARKDOWN from the documentation http://docs.getpelican.com/en/3.7.1/settings.html?highlight=MARKDOWN

MARKDOWN = {
    'extension_configs': {
        'markdown.extensions.codehilite': {'css_class': 'highlight'},
        'markdown.extensions.extra': {},
        'markdown.extensions.meta': {},
    },
    'output_format': 'html5',
    'extensions' : ['toc']
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants