The project goal is to provide a small set of simple tools for publishing a personal Bliki.
chmod u+x runtests ./runtests
- Install the script in your PATH using 'install [PATH]'.
- In the directory you want to be your Bliki home run 'potwiki init'.
- Edit .bliki/bliki_conf
- Write wikipages and posts in Markdown.
- Run 'potwiki make'.
It is recommended to use a plain text wiki plugin for your editor.
Add a post header:
Make the bliki:
Open bliki in default browser:
Every blog post should have the following header:
title: [TITLE] author: [LASTNAME] [FIRSTNAME] date: [YYYY]/[MM]/[DD] location: [CITY], [COUNTRY] tags: [TAGS]
Warning: this section will not be correct if vieved in plain text but will look correct in the Bliki.
Sometimes you want to escape the ~WikiWords. Use ~~ in front of the WikiWord and it won't be made in to a link. If you want to use a ~~ write ~~~ and one will survive the process.
is rendered like
is rendered like
Edit pages on Github
If you store the Bliki repository on Github you can fill in the following info in .bliki/bliki_conf:
This will make a "Edit on Github" link appear on each page. If you have access to the repo there you can edit the page following the link.
Update Bliki on Github post-receive
Install the script on the server according to 'Start using' and pull the bliki git from Github.
Make sure the TARGET_DIR in bliki_conf point to the web server root. In the bliki directory run:
potbliki github potbliki make
Set Githubs post-receive post to:
[Your bliki's URL]/cgi-bin/push.cgi
Anytime you push to your repo on Github the bliki will now pull from the repo and remake the bliki.
If you have a Disqus-account, register the Bliki there and enter the Disqus short name in your .bliki_conf: