Added the script and modified the README

bb.sh

@@ -0,0 +1,757 @@
+#!/usr/bin/env bash
+
+# BashBlog, a simple blog system written in a single bash script
+# Author: Carles Fenollosa <carles.fenollosa@bsc.es>, 2011-2012
+
+
+#########################################################################################
+#
+# README
+#
+#########################################################################################
+#
+# This is a very basic blog system
+#
+# Basically it asks the user to create a text file, then converts it into a .html file
+# and then rebuilds the index.html and feed.rss.
+#
+# Comments are not supported.
+#
+# This script is standalone, it doesn't require any other file to run
+#
+# Files that this script generates:
+#	- main.css (inherited from my web page) and blog.css (blog-specific stylesheet)
+#	- one .html for each post
+#	- index.html (regenerated each run)
+# 	- feed.rss (regenerated each run)
+#	- all_posts.html (regenerated each run)
+# 	- it also generates temporal files, which are removed afterwards
+#
+# It generates valid html and rss files, so keep care to use valid xhtml when editing a post
+#
+# There are many loops which iterate on '*.html' so make sure that the only html files 
+# on this folder are the blog entries and index.html and all_posts.html. Drafts must go
+# into drafts/ and any other *.html file should be moved out of the way
+#
+# TODO instead of using a file for $content, use a variable to avoid disk writes
+# TODO enclose all variables with quotes (thanks Durad)
+# TODO use a tag for dates, and keep them in sync with the html files (thanks Durad)
+
+
+#########################################################################################
+#
+# LICENSE
+#
+#########################################################################################
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+#########################################################################################
+#
+# CHANGELOG
+#
+#########################################################################################
+#
+# 1.4.1    Some code refactoring
+# 1.4      Using twitter for comments, improved 'rebuild' command
+# 1.3      'edit' command
+# 1.2.2    Feedburner support
+# 1.2.1    Fixed the timestamps bug
+# 1.2      'list' command
+# 1.1      Draft and preview support
+# 1.0      Read http://is.gd/Bkdoru
+
+
+#########################################################################################
+#
+# CODE
+#
+#########################################################################################
+#
+# As usual with bash scripts, scroll all the way to the bottom for the main routine
+# All other functions are declared above main.
+
+
+# Global variables
+# It is recommended to perform a 'rebuild' after changing any of this in the code
+global_variables() {
+	# If you want to fork the project please contact me first, I wouldn't mind opening a git
+	# or some shared code base and collaborate with other people.
+	global_software_name="BashBlog"
+	global_software_version="1.4.1"
+
+	# Blog title
+	global_title="Waiting for the jobs to finish"
+	# The typical subtitle for each blog
+	global_description="Thoughts on science and tips for researchers who use computers"
+	# The public base URL for this blog
+	global_url="http://mmb.pcb.ub.es/~carlesfe/blog"
+	
+	# Your name
+	global_author="Carles Fenollosa"
+	# You can use twitter or facebook or anything for global_author_url
+	global_author_url="http://mmb.pcb.ub.es/~carlesfe" 
+	# Your email
+	global_email="carles.fenollosa@bsc.es"
+	
+	# CC by-nc-nd is a good starting point, you can change this to "&copy;" for Copyright
+	global_license="CC by-nc-nd"
+	
+	# If you have a Google Analytics ID, put it here.
+	# If left empty (i.e. "") Analytics will be disabled
+	global_analytics="UA-752819-13"
+	
+	# Leave this empty (i.e. "") if you don't want to use feedburner, 
+	# or change it to your own URL
+	global_feedburner="http://feeds.feedburner.com/WaitingForTheJobsToFinish"
+
+	# Leave these empty if you don't want to use twitter for comments
+	global_twitter="true"
+	global_twitter_username="cfenollosa"
+}
+
+
+# Prints the required google analytics code
+google_analytics() {
+	if [ "$global_analytics" == "" ]; then return; fi
+
+	echo "<script type=\"text/javascript\">
+
+  var _gaq = _gaq || [];
+  _gaq.push(['_setAccount', '"$global_analytics"']);
+  _gaq.push(['_trackPageview']);
+
+  (function() {
+    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+  })();
+
+</script>"
+}
+
+# Edit an existing, published .html file while keeping its original timestamp
+# Please note that this function does not automatically republish anything, as
+# it is usually called from 'main'.
+#
+# 'edit' is kind of an advanced function, as it leaves to the user the responsability
+# of editing an html file
+#
+# $1 	the file to edit
+edit() {
+	timestamp="`date -r $1 +'%Y%m%d%k%M'`"
+	$EDITOR $1
+	touch -t $timestamp $1
+}
+
+# Adds the code needed by the twitter button
+#
+# $1 the post URL
+twitter() {
+	echo "<p id='twitter'>Comments? &nbsp;"
+	echo "<a href=\"https://twitter.com/share\" class=\"twitter-share-button\" data-text=\"&lt;Type your comment here but please leave the URL so that other people can follow the comments&gt;\" data-url=\"$1\""
+	
+	if [ "$global_twitter_username" != "" ]; then
+		echo " data-via=\"$global_twitter_username\""
+	fi
+	
+	echo ">Tweet</a>	<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=\"//platform.twitter.com/widgets.js\";fjs.parentNode.insertBefore(js,fjs);}}(document,\"script\",\"twitter-wjs\");</script>"
+	echo "</p>"
+}
+
+# Adds all the bells and whistles to format the html page
+# Every blog post is marked with a <!-- entry begin --> and <!-- entry end -->
+# which is parsed afterwards in the other functions. There is also a marker
+# <!-- text begin --> to determine just the beginning of the text body of the post
+#
+# $1     a file with the body of the content
+# $2     the output file
+# $3     "yes" if we want to generate the index.html,
+#        "no" to insert new blog posts
+# $4     title for the html header
+# $5     original blog timestamp
+create_html_page() {
+	content=$1
+	filename=$2
+	index=$3
+	title=$4
+	timestamp=$5
+
+	# Create the actual blog post
+	# html, head
+	cat .header.html > $filename
+	echo "<title>$title</title>" >> $filename 
+	google_analytics >> $filename
+	echo "</head><body>" >> $filename
+	# body divs
+	echo '<div id="divbodyholder">' >> $filename
+	echo '<div class="headerholder"><div class="header">' >> $filename
+	# blog title
+	echo '<div id="title">' >> $filename
+	cat .title.html >> $filename
+	echo '</div></div></div>' >> $filename # title, header, headerholder
+	echo '<div id="divbody"><div class="content">' >> $filename
+
+	file_url="`sed 's/.rebuilt//g' <<< $filename`" # Get the correct URL when rebuilding
+	# one blog entry
+	if [ "$index" == "no" ]; then
+		echo '<!-- entry begin -->' >> $filename # marks the beginning of the whole post
+		echo '<h3><a class="ablack" href="'$global_url/$file_url'">' >> $filename
+		echo $title >> $filename
+		echo '</a></h3>' >> $filename
+		if [ "$timestamp" == "" ]; then
+			echo '<div class="subtitle">'`date +"%B %d, %Y"`' &mdash; ' >> $filename
+		else
+			echo '<div class="subtitle">'`date +"%B %d, %Y" --date="$timestamp"` ' &mdash; ' >> $filename
+		fi
+		echo "$global_author</div>" >> $filename
+		echo '<!-- text begin -->' >> $filename # This marks the text body, after the title, date...
+	fi
+	cat $content >> $filename # Actual content
+	if [ "$index" == "no" ]; then
+		echo '<!-- text end -->' >> $filename
+
+		if [ "$global_twitter" == "true" ]; then
+			twitter "$global_url/$file_url" >> $filename
+		fi
+		
+		echo '<!-- entry end -->' >> $filename # absolute end of the post
+	fi
+	
+	echo '</div>' >> $filename # content
+	# page footer
+	cat .footer.html >> $filename
+	# close divs
+	echo '</div></div>' >> $filename # divbody and divbodyholder 
+	echo '</body></html>' >> $filename
+}
+
+# Parse the plain text file into an html file
+parse_file() {
+	# Read for the title and check that the filename is ok
+	title=""
+	while read line; do
+		if [ "$title" == "" ]; then
+			title=$line
+			filename="`echo $title | tr [:upper:] [:lower:]`"
+			filename="`echo $filename | sed 's/\ /-/g'`"
+			filename="`echo $filename | tr -dc '[:alnum:]-'`" # html likes alphanumeric
+			filename="$filename.html"
+			content=$filename.tmp
+
+			# Check for duplicate file names
+			while [ -f "$filename" ]; do
+				suffix=$RANDOM
+				filename="`echo $filename | sed 's/\.html/'$suffix'\.html/g'`"
+			done
+		else
+			echo $line >> $content
+		fi
+	done < "$TMPFILE"
+
+	# Create the actual html page
+	create_html_page $content $filename no "$title"
+	rm $content
+}
+
+# Manages the creation of the text file and the parsing to html file
+# also the drafts
+write_entry() {
+	if [ "$1" != "" ]; then
+		TMPFILE="$1"
+		if [ ! -f "$TMPFILE" ]; then
+			echo "The file doesn't exist"
+			delete_includes
+			exit
+		fi
+	else
+		TMPFILE=.entry-$RANDOM.html
+		echo "Title on this line" >> $TMPFILE
+		echo "" >> $TMPFILE
+		echo "<p>The rest of the text file is an <b>html</b> blog post. The process" >> $TMPFILE
+		echo "will continue as soon as you exit your editor</p>" >> $TMPFILE
+	fi
+	chmod 600 $TMPFILE
+
+	post_status="E"
+	while [ "$post_status" != "p" ] && [ "$post_status" != "P" ]; do
+		$EDITOR $TMPFILE
+		parse_file "$TMPFILE" # this command sets $filename as the html processed file
+		chmod 600 $filename
+
+		echo -n "Preview? (Y/n) "
+		read p
+		if [ "$p" != "n" ] && [ "$p" != "N" ]; then
+			chmod 644 $filename
+			echo "Open $global_url/$filename in your browser"
+		fi
+
+		echo -n "[P]ost this entry, [E]dit again, [D]raft for later? (p/E/d) "
+		read post_status
+		if [ "$post_status" == "d" ] || [ "$post_status" == "D" ]; then
+			mkdir -p drafts/
+			chmod 700 drafts/
+
+			title="`head -n 1 $TMPFILE`"
+			title="`echo $title | tr [:upper:] [:lower:]`"
+			title="`echo $title | sed 's/\ /-/g'`"
+			title="`echo $title | tr -dc '[:alnum:]-'`"
+			draft="drafts/$title.html"
+			while [ -f "$draft" ]; do draft="drafts/$title-$RANDOM.html"; done
+
+			mv "$TMPFILE" "$draft"
+			chmod 600 "$draft"
+			rm "$filename"
+			delete_includes
+			echo "Saved your draft as '$draft'" 
+			exit
+		fi
+		if [ "$post_status" == "e" ] || [ "$post_status" == "E" ]; then
+			rm $filename # Delete the html file as it will be generated again
+		fi
+	done
+
+	rm $TMPFILE
+	chmod 644 $filename
+	echo "Posted $filename"
+}
+
+# Create an index page with all the posts
+all_posts() {
+	echo -n "Creating an index page with all the posts "
+	contentfile="all_posts.html.$RANDOM"
+	while [ -f "$contentfile" ]; do
+		contentfile="all_posts.html.$RANDOM"
+	done
+
+	echo "<h3>All posts</h3>" >> $contentfile
+	echo "<ul>" >> $contentfile
+	for i in `ls -t *.html`; do
+		if [ "$i" == "index.html" ] || [ "$i" == "all_posts.html" ]; then continue; fi
+		echo -n "."
+		# Title
+		title="`awk '/<h3><a class="ablack" href=".+">/, /<\/a><\/h3>/{if (!/<h3><a class="ablack" href=".+">/ && !/<\/a><\/h3>/) print}' $i`"
+		echo -n '<li><a href="'$global_url/$i'">'$title'</a> &mdash;' >> $contentfile
+		# Date
+		date="`date -r $i +%B\ %d\,\ %Y`"
+		echo " $date</li>" >> $contentfile
+	done
+	echo ""
+	echo "</ul>" >> $contentfile
+	echo '<div id="all_posts"><a href="'$global_url'">Back to the blog index</a></div>' >> $contentfile
+
+	create_html_page $contentfile all_posts.html.tmp yes "$global_title &mdash; All posts"
+	mv all_posts.html.tmp all_posts.html
+	chmod 644 all_posts.html
+	rm $contentfile
+}
+
+# Generate the index.html with the content of the latest 10 posts
+rebuild_index() {
+	echo -n "Rebuilding the index "
+	newindexfile="index.html.$RANDOM"
+	contentfile="$newindexfile.content"
+	while [ -f "$newindexfile" ]; do 
+		newindexfile="index.html.$RANDOM"
+		contentfile="$newindexfile.content"
+	done
+
+	# Create the content file, maximum 10 entries
+	n=0
+	for i in `ls -t *.html`; do # sort by date, newest first
+		if [ "$i" == "index.html" ] || [ "$i" == "all_posts.html" ]; then continue; fi
+		if [ $n -ge 10 ]; then break; fi
+		awk '/<!-- entry begin -->/, /<!-- entry end -->/' $i >> $contentfile
+		echo -n "."
+		n=$(( $n + 1 ))
+	done
+
+	if [ "$global_feedburner" == "" ]; then
+		echo '<div id="all_posts"><a href="all_posts.html">View more posts</a> &mdash; <a href="feed.rss">Subscribe</a></div>' >> $contentfile
+	else
+		echo '<div id="all_posts"><a href="all_posts.html">View more posts</a> &mdash; <a href="'$global_feedburner'">Susbcribe</a></div>' >> $contentfile
+	fi
+
+	echo ""
+
+	create_html_page $contentfile $newindexfile yes "$global_title"
+	rm $contentfile
+	mv $newindexfile index.html
+	chmod 644 index.html
+}
+
+# Displays a list of the posts
+list_posts() {
+	lines=""
+	n=1
+	for i in `ls -t *.html`; do
+		if [ "$i" == "index.html" ] || [ "$i" == "all_posts.html" ]; then continue; fi
+		line="$n # `awk '/<h3><a class="ablack" href=".+">/, /<\/a><\/h3>/{if (!/<h3><a class="ablack" href=".+">/ && !/<\/a><\/h3>/) print}' $i` # `date -r $i +%B\ %d\,\ %Y`"
+		lines="${lines}""$line""\n" # Weird stuff needed for the newlines
+		n=$(( $n + 1 ))
+	done 
+
+	echo -e $lines | column -t -s "#"
+}
+
+# Generate the feed file
+make_rss() {
+	echo -n "Making RSS "
+
+	rssfile="feed.rss.$RANDOM"
+	while [ -f "$rssfile" ]; do rssfile="feed.rss.$RANDOM"; done
+
+	echo '<?xml version="1.0" encoding="UTF-8" ?>' >> $rssfile
+	echo '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">' >> $rssfile
+	echo '<channel><title>'$global_title'</title><link>'$global_url'</link>' >> $rssfile
+	echo '<description>'$global_description'</description><language>en</language>' >> $rssfile
+	echo '<lastBuildDate>'`date -R`'</lastBuildDate>' >> $rssfile
+	echo '<pubDate>'`date -R`'</pubDate>' >> $rssfile
+	echo '<atom:link href="'$global_url/feed.rss'" rel="self" type="application/rss+xml" />' >> $rssfile
+	
+	n=0
+	for i in `ls -t *.html`; do
+		if [ "$i" == "index.html" ] || [ "$i" == "all_posts.html" ]; then continue; fi
+		if [ $n -ge 10 ]; then break; fi # max 10 items
+		echo -n "."
+		echo '<item><title>' >> $rssfile
+		echo "`awk '/<h3><a class="ablack" href=".+">/, /<\/a><\/h3>/{if (!/<h3><a class="ablack" href=".+">/ && !/<\/a><\/h3>/) print}' $i`" >> $rssfile
+		echo '</title><description><![CDATA[' >> $rssfile
+		echo "`awk '/<!-- text begin -->/, /<!-- entry end -->/{if (!/<!-- text begin -->/ && !/<!-- entry end -->/) print}' $i`" >> $rssfile
+
+		echo "]]></description><link>$global_url/$i</link>" >> $rssfile
+		echo "<guid>$global_url/$i</guid>" >> $rssfile
+		echo "<dc:creator>$global_author</dc:creator>" >> $rssfile
+		echo '<pubDate>'`date -r $i -R`'</pubDate></item>' >> $rssfile
+
+		n=$(( $n + 1 ))
+	done
+
+	echo '</channel></rss>' >> $rssfile
+	echo ""
+
+	mv $rssfile feed.rss
+	chmod 644 feed.rss
+}
+
+# generate headers, footers, etc
+create_includes() {
+	echo '<h1 class="nomargin"><a class="ablack" href="'$global_url'">'$global_title'</a></h1>' > .title.html
+	echo '<div id="description">'$global_description'</div>' >> .title.html
+	
+	echo '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">' > .header.html
+	echo '<html xmlns="http://www.w3.org/1999/xhtml"><head>' >> .header.html
+	echo '<meta http-equiv="Content-type" content="text/html;charset=UTF-8" />' >> .header.html
+	echo '<link rel="stylesheet" href="main.css" type="text/css" />' >> .header.html
+	echo '<link rel="stylesheet" href="blog.css" type="text/css" />' >> .header.html
+	if [ "$global_feedburner" == "" ]; then
+		echo '<link rel="alternate" type="application/rss+xml" title="Blog entries" href="feed.rss" />' >> .header.html
+	else 
+		echo '<link rel="alternate" type="application/rss+xml" title="Blog entries" href="'$global_feedburner'" />' >> .header.html
+	fi
+
+	
+	echo '<div id="footer">'$global_license '<a href="'$global_author_url'">'$global_author'</a> &mdash; <a href="mailto:'$global_email'">'$global_email'</a></div>' >> .footer.html
+}
+
+# Delete the temporarily generated include files
+delete_includes() {
+	rm .title.html .footer.html .header.html
+}
+
+# Create the css file from scratch
+create_css() {
+	# To avoid overwriting manual changes. However it is recommended that
+	# this function is modified if the user changes the blog.css file
+	if [ ! -f "blog.css" ]; then 
+		# blog.css directives will be loaded after main.css and thus will prevail
+		echo '
+			#title {
+				font-size: x-large;
+			}
+
+			a.ablack {
+			color: black !important;
+			}
+
+			li {
+				margin-bottom: 8px;
+			}
+
+			ul, ol {
+				margin-left: 24px;
+				margin-right: 24px;
+			}
+
+			#all_posts {
+				margin-top: 24px;
+				text-align: center;
+			}
+
+			.subtitle {
+				font-size: small;
+				margin: 12px 0px;
+			}
+
+			.content p {
+				margin-left: 24px;
+				margin-right: 24px;
+			}
+
+			h1 {
+				margin-bottom: 12px !important;
+			}
+
+			#description {
+				font-size: large;
+				margin-bottom: 12px;
+			}
+		
+			h3 {
+				margin-top: 42px;
+				margin-bottom: 8px;
+			}
+
+			h4 {
+				margin-left: 24px;
+				margin-right: 24px;
+			}
+
+			#twitter {
+				line-height: 20px;
+				vertical-align: top;
+				text-align: right;
+				font-style: italic;
+				color: #333;
+				margin-top: 24px;
+				font-size: 14px;
+			}
+		' > blog.css
+	fi
+
+	# This is the CSS file from my main page. Any other person would need it to run the blog
+	# so it's attached here for convenience.
+	if [ `whoami` == "carlesfe" ] && [ ! -f main.css ]; then
+		ln -s ../style.css main.css # XXX This is clearly machine-dependent, beware!
+	elif [ ! -f main.css ]; then
+		echo '
+			body {
+				font-family: Georgia, "Times New Roman", Times, serif;
+				margin: 0;
+				padding: 0;
+				background-color: #F3F3F3;
+			}
+
+			#divbodyholder {
+				padding: 5px;
+				background-color: #DDD;
+				width: 874px;
+				margin: 24px auto;
+			}
+
+			#divbody {
+				width: 776px;
+				border: solid 1px #ccc;
+				background-color: #fff;
+				padding: 0px 48px 24px 48px;
+				top: 0;
+			}
+
+			.headerholder {
+				background-color: #f9f9f9;
+				border-top: solid 1px #ccc;
+				border-left: solid 1px #ccc;
+				border-right: solid 1px #ccc;
+			}
+
+			.header {
+				width: 800px;
+				margin: 0px auto;
+				padding-top: 24px;
+				padding-bottom: 8px;
+			}
+
+			.content {
+				margin-bottom: 45px;
+			}
+
+			.nomargin {
+				margin: 0;
+			}
+
+			.description {
+				margin-top: 10px;
+				border-top: solid 1px #666;
+				padding: 10px 0;
+			}
+
+			h3 {
+				font-size: 20pt;
+				width: 100%;
+				font-weight: bold;
+				margin-top: 32px;
+				margin-bottom: 0;
+			}
+
+			.clear {
+				clear: both;
+			}
+
+			#footer {
+				padding-top: 10px;
+				border-top: solid 1px #666;
+				color: #333333;
+				text-align: center;
+				font-size: small;
+				font-family: Courier New, Courier, monospace;
+			}
+
+			a {
+				text-decoration: none;
+				color: #003366 !important;
+			}
+
+			a:visited {
+				text-decoration: none;
+				color: #336699 !important;
+			}
+
+			blockquote {
+				background-color: #f9f9f9;
+				border-left: solid 4px #e9e9e9;
+				margin-left: 12px;
+				padding: 12px 12px 12px 24px;
+			}
+
+			blockquote img {
+				margin: 12px 0px;
+			}
+
+			blockquote iframe {
+				margin: 12px 0px;
+			}
+		' > main.css
+	fi
+}
+
+# Regenerates all the single post entries, keeping the post content but modifying
+# the title, html structure, etc
+rebuild_all_entries() {
+	echo -n "Rebuilding all entries "
+	
+	for i in *.html; do # no need to sort
+		if [ "$i" == "index.html" ] || [ "$i" == "all_posts.html" ]; then continue; fi
+		contentfile=".tmp.$RANDOM"
+		while [ -f "$contentfile" ]; do contentfile=".tmp.$RANDOM"; done
+
+		echo -n "."
+		# Get the title and entry, and rebuild the html structure from scratch (divs, title, description...)
+		title="`awk '/<h3><a class="ablack" href=".+">/, /<\/a><\/h3>/{if (!/<h3><a class="ablack" href=".+">/ && !/<\/a><\/h3>/) print}' $i`"
+		awk '/<!-- text begin -->/, /<!-- text end -->/{if (!/<!-- text begin -->/ && !/<!-- text end -->/) print}' $i >> $contentfile
+
+		# Original post timestamp
+		timestamp="`date -r $i`"
+		
+		create_html_page $contentfile $i.rebuilt no "$title" "$timestamp"
+		# keep the original timestamp!
+		timestamp="`date -r $i +'%Y%m%d%k%M'`"
+		mv $i.rebuilt $i
+		chmod 644 $i
+		touch -t $timestamp $i
+		rm $contentfile
+	done
+	echo ""
+}
+
+# Displays the help
+function usage() {
+	echo "$global_software_name v$global_software_version"
+	echo "Usage: $0 command [filename]"
+	echo ""
+	echo "Commands:"
+	echo "    post [filename]    insert a new blog post, or the FILENAME of a draft to continue editing it"
+	echo "    edit [filename]    edit an already published .html file. Never edit manually a published .html file,"
+	echo "                       always use this function as it keeps the original timestamp "
+	echo "                       and rebuilds whatever indices are needed"
+	echo "    rebuild            regenerates all the pages and posts, preserving the content of the entries"
+	echo "    reset              deletes blog-generated files. Use with a lot of caution and back up first!"
+	echo "    list               list all entries. Useful for debug"
+	echo ""
+	echo "For more information please open $0 in a code editor and read the header and comments"
+}
+
+# Delete all generated content, leaving only this script
+reset() {
+	echo "Are you sure you want to delete all blog entries? Please write \"Yes, I am!\" "
+	read line
+	if [ "$line" == "Yes, I am!" ]; then
+		rm *.html *.css *.rss
+		echo "Deleted all posts, stylesheets and feeds."
+	else
+		echo "Phew! You dodged a bullet there. Nothing was modified."
+	fi
+}
+
+# Main function
+# Encapsuled on its own function for readability purposes
+#
+# $1     command to run
+# $2     file name of a draft to continue editing (optional)
+do_main() {
+	global_variables
+
+	# Check for validity of argument
+	if [ "$1" != "reset" ] && [ "$1" != "post" ] && [ "$1" != "rebuild" ] && [ "$1" != "list" ] && [ "$1" != "edit" ]; then 
+		usage; exit; 
+	fi
+
+	if [ "$1" == "list" ]; then
+		list_posts
+		exit
+	fi
+
+	# Test for existing html files
+	ls *.html &> /dev/null
+	if [ $? -ne 0 ] && [ "$1" == "rebuild" ]; then
+		echo "Can't find any html files, nothing to rebuild"
+		exit
+	fi
+
+	# We're going to back up just in case
+	tar cfz .backup.tar.gz *.html
+	chmod 600 .backup.tar.gz
+
+	if [ "$1" == "reset" ]; then
+		reset
+		exit
+	fi
+
+	create_includes
+	create_css
+	if [ "$1" == "post" ]; then write_entry "$2"; fi
+	if [ "$1" == "rebuild" ]; then rebuild_all_entries; fi
+	if [ "$1" == "edit" ]; then edit "$2"; fi
+	rebuild_index
+	all_posts
+	make_rss
+	delete_includes
+}
+
+
+#
+# MAIN
+# Do not change anything here. If you want to modify the code, edit do_main()
+#
+do_main $*