用Octopress把博客顺利搭建了起来,所遇到的问题也都顺利解决。
之前在用Wordpress的时间里,它一度让我忍无可忍。淘宝上25元买来的主机当然太过缓慢,在无比缓慢的操作下,我失去所有的耐心。终于某一天,我愤怒地一气之下删掉了数据库中所有文件,关闭了Wordpress。(删除前数据库备份过。)
看到阮一峰在博客上介绍怎样用Github Pages和Jekyll搭建博客,我眼前一亮。这的确是一种“建立网站的全新思路”,开始吸引到我,不仅因为它免费,不用自己的服务器,而且因为它看上去够轻量级,够快够酷。
我按照阮一峰的文章教程执行了一遍。生成的文章页面似乎过于单调,需要更多个人配置,于是决定转战Octopress。Octopress是在Jekyll上建立起来的,算是Jekyll的简化版。
开始我看了一些个人博客上介绍Octopress如何搭建的文章,不同博客说法各异。我主要参考的是Octopress的Documentation。
下文的介绍完全参考官网文档的步骤。我是纯小白,下面的叙述可能有很多不正确或者不严谨的地方,欢迎指正。
搭建步骤
1. 安装前配置
首先安装Git。
然后安装Ruby。需要安装rbenv或者RVM。
执行ruby --version
查看Ruby版本,要求1.9.3或者更高。
2. 安装Octopress:
从GitHub上clone源码:
git clone git://github.com/imathis/octopress.git octopress
cd octopress
接着安装依赖项(dependencies):
gem install bundler
rbenv rehash # If you use rbenv, rehash to be able to run the bundle command
bundle install
然后安装Octopress默认主题:
rake install
如果日后想更改主题,一般可执行以下命令进行更改:
cd octopress
git submodule add GIT_URL .themes/THEME_NAME
rake install['THEME_NAME']
rake generate
这里提供了许多第三方开发主题。
3. 配置Octopress
主要修改Octopress文件夹中的_config.yml
文件:最基本的是修改url
,title
,subtitle
和author
。这里,如果想给博客增添评论功能,可以使用Disqus,在# Disqus Comments
处填写上disqus_short_name,并把disqus_show_comment_count改为true。
另外根据此博客,还最好做一些配置避免因为GFW使页面加载过慢:首先是在_config.yml
中,把里面的twitter相关的信息全部删掉;其次,修改定制文件/source/_includes/custom/head.html
把google的自定义字体去掉。
4. 生成博客
博客存放在source/_posts
目录下,命名规则是YYYY-MM-DD-post-title.markdown
。
执行下面语句生成一篇新博文:
rake new_post["title"]
比如:
rake new_post["Blogging with Octopress"]
可以在文本编辑器中看到以下内容,并继续写作。
---
layout: post
title: "Blogging with Octopress"
date: 2014-09-08 8:88
comments: true
external-url:
categories:
---
如果想生成新页面则执行:
rake new_page[super-awesome]
或者
rake new_page[super-awesome/page.html]
博文采用markdown语法。相关语法可以参考这篇和这篇文章。在Mac平台可以使用Mou作为Markdown编辑器。此外Windows平台有MarkdownPad和MarkPad,Linux平台有ReText。
写完博文后,
接着执行:
rake generate
生成静态文件;
并可以执行:
rake preview
在浏览器中输入http://localhost:4000/ 进行预览。
5. 将博客部署到GitHub Pages
官方文档提供了三种部署(deploying)博客的方法:GitHub Pages, Heroku 和 Rsync。我选择使用GitHub Pages。
注册一个Github账号,建立一个新的代码仓库(repository),使用username.github.io
命名,这里username是GitHub的用户名。
然后执行:
rake setup_github_pages
需要输入刚才repository的HTTPS clone URL,直接拷贝即可,像这样:[email protected]:username/username.github.io.git
。
接着执行:
rake generate
rake deploy
发布文件。
最后将source提交到git:
git add .
git commit -m 'comment'
git push origin source
6. 发布博文
之后发布博文,执行下面命令即可:
rake new_post["New Post"]
rake generate
git add .
git commit -m 'comment'
git push origin source
rake deploy