2.0 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 https://github.com/SiwonP/bob.git
cd bob
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 init
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 publish
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 help
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.
- 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 ...).
- Todo maybe change the drafts folder name because it contains the final version of posts
- Add a preview function for TRUE drafts being written