Blog With Emacs Jekyll Githubpage

Static site, as it's name, is delivered to the user exactly as stored. The dynamic part of the page, like comment, must be add as plugins. The advantage is that it's cheap and fast to develop, and easy to host. With generators like jekyll, you can build a site in seconds.

Github pages are public web pages freely hosted and easily published through github. There are two ways to set up a github page. First, you can create a repository called "username.github.io", where username is your username for github. Then this repository is your default git page repo. Push your site to master branch of this repo. You will see the site at https://username.github.io/ . Second, actually, every repository can be a git hub page by creating a branch called gh-pages. All the content on this branch, can be visit via https://username.github.io/project. For example, my blog repository https://github.com/terrylu87/terrylu87.github.io.git . So that you can visit my site by https://terrylu87.github.io.

This wouldn't be a problem if you understand the basic principle describe in previous section. For me, I use the defautl username.github.io repository.

git clone https://username.github.io/terrylu87.github.io.git blog

There are many tutorials online about how to generate a static blog. The document on the jekyll official website is good. But if you want a customized theme, or support the archive and tags and other feature. You need a better starting point. I use jekyll bootstrap : http://jekyllbootstrap.com/. The jekyll bootstrap support theme, which can easily be installed and changed.

git clone https://github.com/plusjade/jekyll-bootstrap.git jb

install ruby and JavaScript environment

sudo apt-get install nodejs ruby-dev

Install Jekyll

sudo gem install jekyll

Test the site

cd blog
jekyll serve

I use disqus for comment. Register an account at disqus official site. They will provide some tutorials. But since our jekyll bootstrap had disqus integration. We just need change the \_config.yml file under jekyll root dir.

comments :
    provider : disqus
    disqus :
      short_name : your_short_name

You can find a theme at http://themes.jekyllbootstrap.com/

cd blog/
rake theme:install git="https://github.com/jekyllbootstrap/theme-the-program.git"
rake theme:install name="THEME-NAME"