Creating and Maintaining a Blog

Note that the built-in org-mode in emacs might be outdated, the best solution is to remove the built-in org-mode and reinstall it from the package manager via M-x list-packages. Jekyll can be installed through RubyGem. On my OSX, the ruby and gem are preinstalled, so gem install jekyll works for me.

As my final goal is posting the blog to GitHub, the working folder of my blog is xiaoliuai.github.io.

jekyll new xiaoliuai.github.io
cd xiaoliuai.github.io
jekyll serve

Then you can see the portal page by opening localhost:4000 in your web browser.

Now I would like to introudce the directory hierarchy of jekyll. Since I will move to octopress, which is a wrapper of jekyll with different directory setting, I just introduce the essential part to make the things work.

xiaoliuai.github.io/
-- _posts/
-- _sites/
...

Two main directories need special attention, that are, _posts and _sites. The first folder contains the source files, which are markdown file, html file, etc. as input for jekyll; the second folder contains the generated static server pages. All the project should be uploaded to github to be displayed where the index.html file is the portal of web site. The GitHub Pages understand this directory configuration and will automatically display the contents in _sites.

The simplest personalization of the blog site is editting _config.yml under the project directory. Following the attribute names in this file, you can easily understand how to specify the blog name, description, email address, etc.

Installation of octopress is little complex since it requires low version ruby.

• Local site

  The octopress puts the generated web site, including the pages, layouts, images, etc. into the public folder for local preview. The source folder contains all the source files used to generate the site, including the layout HTML files, Java-scripts, style-sheets, etc. It can be seemed as a hyper _posts folder that contains source files more than blog HTML files. The familiar _posts folder used in jekyll is under this folder. Let's start blogging.

  First, go into the octopress folder, type rake new_post["title"], octopress will ask you to give a blog tile, then creates a markdown file into the _posts folder with jekyll format (concatenate date and the title as the file name).

  rake new_post["My first blog"]
  # create source/_posts/2014-10-28-my-first-blog.markdown
  

  This file should be edited respect to the jekyll protocol.

  Second, ran rake generate to generate the site in public and then ran rake preview to mount a web-server at http://localhost:4000.

• Deploying to Github Pages

  Octopress integrated commands to let you deploy the generated site to the github.

  rake setup_github_pages
  

  This command will ask you for a URL of the Github repo, then it will store your Github pages repository URL as the origin remote and change the octopress remote to octopress. The directory of octopress becomes the repository of the source branch of the origin remote (your Github Pages repo). The _deploy directory, becomes the master branch of the origin remote. Run command:

  rake deploy
  

  will update the files in public to _deploy, then push the changes to the master branch of the origin remote. To keep your settings and sources tracked, run

  git add .
  git commit -m'Your message'
  git push origin source
  

  to push the contents in octopress directory to the source branch of the origin remote.

  One thing confusing is that one repository (master branch) is under another repository. But the directory _deploy is in the gitignore of source branch, hence solve the self-contain problem.

• 注册一个Disqus账号,在菜单里找到admin,add to site. 生成评论之后会得到 一个博客码.
• 在 _config.yml 里面找到 disqus_short_name:, 把刚才得到的博客码写 进去.然后在emacs端的propoties里面加上 :comments: true,总之就是要使 得导出的html片段的头部有 comments: true 的标记.然后就OK了.

• [ ] 给代码块加行号
• [ ] 进一步美化(抄完)