开启OctoPress之旅

程序猿就是个爱折腾的职业~之前搞ACM的时候曾经在CSDN和cnblogs上写了不少题解,写起来确实轻松,但那种千篇一律的博客风格着实让人觉的不爽。ACM退役之后开始写技术博客,用wordpress在BAE上搭建了个人博客,wordpress确实强大,但BAE龟速就算了,动不动就打不开实在让人无法忍受。

Hujiawei Bujidao大神的推荐下,接触了OctoPresss,有种眼前一亮的感觉,高度的可定制性,本地化的博文编辑,天然支持Markdown语法,还能借助github做版本控制,并且可以利用github来拥有无限的空间和流量,实在是十分完美。总结一下,OctoPress简直就是为程序猿而生的~

安装流程

关于如何安装与配置Octopress,官方文档里都介绍的十分详细,也可以跳过下面这些去看官方文档:http://octopress.org/docs/

0.准备工作

1.安装git
一般在库里都有,apt-get或者yum下来就可以了。

2.安装ruby
ruby最好按照官方推荐安装1.9.3-p0版本的,否则有可能会出现错误,我用rbenv做ruby的版本管理工具

1
2
3
4
5
6
7
8
9
10
11
12
13
#安装rbenv
cd
git clone git://github.com/sstephenson/rbenv.git .rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
git clone git://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
source ~/.bash_profile
#安装ruby
rbenv install 1.9.3-p0
rbenv global 1.9.3-p0
rbenv rehash
#检查版本是否正确
ruby --version

1.安装octapress

1
2
3
4
5
6
7
8
9
10
#pulloctopress源码
git clone git://github.com/imathis/octopress.git octopress
#进入octopress所在目录
cd octopress
#安装依赖库
gem install bundler
rbenv rehash # If you use rbenv, rehash to be able to run the bundle command
bundle install
#使用默认主题安装
rake install

我这里在bundle install时报错You must recompile Ruby with OpenSSL support,这是由于没有安装openssl相关包造成的,yum install openssl-devel openssl即可

2.发布到github

首先在github上新建一个Public的repo,repo的名字必须是username.github.io,其中username是你github的用户名

1
2
#设置github所在repo
rake setup_github_pages

输入git@github.com:username/username.github.io.git即可

使用rake生成博客并发布到github的master分支上

1
2
rake generate
rake deploy

在deploy前还可以使用rake preview命令在本地预览,默认使用4000端口

接下来,可以将博客的源码也提交到项目的source分支中,这步是可选的,不过最好养成每次deploy后都顺便提交源码的习惯

1
2
3
git add .
git commit -m "message"
git push origin source

3.自定义域名

如果你有自己的域名的话,可以创建CNAME文件以使用你自己的域名来访问博客

1
2
3
echo 'c4fun.cn' >> source/CNAME
rake generate
rake deploy

然后修改在DNS服务器上CNAME记录指向username.github.io.就可以用你自己的域名来访问博客了

4.大功告成

如果以上步骤都没有问题的话,输入username.github.io应该就可以看到主页了,如果使用自己的域名可能要等待一段时间才能看到,因为本地的服务器上可能会有之前DNS的缓存。

当然现在的页面还十分简陋,接下来你就可以自己去定制Octopress了。

简单配置Octopress

主要的配置文件是octopress/_config.yml,里面可以修改博客的基本信息,设置边栏以及配置插件。具体配置方法戳这里

下面几个链接摘自Hujiawei Bujidao大神的博客,十分有用
关于如何修改主题和默认的样式
Octopress支持的第三方主题下载和预览网站
关于侧边栏和主题的定制,添加新浪微博,多说评论,分类标签云等等

发布文章

折腾完后,以后只要发布文章就可以了。Octopress的文章发布是相当容易的,只要在本地编辑并可以开着rake preview即时预览,写完后提交到github就可以了。

官方文档中详细介绍了如何发布新文章戳这里

首先使用命令rake new_post['post_title']生成一篇新文章,生成的文章在source/_posts下,以日期加文章名命名。
以我这篇文章为例,打开后内容如下,各个字段的意思显而易见,只要注意如果属于多个分类的话categories中要使用[CSS3, Sass, Media Queries]这样的格式。
在—后使用markdown语法来编写文章。

1
2
3
4
5
6
7
---
layout: post
title: "开启OctoPress之旅"
date: 2013-11-19 13:24:21 +0800
comments: true
categories: octopress
---

最后发布即可

1
2
rake generate
rake deploy

OVER

好了,就到这里了,这几天有空的时候会继续折腾我的Octopress Blog,让它更加完善。

最后,再次感谢Hujiawei Bujidao大神的吐血推荐~

文章目录
  1. 1. 安装流程
    1. 1.1. 0.准备工作
    2. 1.2. 1.安装octapress
    3. 1.3. 2.发布到github
    4. 1.4. 3.自定义域名
    5. 1.5. 4.大功告成
  2. 2. 简单配置Octopress
  3. 3. 发布文章
  4. 4. OVER