9.5 Keeping a journal or blog

The module facilitates the keeping and publication of a journal. When publishing to HTML, it assumes the form of a web log, or blog.

The input format for each entry is as follows.

     * 20040317: Title of entry
     
     text for the entry.
     
     <qotd>
     "You know who you are. It comes down to a simple gut check: You
     either love what you do or you don't. Period." -- P. Bronson
     </qotd>

The "qotd", or Quote of the Day, is entirely optional. When generated to HTML, this entry is rendered as the following.

     <div class="entry">
       <div class="entry-qotd">
         <h3>Quote of the Day:</h3>
         <p>"You know who you are. It comes down to a simple gut
           check: You either love what you do or you don't. Period."
           -- P. Bronson</p>
       </div>
       <div class="entry-body">
         <div class="entry-head">
           <div class="entry-date">
             <span class="date">March 17, 2004</span>
           </div>
           <div class="entry-title">
             <h2>Title of entry</h2>
           </div>
         </div>
         <div class="entry-text">
           <p>Text for the entry.</p>
         </div>
       </div>
     </div>

The plurality of "div" tags makes it possible to display the entries in any form you wish, using a CSS style.

Also, an .RDF file can be generated from your journal by publishing it with the "rdf" style. It uses the first two sentences of the first paragraph of each entry as its "description", and auto-generates tags for linking to the various entries.

Styles provided

journal-html

Publish journal entries as an HTML document.

journal-xhtml

Publish journal entries as an XHTML document.

journal-latex

Publish journal entries as a LaTeX document.

journal-pdf

Publish journal entries as a PDF document.

journal-book-latex

Publish journal entries as a LaTeX book.

journal-book-pdf

Publish journal entries as a PDF book.

journal-rdf

Publish journal entries as an RDF file (RSS 1.0).

journal-rss

Publish journal entries as an RSS file (RSS 2.0).

Options provided

muse-journal-heading-regexp

A regexp that matches a journal heading.

Paren group 1 is the ISO date, group 2 is the optional category, and group 3 is the optional heading for the entry.

muse-journal-date-format

Date format to use for journal entries.

muse-journal-html-heading-regexp

A regexp that matches a journal heading from an HTML document.

Paren group 1 is the ISO date, group 2 is the optional category, and group 3 is the optional heading for the entry.

muse-journal-html-entry-template

Template used to publish individual journal entries as HTML.

muse-journal-latex-section

Template used to publish a LaTeX section.

muse-journal-latex-subsection

Template used to publish a LaTeX subsection.

muse-journal-latex-markup-tags

A list of tag specifications, for specially marking up LaTeX.

See muse-publish-markup-tags, for more information.

muse-journal-rdf-extension

Default file extension for publishing RDF (RSS 1.0) files.

muse-journal-rdf-base-url

The base URL of the website referenced by the RDF file.

muse-journal-rdf-header

Header used for publishing RDF (RSS 1.0) files.

This may be text or a filename.

muse-journal-rdf-footer

Footer used for publishing RDF (RSS 1.0) files.

This may be text or a filename.

muse-journal-rdf-date-format

Date format to use for RDF entries.

muse-journal-rdf-entry-template

Template used to publish individual journal entries as RDF.

muse-journal-rdf-summarize-entries

If non-nil, include only summaries in the RDF file, not the full data.

muse-journal-rss-extension

Default file extension for publishing RSS 2.0 files.

muse-journal-rss-base-url

The base URL of the website referenced by the RSS file.

muse-journal-rss-header

Header used for publishing RSS 2.0 files.

This may be text or a filename.

muse-journal-rss-footer

Footer used for publishing RSS 2.0 files.

This may be text or a filename.

muse-journal-rss-date-format

Date format to use for RSS 2.0 entries.

muse-journal-rss-entry-template

Template used to publish individual journal entries as RSS 2.0.

muse-journal-rss-enclosure-types-alist

File types that are accepted as RSS enclosures.

This is an alist that maps file extension to content type.

Useful for podcasting.

muse-journal-rss-summarize-entries

If non-nil, include only summaries in the RSS file, not the full data.

Many RSS subscribers find this annoying.

muse-journal-rss-markup-regexps

List of markup rules for publishing a Muse journal page to RSS.

For more information on the structure of this list, See muse-publish-markup-regexps.

muse-journal-rss-markup-functions

An alist of style types to custom functions for that kind of text.

For more on the structure of this list, See muse-publish-markup-functions.