nikola plugin -i orgmode
This plugin implements an Emacs Org-mode based compiler for Nikola.
If your emacs does not ship with org-mode (>=8.x), you will have to edit the
init.el file supplied with this plugin, and load a newer version of org-mode.
You will also need to add the orgmode compiler to your list of compilers, and modify your POSTS & PAGES variables. (See the sample conf file provided.)
Syntax highlighting with pygments
By default, the plugin uses
pygments for syntax highlighting. You can disable
this by setting
Customization section below).
To get proper syntax highlighting, you will need to add custom CSS to your
theme. You can generate this CSS using the
pygmentize command as follows:
mkdir -p files/assets/css pygmentize -S <PYGMENTS_STYLE> -a .highlight -f html >> files/assets/css/custom.css
and make sure that
custom.css is included in your site by your
theme. The various available style options for
<PYGMENTS_STYLE> can be found
using the command
pygmentize -L style.
You can add any customization variables that you wish to add, to modify the
output generated by org-mode to
conf.el inside the plugin directory. This
lets you have custom configuration, that doesn't get wiped out each time the
plugin is updated.
# NOTE: Needs additional configuration in init.el file. # Add the orgmode compiler to your COMPILERS dict. COMPILERS["orgmode"] = ('.org',) # Add org files to your POSTS, PAGES POSTS = POSTS + (("posts/*.org", "posts", "post.tmpl"),) PAGES = PAGES + (("stories/*.org", "stories", "story.tmpl"),)
You can report issues with this plugin and request help via GitHub Issues.