Next: , Previous: HTML, Up: Publishing Styles


9.6 Integrating with ikiwiki

Ikiwiki is a wiki compiler (http://ikiwiki.info/). Emacs Muse can be used as a source format for Ikiwiki pages with the plugin IkiWiki::Plugin::muse.

The lisp/muse-ikiwiki.el file provides publishing functions and styles for Ikiwiki. The plugin for Ikiwiki to recognize Muse files is provided by the examples/ikiwiki/muse file. Two sample init files are available in the examples/ikiwiki directory. Configure your ikiwiki.setup file so that the muse_init variable has the location of your Muse init file.

If you are using CGI, The directory examples/ikiwiki/IkiWiki must be copied to the same directory as the CGI script that Ikiwiki generates. When publishing your wiki, the PERL5LIB environment variable must contain the path to the examples/ikiwiki/IkiWiki directory.

Styles provided

ikiwiki
Supports publishing XHTML output that Ikiwiki can understand.

Options provided

muse-ikiwiki-header
Header used for publishing Ikiwiki output files.

This may be text or a filename.

muse-ikiwiki-footer
Footer used for publishing Ikiwiki output files.

This may be text or a filename.

Other relevant options

muse-colors-evaluate-lisp-tags
Specify whether to evaluate the contents of <lisp> tags at display time. If nil, don't evaluate them. If non-nil, evaluate them.

The actual contents of the buffer are not changed, only the displayed text.

muse-html-src-allowed-modes
Modes that we allow the <src> tag to colorize. If t, permit the <src> tag to colorize any mode.

If a list of mode names, such as '("html" "latex"), and the lang argument to <src> is not in the list, then use fundamental mode instead.

muse-publish-enable-dangerous-tags
If non-nil, publish tags like <lisp> and <command> that can call external programs or expose sensitive information. Otherwise, ignore tags like this.

This is useful to set to nil when the file to publish is coming from an untrusted source.