Bob is a small static generator, for those who wants to maintain a personal website or blog, all from the command line.
It only is designed in bash script, and should work perfectly fine on any Unix like machine.
git clone https://github.com/SiwonP/bob.git
cd bob
make install
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 init
It will create an index.html
at the root of your folder, a bases
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, and a drafts
folder where to
put drafts of posts before publishing them.
To write a post, create a markdown file in the bases
folder whose name will
also be its title, and convert it to an html file, type the following command
from the root :
bob publish
The publishing command 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 help
- 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.
- 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 ...).
- Add a preview function for TRUE drafts being written
- Take into account the headers possibilities of multimarkdown, which could replace the self header writing process and include other features such as Mathjax