Home | Contact Us | About Us
w w w . k m a n . o r g
Karine Candela & Thierry Kormann's Website

1. Blog24

Blog24 is a really simple publishing system which installs on web servers to enable individuals or organizations to manage and update weblogs. Blog24 is free and opensource.

If you want to read more about why I decided to implement my own blog, you can read my post called Time to blog!.

2. Requirements

3. Key System Features

4. Installation

5. General Principles

Note: Examples are delimited in this section between lines of "----". The "----" lines are not part of the example itself.

5.1 Filebased

Both posts and comments are stored as plain text file in the filesystem under the directory of your choice (entries/ by default). Each post and comment are saved into a separate file.

The syntax of the filename for a post and comment is described bellow. The 'post-filename' describes the syntax used for post filenames where the six digit number represents the number of the post. The 'comment-filename' represents the syntax used for comment filenames where the six digit number represents the number of the post this comment refers to and the three digit number represents the number of this comment (relative to a particular post).

post-filename    = "E"[6*DIGIT]
comment-filename = "C"[6*DIGIT]"-"[3*DIGIT]

Example:

----
entries/E000001      // the first post
entries/E000002      // the second post
entries/C00001-001   // the first comment of the first post
entries/C00001-002   // the second comment of the first post
----

5.2 Post and Comment Syntax

Both posts and comments are plain text files and have a syntax very similar to the Internet Message Format (RFC 2822). First come the header fields, followed by a blank line and the body message.

5.2.1 Header Fields

Author:
- required - the author of this post
Email:
- required - the author's email of this post
Date:
- required - the date of this post (RFC 822 formatted date)
Title:
- required for posts only - the title of this post

5.2.2 Body

Plain text or HTML for posts. Only plain text for comments for security reasons.

5.2.3 Example

----
Author: Eka
Email: foo@bar.com
Date: Sat, 29 Nov 2003 14:02:06 +0100
Title: Test

Blog24 is a really simple publishing system.
----

6. Download

That will come soon...