Software
pelican is a blog software written in python that generates html files from your markdown or restructured text and other markup files. We use restructured text files here. You need pelican (and ghp-import to make our life easier).
Install Pelican and ghp-import with
pip install --user pelican pip install --user ghp-import
Clone the source of this blog pages
git clone https://github.com/ganltc/pages.git cd pages Update or add new restructured text files (.rst extension) in "content" directory with any changes you want
Test locally
make html # creates "output" directory from "content" Open "output/index.html" with your favourite browser. Edit the .rst files until you think they look good in your browser!
Push the source (rst files) repo upstream
git commit -a # commit your changes locally git push origin master # update github pages repo
Create gh-pages branch with ghp-import tool
make publish # creates "output" directory for publishing ghp-import output # creates gh-pages git branch with "output"
Push gh-pages upstream to ganltc.github.io repo
git push https://github.com/ganltc/ganltc.github.io gh-pages:master