Installation of

Writing blogposts is a proof-of-concept for me having them as a knowledgebase. For a some time when writing any note I use AsciiDoc(tor) format. Thus I started to search for option that allows me to write blog-notes that way too.

I could see that many people host blogs at I decided to try that way too. I started by looking for a tool to generate static webpages with AsciiDoc support. There is the mostly used Jekyll - written in ruby, generating a webpage from template on your local machine. There is plugin for AsciiDoc. Other tool that I was evaluating was :awestruct.

Then I found that has a concept of a webapp whole written in javascript which generates static website directly in your browser sending it then to GitHub repo. Merit of this approach is a nice admin console in your browser. Flaw is a little bit longer waiting time to get post being published. The other could be current stall in the development process. But it seems not be fully true as there is new versions coming (see 0.8.0).

So far so good. I decided to give it a try.

Process of installation is quite simple - you fork repo, change config file and you can start to write a blog posts inside of the administration console.

…​or if you plan to run blog against your custom domain these steps could be helpful for you

  1. Fork repo

Having set the custom domain will cause creation of CNAME file under root of your github repository.

The content of the file is just the name of your custom domain - thus what you put to the field.

  1. change hubpress/config.json file to contain (meta)data

    • username

    • repositoryName

    • branch

    • cname in my case it was like this

  "meta": {
    "username": "ochaloup",
    "repositoryName": "",
    "branch": "gh-pages",
    "cname": "",
}, ...

config.json file serves to as a configuration file so all settings that you will set in administration interface will be saved here

  1. When all is set fine you can now go to admin page which is hidden under subaddress hubpress. In my case it’s at path You need to log in with credentials which you use to login to GitHub. calls directly the GitHub identification service to confirm that you are the owner of the repo.

  2. Afte the first login you can see empty screen. That’s ok and just create a new article.
    [Updated] for version 0.8.0 it seems that there is already shown information that you have 0 posts so it’s not misleading already.

  3. For Disqus you need short name for your site to be set in You will find it when already having page under Discusq when you go AdminSettings → choose page → GeneralShortname

That’s more or less it. Now it’s time to write and experiment.

comments powered by Disqus