Being the thoughts and writings of one Gustaf Erikson; father, homeowner, technologist.

Thursday, 2005-09-22


Colophon

This is a Blosxom weblog. It’s hosted at symbiandiaries.com.

Timestamps are in my timezone (CET, UTC+01:00).

Plugins

The following plugins are used:

  • Markdown — automatic formatting of plain text to (X)HTML.
  • SmartyPants — transforms ASCII punctuation into “smart” HTML punctuation.
  • absolute — replaces relative paths in image tags and hyperlinks with their fully-qualified counterparts
  • acronym — inserts acronyms automatically in posts. This is my own hack.
  • archives — builds a tree view over past posts by month.
  • atomfeed — Atom 1.0 syndication support for Bloxsom.
  • categories — builds a tree view over past posts by category.
  • category_desc — shows info about the current category. This is my own hack.
  • config — per-directory configuration.
  • date_fullname — nicer date formatting.
  • entries_cache — caches timestamps, allowing for editing of posts without changing their internal order.
  • feedback — allow comments and trackbacks.
  • file — include contents of files in your blog.
  • find — search plugin.
  • flavourdir — keep your flavours in a separate directory.
  • fmtcat — provide formatting for categories
  • hide — hides files and directories from display, but not from search.
  • interpolate_fancy — conditionally add text based on variables.
  • meta — enable metatags in entries.
  • postheadprefoot — customize head and foot flavours according to category
  • redirect — redirect moved entries
  • storytitle — inserts the title of the post in the <title> element.
  • timezone — sets the timestamps to a local timezone.
  • vrss10 — implements a verified RSS 1.0 feed. Used because the built-in RSS flavour chokes on Swedish characters. This plugin is Matthias Eberl’s enhancement of Rael Dornfest’s original rss10 plugin.

Customizations and notes

archives

Added a CSS identity to the subordinate <ul> tags to achieve the same look as in the category list.

categories

Changed the spacing between the category name and number of entries to match the formatting of the archives plugin.

Wrapped each leaf <ul> in <li> to ensure XHTML compliance. Unfortunately, this makes the tree look funny. This is alleviated by setting the same class indentity to all the <ul> tags and then removing the bullets with the help of CSS.

config

This is used to vary the number of posts shown per category.

The front page is limited to 10. However, if you choose a category, you should be able to see all the entries in that category.

This plugin takes care of this. Create a file config:

 package blosxom;
 $blosxom::num_entries = ($blosxom::path_info ? 999 : 10);

and place it in your data directory. If the $path_info variable is populated, we’re in a subdirectory — show all posts (if you’re category has more than 999 posts, adjust accordingly…), otherwise show 10 entries.

Thanks to Stu MacKenzie on the Blosxom list for this.

postheadprefoot

See this post for more info on how I got this working.

redirect

The config file needs to have the same file extension as the target post (well, duh…). I keep my posts as .txt in the filesystem, and my default flavour is .html. So to redirect the entry foo I use the line

path/to/foo.html=>new/path/to/foo.html
vrss10

I made symlinks ending in .rdf to each flavour file in the vrss10 package. Now I can reference my RSS 1.0 feed as http://gustaf.symbiandiaries.com/weblog/index.rdf.

Ordering

This is the ordering of the plugins. Most of the modifications are made so the that the atomfeed will get the post as intended.

01config
01meta
02interpolate_fancy
03acronym
04Markdown
04SmartyPants
absolute
archives
atomfeed
categories
category_desc
date_fullname
entriescache
feedback
file
find
flavourdir
fmtcat
hide
postheadprefoot
redirect
storytitle
timezone
vrss10

Submit a comment

Please enter comments as plain text only; HTML is not supported. Submitting an URL is optional.

Comments are moderated and may not appear immediately.

Comments are closed for this story.