Compile Wordpress-similar text into HTML

To install, run nikola plugin -i wordpress_compiler

This plugin will allow you to compile unmodified WordPress posts using essentially the same code WordPress is using to convert posts to HTML.

Has support for shortcodes provided by plugins. Comes with a basic [code] shortcode plugin, and a basic [gallery] shortcode plugin.

To use it:

$ nikola plugin -i wordpress_compiler

Then, add wordpress to your POSTS and PAGES as well as your compilers dictionary in conf.py:

    ("posts/*.rst", "posts", "post.tmpl"),
    ("posts/*.txt", "posts", "post.tmpl"),
    ("posts/*.wp", "posts", "post.tmpl"),
    ("stories/*.rst", "stories", "story.tmpl"),
    ("stories/*.txt", "stories", "story.tmpl"),
    ("stories/*.wp", "stories", "story.tmpl"),

    "rest": ('.txt', '.rst'),
    "wordpress": ('.wp', '.wordpress'),
    "markdown": ('.md', '.mdown', '.markdown'),
    "html": ('.html', '.htm')

Then all posts whose content is in files ending with .wp or .wordpress will be processed by the WordPress compiler plugin.

Suggested Configuration:

# Add WordPress files to your POSTS, PAGES
POSTS = POSTS + (("posts/*.wp", "posts", "post.tmpl"),)
PAGES = PAGES + (("stories/*.wp", "stories", "story.tmpl"),)

# Add the WordPress compiler to your COMPILERS dict.
COMPILERS["wordpress"] = ('.wp',)


  • regex (Python package)
  • pygments (Python package)
  • (Python package)

Issues? Questions?

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