Thu, 07 Dec 2006

Rendering & Entry Parsers

PyBlosxom supports only one format for entry files by default. This format is the same format that blosxom uses. The extension for this format is .txt. The first line of the file is in plain text and forms the title of the entry. The second line through the end of the file is in HTML and is the body of the entry.

A sample blog entry could look like this:

First post
<p>
  Here's the body of my first post.
</p>

Some people really detest writing in HTML which is valid. Other people use their entries in other places, so they need a markup format that's less web-oriented. Some folks write a lot of material in a non-HTML markup format and would like to use that same format for blog entries. These are all very valid reasons to want to use other markup formats.

PyBlosxom allows you to install entry parser plugins which are PyBlosxom plugins that implement an entry parser. These entry parser plugins allow you to use other markup formats. Check the Plugin Registry at http://pyblosxom.sourceforge.net/ for which entry parsers are available.

In general, we only have entry parsers written by people who really wanted that markup format. If you don't see your favorite markup format represented, try looking at the code for other entry parsers and implement it yourself. If you need help, talk to us on the pyblosxom-users or pyblosxom-devel mailing lists.

Details on the various entry parsers should be at the top of the entry parser plugin itself in the Python doc-string.

Other entry parsers:

  • PyMarkdown : Allows you to format your blog postings in Markdown format (http://daringfireball.net/projects/mark...
  • Native : This plugin allows you to use a different format for your weblog entries. This format is basically ...
  • htmlentryparser : This file will use a simple HTML file as the entry format. The <h1/> is used as the title of ...
  • genericwiki : Generic wiki markup PreFormatter for pyblosxom.
  • linebreaks : Preformatter for people who are lazy to type <p>s, <br />s, and </p>. Let's face...
  • moinmoin : Preformatter and entryparser for the MoinMoin wiki software.
  • This preformatter/entryparser uses the...
  • py : An entryparser that reads python source code and formats it accordingly.
  • rst : A reStructuredText entry formatter for pyblosxom. reStructuredText is part of the docutils project ...
  • txtl : PyTextile is a Python port of Textile, Dean Allen's Humane Web Text Generator. It supports all the ...

[23:33] | [] | #-permalink-#