XXXXXXXX

This is an example post

This is an example of how to add a new post to blogsh. This file consists of four parts:

1. The first line contains the date and time when the post was made. This is used to sort posts, to produce the "recent" and monthly archive pages, and is displayed after the post.
2. The second line is the post title. This is used in the "recent posts" links, appears at the top of the post in question, and appears as the page title on pages containing an individual post.
3. The third line contains a list of categories (this information goes into the RSS feed, and doesn't appear anywhere else).
4. The rest of the file contains the post content. This is copied directly into the HTML pages produced, so it can contain any formatting you like (although some <div> tags may interact oddly with the page formatting).

The last and most important element is the filename. This will have ".html" appended to produce the name of the file containing that specific post. I suggest using names of the form year-month-day-foo where foo is related to the post title, but this is not required. Whatever file name you use, you must place the posts (and nothing else!) into the posts/ subdirectory of blogsh.

One final quirk: Due to the mechanism used (sed) to generate the HTML files, posts containing odd characters may cause problems. I think I've made backslashes, pipes, and ampersands work properly (\|&) but there may be some other characters which will break the code.