bob

Bob is a small static generator, for those who wants to maintain a personal website or blog, all from the command line.

Installation

It only is designed in bash script, and should work perfectly fine on any Unix like machine.

git clone
make install

Usage

For a start, to generate an empty blog, type in the following in the directory where you want to put your blog in and follow the guide.

bob -i

It will create an index.html at the root of your folder, a drafts folder in which you will store all the posts you want to publish and a posts folder where the resulting posts in html will be stored.

To write a post, create a markdown file in the drafts folder whose name will also be its title, and convert it to an html file, type the following command from the root :

bob -p

The publishing command bob -p will rep-ublish all the drafts, that is why anytime you want a post removed, delete in from the drafts folder and re-publish your blog.

See the help for additional command, such as modification of the main configuration of the blog.

bob -h

TODO

• Make a proper header/footer for the posts (e.g. adding links to social networks such as tweeter, github, dev.to ...).
• Complete the CSS files.
• Support long arguments on the command line for more readability.
• Add a comment/like section ?
• Adding a git component, and a server configuration to allow synchronisation. Maybe the drafts folder on the personal computer triggers changes on the git repo of the server which re-publishes the blog automatically.
• Add a way to do all the construction of the blog on the personal computer but to send the html files to a distant server.
• Consider adding configuration files for some/all posts (if they need special javascript included e.g. MathJax, AJAX, sockets ...).
• Design a makefile to install the script on the bin directory for an easy access on the command line.