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

@macabeus macabeus commented Mar 19, 2017

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

@macabeus macabeus commented Mar 21, 2017

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

Loading

@justinmayer
Copy link
Member

@justinmayer justinmayer commented Mar 23, 2018

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

Loading

@raffienficiaud
Copy link

@raffienficiaud raffienficiaud commented May 10, 2018

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']
}

Loading

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

Successfully merging a pull request may close this issue.

None yet
3 participants