HubPress

HubPress is a free, open source tool to build your futur awesome blog!

Created and maintained by Anthonny Quérouil (twitter @anthonny_q).

Note	HubPress is actually in preview, if you find some bugs come to see us.

A complete documentation will come here soon.

Getting started

Installation

Fork the repository

If you already know github, you know what to do.

For the others, click on the fork icon :

This will create a copy of this repository in yours.

I will use the github.io domain

Here is the simplest way, few step are required.

You need to set some values in hubpress/config.json :

You have two values to set :

• username: it’s your github username,

• repositoryName: it’s the name of your fork, hubpress.io if you did not rename it.

Commit and open your website http://<username>.github.io, you’ll see :

Congratulations, installation is done !

I will use a custom domain

If you have a custom domain name, we recommand to use gh-pages.

In the settings, set the default branch to gh-pages :

Switch your repository to the branch gh-pages

set some values in hubpress/config.json :

You have two values to set :

• username: it’s your github username,

• repositoryName: it’s the name of your fork, hubpress.io if you did not rename it.

Commit and open your website http://<username>.github.io/<repositoryName>;, you’ll see :

Congratulations, installation is done !

Usage

The administration of your blog is available at /hubpress

• http://<username>.github.io/hubpress

or

• http://<username>.github.io/<repositoryName>/hubpress

Connexion

You need your github credentials to log in hubpress. Then a personal token will be generate for the futur call to the Github API.

Settings

The first thing to do is going to the Settings page. Here you can specify your CNAME, pagination or your social network accounts

Coming soon

List of posts

Coming soon

Your first post

Coming soon

==Credits

Coming soon