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

Pandoc does not demote headers #2371

Closed
tritium21 opened this issue Jun 14, 2016 · 6 comments
Closed

Pandoc does not demote headers #2371

tritium21 opened this issue Jun 14, 2016 · 6 comments

Comments

@tritium21
Copy link
Contributor

Documents compiled with pandoc do not demote headers. I cannot tell if this is intentional (with the user intended to provide a filter or some other command line options in PANDOC_OPTIONS), or not, but turning this behavior on is a one line delta (set demote_headers = True in CompilePandoc).

@sukiletxe
Copy link
Contributor

In Pandoc, you can achieve the same effect by using
--base-header-level==number.

@tritium21
Copy link
Contributor Author

@sukiletxe Does that mean the intended use of the pandoc plugin is to provide that argument in PANDOC_OPTIONS? If so, then that should be documented (probably in the example comment in conf.py.in). If it is not the intended use of the pandoc plugin, then the one-line delta to use Nikola's header demotion should be added.

@Kwpolska
Copy link
Member

Intentional behavior. I think that demoting headers is fine for lightweight formats, like reST or Markdown, but Pandoc does formats that might work better as-is. Would you want to add a note to the conf.py file or should I do that myself?

@tritium21
Copy link
Contributor Author

I'll write up a pull request. Is changing the default example of PANDOC_OPTIONS acceptable

@Kwpolska
Copy link
Member

If it’s commented out sure.

@Kwpolska
Copy link
Member

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

No branches or pull requests

3 participants