rest_html5

Compile reST into HTML5

To install, run nikola plugin -i rest_html5

Modified version of original reST plugin that uses an alternative docutils writer to produce HTML5 output.

Note: if you want to use the Nikola-provided reST extensions, you need to keep the original rest compiler in COMPILERS and POSTS/PAGES, otherwise they will not get loaded.

Suggested Configuration:

COMPILERS = {
    'rest': ('.rst4',),
    'rest_html5': ('.rst', '.txt'),
}

POSTS = (
    ("posts/*.rst4", "posts", "post.tmpl"),
    ("posts/*.rst", "posts", "post.tmpl"),
    ("posts/*.txt", "posts", "post.tmpl"),
)

# NOTE: if you want to use the Nikola-provided reST extensions, you need to
#       keep the original `rest` compiler in COMPILERS *and* POSTS/PAGES,
#       otherwise they will not get loaded.

Requirements:

  • rst2html5>=1.8.1 (Python package)

Issues? Questions?

You can report issues with this plugin and request help via GitHub Issues.