+----------------+ | Introduction | +----------------+ Thanks for using Hydrogen CMS. May you be blessed with holy penguin piss! Prepare for a wordy long winded introduction. I won't say much here, so if you want to get running go take a look at the 'config' and 'usage' sections. Hydrogen is meant to be a VERY simple, easy to use, modular bloging system, that's entries are made only through email. This allows the user to blog 'anywhere, anytime' from any device that can send an email. As of version 0.6a As of version 0.6a we are sitting at 80 lines of code, and I intended to keep the base as tiny as possible (100 lines?). Through the use of plug ins you will be able to enhance your bloging experience (See below for future plug in ideas). Aaaand scene. I'm very open to comments, ideas etc. My email ( rick@isawsome.net ) can be found at the bottom of the README. Oh, and right up there. +----------------+ | Installation | +----------------+ Installation is pretty easy. Untar into your cgi-bin directory. Then in your htmls root directory vi .htaccess RewriteEngine on RewriteBase / RewriteRule ^$ /cgi-bin/hydrogen.cgi Edit head.hy to change the page title and header. See below for more information of making your page look not crappy. I would also recommend a 'chmod 700 hydrogen.cgi' as your password could be out in the open. +----------+ | config | +----------+ Edit hydrogen.py. User variables are at the top. POPHOST - your pop email host USERNAME - your email username PASSWORD_ - your email password SSL_ - Set to 1 if your server requires SSL (gmail) Set to 0 if you don't need SSL BOUTPUT - The directory where hydrogen resides. eg /home/httpd/html/cgi-bin UPDATE - Time before next update +---------+ | usage | +---------+ I tried to make the usage as simple as possible. To make an entry to your blog send an email to the account you configured hydrogen for. Put the subject of your email between the hydrogen title tag: [h]. This will become your blog title. Example to follow: [h] This is my blog entries title [h] In the body of your email enclose the text you want in the body of your blog with the hydrogen body tag: [hb] Example to follow: [hb] This is the body of my blog [hb] Send the email and your post will be added on the next run of hydrogen. +-------------------+ | what should work | +-------------------+ - You should be able to use an existing email, only messages with the hydrogen tags will be added. - New entries should be at the top. - HTML support is kind of iffy. I'm using GMAIL to test and it automagicly detects links and email addresses and they get passed. - I've done all my tests with the 'hydrogen' email on GMAIL. GMAIL to GMAIL works great. I've also tested anonymous email to GMAIL with no issues. +---------+ | to do | +---------+ Future Features (say that 3 times fast): IMAP Support (Should be easy) Ability to run on local machine and FTP/SSH new page Non dedicated email support (Should be implemented already) Plug ins (Worked out - just need to code) Authorized Email List (May require a lot of work) Feedback that you're message was posted (plug in?) Archiving System (foo amount of posts per page)(plug in?) Pretty error messages Categories (plug in?) Installer (Is this worth it?) Create a nicer CSS Make a sweet logo Static page generation (one time deal) +---------------------+ | tricking 'it' out | +---------------------+ You can change the look by editing the CSS theme. Custom colors could be generated by an installer script to make things easy as pie? head.hy contains the bulk of the HTML used to generate the blog. There is a DIV called links that can be used to create a menu on the right side. Yes, this is the same CSS from isawsome.net, and yes I will make a nice new one. If you figure out something cool make sure you share with the class! Email bugs and requests to "We are about to be attacked by Al Qaeda. Wave flags if you have them. That always seems to scare them away. I'm kidding."