blosxom http://blosxom.sourceforge.net
blosxom :: the zen of bloggingenAdd an FAQ Entryhttp://blosxom.sourceforge.net/2004/07/21#faq_add
<p><font color="red"></font></p>
Have a Blosxom tip, trick, technique, or other tidbit to share with the Blosxom community? Add a Frequently-Asked-Question (and Answer) here! I'll take a gander in short order and add it to the FAQ.
<form method="POST" action="/documentation/users/faq_add.html">
<table border="0" cellspacing="10" cellpadding="0">
<tr valign="top"><td><b>Question</b></td><td><input type='text' name='question' size='15' /><br />[e.g. how do you bliffl, blaffl, or blot?]</td></tr>
<tr valign="top"><td><b>Answer</b></td><td><textarea rows='4' cols='35' name='answer'></textarea></td></tr>
<tr valign="top"><td><b>Category</b></td><td><input type='text' name='category' size='35' /><br />[e.g. /windows, /templates, /installation/mac]</td></tr>
<tr valign="top"><td><b>Author Name</b></td><td><input type='text' name='author' size='35' /><br />[e.g. Jane or John Smith]</td></tr>
<tr valign="top"><td><b>Author URL</b></td><td><input type='text' name='author_url' size='35' /><br />[e.g. http://www.example/weblog]</td></tr>
</table>
<p />
<input type='hidden' name='-format' value='faq' />
<input type='submit' value='Submit' />
</form>
Register a Pluginhttp://blosxom.sourceforge.net/2004/07/21#plugin_register
<p><font color="red"></font></p>
Have a Blosxom Plug-in to share with the Blosxom community? Plug it in here! I'll take a gander in short order and add it to the directory.
<form method="POST" action="/documentation/developers/plugin_register.html">
<table border="0" cellspacing="10" cellpadding="0">
<tr valign="top"><td><b>Plug-in Name</b></td><td><input type='text' name='name' size='15' /><br />[e.g. bliffl, blaffl, or blot]</td></tr>
<!-- <tr valign="top"><td><b>Category</b></td><td><input type='text' name='category' size='35' /><br />[e.g. /fun, /business/as_usual]</td></tr> -->
<tr valign="top"><td><b>Description</b></td><td><textarea rows='4' cols='35' name='description'></textarea></td></tr>
<tr valign="top"><td><b>Plug-in URL</b></td><td><input type='text' name='url' size='35' /><br />[e.g. http://www.example/plugins/bliffl.html]</td></tr>
<tr valign="top"><td><b>Author Name</b></td><td><input type='text' name='author' size='35' /><br />[e.g. Jane or John Smith]</td></tr>
<tr valign="top"><td><b>Author URL</b></td><td><input type='text' name='author_url' size='35' /><br />[e.g. http://www.example/weblog]</td></tr>
<tr valign="top"><td><b>Configuration</b></td><td>
<select name="config">
<option value="Drag-and-Drop: no config necessary">Drag-and-Drop; no config necessary</option>
<option value="Configurable: some optional configuration">Configurable: some optional configuration</option>
<option value="Must Configure: some configuration necessary">Must Configure: some configuration necessary</option>
</select>
</td></tr>
<tr valign="top"><td><b>Additional Bits</b></td><td><textarea rows='4' cols='35' name='additional'></textarea><br />[e.g. Perl modules: Text::Something, WWW::Another::Thing]</td></tr>
</table>
<p />
<input type='hidden' name='-format' value='plugin' />
<input type='submit' value='Submit' />
</form>
fullcategoryhttp://blosxom.sourceforge.net/plugins/general/fullcategory.htm
Fixes a bug [feature ;-)] in blosxom so full category names are required (partial names will no longer work)debtagshttp://blosxom.sourceforge.net/plugins/link/debtags.htm
Offers currently two tags: <debpkg packagename> and <debbug bughint> bughint can be any of packagename, maintaineraddress, bugnumber or similar... More to come.rellinkhttp://blosxom.sourceforge.net/plugins/link/rellink.htm
A manager of relative links/imageswriteback-notifyhttp://blosxom.sourceforge.net/plugins/input/writeback_notify.htm
A six-line hack of the original writeback plugin that provides for email notification of new comments. The hack does not effect the performance of the original writeback plugin.pollhttp://blosxom.sourceforge.net/plugins/input/poll.htm
Provides public polls which can be placed in the header or footer templates,
tochttp://blosxom.sourceforge.net/plugins/display/toc.htm
This plugin creates a table of contents generated from selected headings. Can be useful for longer stories.DynamicCSShttp://blosxom.sourceforge.net/plugins/display/dynamic_css.htm
Load different CSS Files based on the user agent that blog-viewers are using.smilefiehttp://blosxom.sourceforge.net/plugins/display/smilefie.htm
Like those cute smiles in your post? This plugin converts :-) into the regularwritebackhttp://blosxom.sourceforge.net/plugins/input/writeback.htm
Provides Blosxom weblogs with WriteBacks, a combination of comments and TrackBacks.referhttp://blosxom.sourceforge.net/plugins/logs/refer.htm
This plugin is a port of the refer.php code from Refer
closingwordshttp://blosxom.sourceforge.net/plugins/display/closingwords.htm
Plugin to append a note to each story, such as source, credit, sentiment or admonition; default appends blog url to story.dayinyearhttp://blosxom.sourceforge.net/plugins/display/dayinyear.htm
Plugin for head and foot templates to display the number of the current day, week and year, like this: Day $dayinyear::numday in week $dayinyear::numweek in $dayinyear::numyear.
syndicatedhttp://blosxom.sourceforge.net/plugins/syndication/syndicated.htm
Displays content syndicated via RSS.login2http://blosxom.sourceforge.net/plugins/authentication/login2.htm
An alteration of the login plugin. This adds functionality which provides automatic logout after x minutes of inactivity. Note: not an option, but a function.randomizerhttp://blosxom.sourceforge.net/plugins/display/randomizer.htm
Populates $randomizer::text with a random line from a text file.todohttp://blosxom.sourceforge.net/plugins/sort/todo.htm
This is a pretty simple plugin; it munges the specified story's modification time to now. I use it to make sure that my To Do List always shows up under today's date.proc2bloghttp://blosxom.sourceforge.net/plugins/input/proc2blog.htm
Inserts an entry in your blossum blog from an incoming email using procmail. Uses a secret subject for authentication, so its not really
rss30http://blosxom.sourceforge.net/plugins/syndication/rss30.htm
hack of rss10 to output RSS 3.0. uses flavour files.relative_dirhttp://blosxom.sourceforge.net/plugins/general/relative_dir.htm
Allows you to use relative data directoryreading_roomhttp://blosxom.sourceforge.net/plugins/display/readingroom.htm
Allows for the (somewhat) easy creation of lists of books, films, etc, along with purchase links and star ratings.Autoxfnhttp://blosxom.sourceforge.net/plugins/display/autoxfn.htm
Automatically adds XFN (http://gmpg.org/xfn/) relationship data to anchor tags based on information contained in a central file.comments_recenthttp://blosxom.sourceforge.net/plugins/display/comments_recent.htm
Provides a list of recent comments, good for inclusion in a sidebar.prefshttp://blosxom.sourceforge.net/plugins/general/prefs.htm
An alternative to the config plugin which has the advantage of correctly handling static rendering.
moveabletypehttp://blosxom.sourceforge.net/2004/01/13#moveabletype
description:Ever wanted to use a stylesheet designed for Moveable Type with your Blosxom weblog? This theme easily shows you how to do it. Theme file is commented for those who want to see what is happening.
preview_url:http://aym.engel5.net
download_url:http://aym.engel5.net/download/blosxomthemes/mt.zip
screenshot_url:
author:David Engel
author_url:http://aym.engel5.net
type:Theme
additional:theme and interpolate_fancy plugin. Writeback plugin used for example of comments.
desktophttp://blosxom.sourceforge.net/2004/01/13#desktop
description:Make your blog look like a desk. Inspired by DigitalPaper, this theme provides a realistic desk, complete with sticky notes!
preview_url:http://www.tizzyd.com/index.desktop
download_url:http://www.tizzyd.com/files/themes/desktop-0.5.zip
screenshot_url:
author:Darrin Tisdale (tizzyd)
author_url:http://www.tizzyd.com
type:Theme
additional:You will want to personalize the legal tag at the bottom, as well as the images, if you do not want to use the Creative Commons license. The theme plugin is required for this theme to work. It also uses breadcrumbs, netflix, lastmodified, calendar, date_fulltime, and rss10.
lychnishttp://blosxom.sourceforge.net/2004/01/12#lychnis
description:The original idea for the layout is copied from a design on OSWD, called libra. Among other things I changed it to be XHTML 1.1 compliant and to make more use of CSS.
preview_url:http://www.lychnis.net/index/programming/blosxom/lychnis-theme-1.5.lychnis
download_url:http://www.lychnis.net/files/blosxom/themes/lychnis-1.5.tar.gz
screenshot_url:
author:Ivo Timmermans
author_url:http://www.lychnis.net/
type:Theme
additional:
cvshttp://blosxom.sourceforge.net/plugins/display/cvs.htm
Replaces CVS keywords (such as $Id: cvs,v 1.2 2004/01/12 12:59:43 ivo Exp $) with the part after the :.BlosGatehttp://blosxom.sourceforge.net/plugins/input/blosgate.htm
BlosGate- A cross-platform email-to-Blosxom gateway that doesn't require procmail or root access.uselibhttp://blosxom.sourceforge.net/plugins/programming/uselib.htm
Tells Perl to look for modules in $blosxom::plugin_dir/lib.timezonehttp://blosxom.sourceforge.net/plugins/date/timezone2.htm
Allows Blosxom to use a different timezone from the server. Also exports the timezone and GMT offset for use in flavors.metadatehttp://blosxom.sourceforge.net/plugins/date/metadate.htm
Lets you put metadates in an external file. Lets you specify metadates for directories or non-story files.cooluri2http://blosxom.sourceforge.net/plugins/link/cooluri2.htm
Makes Blosxom recognize date-based, extensionless URIs (aka Cool URIs) for both stories *and* categoriespermalinkhttp://blosxom.sourceforge.net/plugins/link/permalink.htm
Generates permalinks for you so you can use a consistent link format throughout your siteConfigure Blosxomhttp://blosxom.sourceforge.net/2004/01/05#00
<p>All of Blosxom's configuration is held, for simplicity's sake, in the script
itself. Now don't be afraid; while there are all manner of funny-looking characters, this is really quite simple and we'll go through it a line at a time. The default looks something like this:</p>
<pre>
# --- Configurable variables -----
# What's this blog's title?
$blog_title = "My Weblog"; #
# What's this blog's description (for outgoing RSS feed)?
$blog_description = "Yet another Blosxom blog."; #
# What's this blog's primary language (for outgoing RSS feed)?
$blog_language = "en"; #
# Where are this blog's entries kept?
$datadir = "/Library/WebServer/Documents/blosxom"; #
# What's my preferred base URL for this blog (leave blank for automatic)?
$url = ""; #
# Should I stick only to the datadir for items or travel down the
# directory hierarchy looking for items? If so, to what depth?
# 0 = infinite depth (aka grab everything), 1 = datadir only, n = n levels down
$depth = 0; #
# How many entries should I show on the home page?
$num_entries = 40; #
# What file extension signifies a blosxom entry?
$file_extension = "txt"; #
# What is the default flavour?
$default_flavour = "html"; #
# Should I show entries from the future (i.e. dated after now)?
$show_future_entries = 0;
...
# --------------------------------
</pre>
<p>Each configuration directive consists of a setting name (e.g. <code>$blog_title</code>, an <code>=</code> sign, and the setting's value (e.g. <code>"My Weblog"</code>). In the case of words, the value is kept between double-quotes (<code>"</code>); in the case of numbers, the quotes are absent. To change a setting's value, simply replace the current value with your preferred value. Be sure to leave the double-quotes intact if they're there.</p>
<p>For example, if you were to change your blog's title from the default, <code>My Weblog</code>, to <code>Sam's Insights</code>, that setting line would end up looking like: <code>$blog_title = "Sam's Insights";</code></p>
<p>All clear? Good. Let's move on to the settings themselves.</p>
<ul>
<li><code>$blog_title</code>: The default title of your choosing for this Weblog. This title is available to you in your <a href="/documentation/users/flavour.html">flavour templates</a> and is the title that appears in your outgoing <a href="/documentation/users/syndicate.html">syndicated RSS feed</a>.</li>
<p />
<li><code>$blog_description</code>: The default description of your choosing for this Weblog. This description is available to your <a href="/documentation/users/flavour.html">flavour templates</a> and is the description that appears in your outgoing <a href="/documentation/users/syndicate.html">syndicated RSS feed</a></li>
<p />
<li><code>$blog_language</code>: For use in your <a href="/documentation/users/syndicate.html">syndicated RSS feed</a>, <code>$blog_language</code> signifies the default language for this weblog, the default of <code>en</code> being English. A list of some of the more popular language abbreviations may be found <a href="http://backend.userland.com/stories/storyReader$16">here</a>.</li>
<p />
<li><code>$datadir</code>: The most important setting of the lot, <code>$datadir</code> tells the Blosxom script where to find your weblog posts. This should be the full path to the folder you created when <a href="/documentation/users/install/dynamic/">installing</a> Blosxom.</li>
<p />
<li><code>$url</code>: Leave this blank if Blosxom does a decent job of figuring out what the base URL for your blog should be--this is the case most of the time. Used only if you wish to override what Blosxom automagically figures out is the base URL for your weblog (e.g. <code>$url = "http://www.raelity.org/"</code>).</li>
<p />
<li><code>$depth</code>: It's best to leave this setting as it is until you've read and had some time to fiddle with <a href="/documentation/users/view.html#path">categorization</a> and <a href="/documentation/users/view.html#share">sharing a Blosxom blog</a>. This setting specifies whether Blosxom should stick only to the data directory or travel down any hierarchy it may find inside, looking for blog posts.</li>
<p />
<li><code>$num_entries</code>: The number of entries Blosxom should display on your weblog's home page. This is a balance between letting older posts scroll off the bottom at some reasonable clip versus posts dropping off too soon (if you're a prolific blogger).</li>
<p />
<li><code>$file_extension</code>: While Blosxom's default is to look for files in the <code>$datadir</code> ending in <code>.txt</code>, you can override this by altering <code>$file_extension</code>. E.g. (<code>my $file_extension = "blosxom";</code> would have Blosxom look for files like <code>welcome.blosxom</code> and <code>what_i_ate_for_breakfast.blosxom</code>.</li>
<p />
<li><code>$default_flavour</code>: This setting decides what default <a href="/documentation/users/flavour.html">flavour</a> is presented to the browser if the visitor doesn't specify one in particular.</li>
<p />
<li><code>$show_future_entries</code>: This setting decides what whether post-dated blog entries show up (<code>$show_future_entries = 1</code>) or remain
hidden until their time is come (<code>$show_future_entries = 0</code>), the
latter being the default. Post-dating entries requires a little command-line tomfoolery using the <code>touch</code> command; to learn more about it, consult the "man pages" (built-in Unix manual) by typing <code>man touch</code> on a Terminal window.</li>
</ul>
The rest of the configuration options concern themselves with <a href="/documentation/users/plugins.html">plug-ins</a> and <a href="/documentation/users/install/static/">static rendering</a>, both subjects you should delve into when you're
good and ready to.
<p align="right" class="meta"><a href="/documentation/users/blog.html">click here to write a test blog post...</a></p>
Additional remark to the cgi hiding mechanism: ensure that all URI-s remain hiddenhttp://blosxom.sourceforge.net/faq/cgi/change_url_to_completely_hide_cgi.htm
Tri-Bothttp://blosxom.sourceforge.net/2004/01/01#tribot
description:A sleek and easy-on-the-eyes 3 column floating layout using only CSS (no tables). Based on the CSS from bluerobot.com
preview_url:http://yadkinriver.net/journal/
download_url:http://yadkinriver.net/downloads/tri-bot.zip
screenshot_url:
author:Benson W
author_url:http://yadkinriver.net/journal/
type:Flavour Templates
additional:plugin- breadcrumbs
entries_templatehttp://blosxom.sourceforge.net/plugins/display/entries_template.htm
Provide alternative template for displaying story entries in index pages, so that different features can be incorporated. For example, you can display excerpts in the index page, while enable writeback form in individual stories.wbnotifyhttp://blosxom.sourceforge.net/plugins/input/wbnotify.htm
Sends an email to specified address when a new writeback is entered. Needs writeback plugin.