Knowledge Base


All content on this website is © Copyright 2000-2010 - All Rights Reserved
The content on this site may not be reused or republished.
Website template powered by VooWeb.com Website Templates

Authoring/Development - System CGI: blosxom

Homepage: http://blosxom.sourceforge.net/
Modifications Required: yes

What is Blosxom?

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.

Preparing to Install

You will need to have an active SSH session to the pair Web server where your account is hosted, as well as an active Account Control Center session.

Setting up your Blog

You will need to place the blosxom.cgi script in your web directory. Issue the following commands in your SSH session to create the script's data directory and copy it to your account:

mkdir /usr/home/USERNAME/blosxom
cd /usr/www/users/USERNAME/MAPPEDDIRECTORY/
cp /usr/www/cgi-bin/blosxom.cgi .

Please note that you must 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.

Please note that anywhere you see "USERNAME", you should substitute the username of your own hosting account. Also, anywhere you see "MAPPEDDIRECTORY", you should substitute the name of the directory to which your domain is mapped in your account. You can find this directory by following these steps in the Account Control Center:
- Select "Domains".
- Select the domain name you wish to use with Blosxom.
- The directory to which this domain is mapped is designated by the field "Domain Mapped:".

The last step in setting up your blog is to customize the blosxom.cgi script for your website. To accomplish this, you should use your favorite text editor (such as pico or vi) to modify the script. You will need to set these variables:
- $blog_title - This text will appear at the top of your blog.
- $datadir - This is the directory where you'll store your blog entries.
- $num_entries - This is how many entries to display on your blog's home page.

How do I Blog?

You can now view your blog's home page. Use the following URL to access it, replacing 'EXAMPLE.COM' with your own domain name:

http://www.EXAMPLE.COM/blosxom.cgi

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, 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 entries. Specific days, months, or years can be referenced like this:

http://www.example.com/blosxom.cgi/2002/sep/4
http://www.example.com/blosxom.cgi/2002/sep
http://www.example.com/blosxom.cgi/2002

Please provide feedback on this article.




 
Related Links
» The Basics
» Frequently Asked Questions
» E-Mail
» E-Commerce
» Promotion
» Advertising on Your Site
» Glossary
» Authoring/Development
» About Your Account
» Our Network and Servers
» Billing

» Contact Tech Support

« Knowledge Base Home


 
 
pair Networks - World Class Web Hosting Collections

All content on this website is © Copyright 2000-2010 - All Rights Reserved
The content on this site may not be reused or republished.
Website template powered by VooWeb.com Website Templates

dhhzp.com v 4_3