1.9 KiB
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.