6.9.1 Publishing Planner pages

Publishing works by providing Muse with the settings and environment for Planner publishing.

First, make sure that you have set up a proper muse-project-alist (see Creating Your Planner).

Second, add:

     (require 'planner-publish)

to your .emacs (or _emacs).

To publish your entire Planner project, hit C-c C-p (muse-project-publish). To publish just the current buffer, hit C-c C-t (muse-publish-this-file).

To automatically publish files when you save them, add the following code to your ~/.emacs (or _emacs):

     (eval-after-load "muse-mode"
       '(add-hook 'after-save-hook
                 #'(lambda ()
                     (when (planner-derived-mode-p 'muse-mode)
                       (muse-project-publish nil)))
                 nil t))

Styles provided

The following publishing styles are available.

planner-html

Publish Planner pages to HTML.

planner-xhtml

Publish Planner pages to XHTML.

planner-xml

Publish Planner pages to XML.

Options provided

The following options may be customized to enhance your publishing experience.

planner-publish-markup-regexps

List of markup rules for publishing Planner pages.

planner-publish-markup-functions

Specify which function to use for publishing different kinds of markup.

planner-publish-markup-tags

A list of custom HTML-like tags to recognize when publishing.

planner-xml-markup-strings

Strings that are inserted to publish XML markup.

planner-xml-header

Header used when publishing Planner XML files. This may be text or a filename.

planner-xml-footer

Footer used when publishing Planner XML files. This may be text or a filename.

planner-html-markup-strings

Strings that are inserted to publish HTML markup.

planner-html-style-sheet

CSS stylesheet elements used in Planner HTML and XHTML files. This can also be one or more ‘<link>’ tags.

planner-html-header

Header used when publishing Planner HTML files. This may be text or a filename.

planner-html-footer

Footer used when publishing Planner HTML files. This may be text or a filename.

planner-xhtml-header

Header used when publishing Planner XHTML files. This may be text or a filename.

planner-xhtml-footer

Footer used when publishing Planner XHTML files. This may be text or a filename.

planner-html-inner-header

Extra header section that can be embedded within planner-html-header and planner-xhtml-header.

planner-html-inner-footer

Extra header section that can be embedded within planner-html-footer and planner-xhtml-footer.

planner-publish-prepare-regexps

List of markup rules to apply before publishing a page with Planner.

planner-publish-finalize-regexps

List of markup rules to apply after publishing a page with Planner.