Blosxom [pronounced "blossom" or "blogsome"] is a lightweight yet feature-packed blog application. A "blog" (also known as a "Weblog") is an online journal with the newest entries appearing at the top of the Web page.
First, you will need to create a data directory where you will store all of your blog entries. First, issue the following command in your SSH session:
Please note that anywhere you see "USERNAME", replace it with your your Web hosting account username.
You will then need to place the blosxom.cgi script in your Web directory. Issue the following commands to do so:
cp /usr/www/cgi-bin/blosxom.cgi .
Please replace "USERNAME" in the commands above with your your Web hosting account username.
You must also supply the space and period at the end of the above command. The period indicates that you are copying the script into the current directory.
Anywhere you see "MAPPEDDIRECTORY", replace it with the name of the directory to which your domain is mapped in your account. You can find this directory by following these steps:
The last step in setting up your blog is to customize the blosxom.cgi script for your Web site. To customize this script, you should use your favorite text editor (such as pico or vi) to modify the script. You will need to set these variables:
You can now view your blog's home page. Use the following URL to access it, replacing "EXAMPLE.COM" with your own domain name:
If you wish to use your domain name only to point to your Blosxom blog, you can easily do so in the Account Control Center (ACC) by adding your domain name first in the list of index pages. Follow the instructions below to do so:
To add an entry to your blog, simply create a text file in your data directory. It doesn't matter what it's called as long as it ends with ".txt." Once it's saved, it will show up on your blog immediately. Create a new file for each entry. If you don't want an entry in progress to appear in your blog, save it with an extension other than .txt and then rename it to .txt when you're ready to publish. The UNIX command to rename a file is "mv" (example: "mv file.tmp file.txt").
You can add style to your blog by replacing the default header and footer with your own. To do this, create "head.html" and "foot.html" files in your data directory.
Eventually, you may want to link to archived blog entries. Specific days, months, or years can be referenced like this: