inamidst.com

Whits Source

This page tells you how to set up your own weblog using the software powering the Gallimaufry of Whits. If you want something with an easier install process, see Cody Woodard's derivative Flog Source, recommended for people who don't want to spend 20-30 minutes or so rewriting code.

1. Create a directory for the weblog on your server, e.g. /notes/
2. Save the note notes script to a directory in your $PATH. To create a post, you will type "note" at the shell prompt. Don't forget to chmod +x it, and edit it to use the correct paths.
3. Option: if you want an Atom Feed, save feed.cgi to, e.g., /notes/feed.cgi You will have to edit it slightly to use your weblog's name and so on.
4. Option: if you want to automatically generate HTML files, download parser.py and .htaccess and put it in your e.g. /notes/ folder. You will have to edit parser.py to use your weblog's name etc.
5. If you like, you may also download index.cgi which will give you a nice pretty index for the site. Again, it'll need a small amount of editing.

Then, to post:

• Try typing "note" on the command line. It may ask you to create a file in some directory. If so, make /notes/YYYY/MM.txt where YYYY is the current year and MM is the current month (two digit numeric, e.g. "01" for January) before continuing. You might want to use the top of 2007/01.txt as a template.
• Type in your note. Again, see 2007/01.txt for examples, especially if you're using parser.py too.

Enjoy!