How to use this blog

This is a short HowTo on how this blog is updated. To update the blog you need access to the git repository on github.

Pre request

This blog is generated by Pelican. To start with we need to install the blog engine and check out the Git repository on github where the blog resides.

Install Pelican

Start with installing latest version of the Pelican blog engine.

sudo apt-get install python-pip git 
sudo pip install pelican markdown ghp-import docutils pygments feedgenerator unidecode

Check out the blog

Make a local copy of the blog repository.

git clone --recurse-submodules

Add an article

Now we are going to add an article to the blog.

  • Go into the git repository and ensure that you are on the blog branch.
git checkout blog
  • Ensure you have the latest updates.
git pull
  • Add your article under blog in content folder. Tips is to use YYYYMMDD- as a prefix for your filename.
cd content/blog
  • Fill out the standardized header of the blog.
Title: Example title
Date: 2015-01-16
Tags: example, tag, list 
Slug: example
Status: draft

Example ingress.

## Examle headline

New example paragraph here.
  • Remove the Status: draft when you are ready to publish the article.

  • Add the new article to the git repository and push it to github.

git add
git commit -a -m "Added example article"
git push
  • Publish the article by generating the blog from the main folder of the repository.
make github

Since I didn't remove the Status: draft of this example, it is accessible under the draft folder on the blog /drafts/example.html.

vim: set syn=markdown spell spl=en: