Simple Coding, Better Life

搭建基于octopress的GitHub博客

| Comments

一直对GitHubmarkdown语法快速成文的写作方式很感兴趣,这种方式入门略有门槛,但是习惯了写作效率会很高。项目稍微闲了下来,抽点空在GitHub上搭个基于octopress的博客空间,以后一些开发上的心得会在这里分享。

这篇博客先记录一下搭建GitHub博客的流程。

配置GitHub账号:

首先你当然需要一个GitHub的账号,如果你没有,先去申请一个。

需要在本地生成一个密钥,然后上传到GitHub。

首先在终端中输入

[[ -f ~/.ssh/id_rsa.pub ]] || ssh-keygen -t rsa

生成密钥之后,将生成的信息复制下来

[[ -f ~/.ssh/id_rsa.pub ]] && cat ~/.ssh/id_rsa.pub

在浏览器中打开页面 https://github.com/account/ssh,点击“Add another public key” 添加密钥,粘贴之前复制的信息,然后点击“Add Key”即可。这里需要注意的是:Title不需要填写内容。

创建GitHub Pages Repo

如果你的GitHub用户名是username,那个就创建一个名称为”username.github.com”的repo,这个repo就是你的GitHub Pages Repo,更多信息可以参考这里

配置Octopress个人博客

首先你需要Git克隆一个octopress的仓库

git clone git://github.com/imathis/octopress.git octopress
cd octopress

安装相应的gem

bundle update

在此之前,如果你没有安装RVM,请参照octopress官方的指引安装。

生成模版文件

rake install

现在就可以开始分发到GitHub上了。这里要先保证你已经配置好了GitHub账号,以及创建了GitHub Pages Repo

cd octopress
git remote add jackyche git@github.com:jackyche/jackyche.github.com.git

编写测试博客

你可以用以下命令新增博客

rake new_post["new test blog"]

这里”new test blog”是博客的默认标题,它其实干的活是在source/_posts/目录下生成一个名字叫2012-07-07-new-test-blog的markdown模版文件(这里的时间是可变的)。所以你大概可以猜到不能用中文来做new_post的参数了,显示的标题可以在markdown文件里面修改。

你需要稍微了解一下markdown的语法,然后编写完成你的博客,接下来就可以生成静态站点了。

rake generate

然后配置octopress与GitHub的连接

rake setup_github_pages

这里需要输入你的GitHub Pages Repo地址,格式如下

git@github.com:jackyche/jackyche.github.com.git

最后把你的博客分发到GitHub上去

rake deploy

嗯嗯~~现在就可以尝试浏览你的博客了

http://jackyche.github.com

保存写作的markdown源文件

你的写作源当然很重要啊,所以需要创建一个新的GitHub的source分支,来保存你的创作源

git add .
git commit -m "save markdown source"
git push jackyche source

以后每次发布博客的流程

创建好博客系统之后,每次发布博客的流程会比上面快捷很多

创建新文章和新页面

rake new_post["article name"]
rake new_page["page name"]

编辑好博客之后,发布前预览

rake preview

发布到GitHub个人博客

rake generate
rake deploy 

OK,到此为止,一个基于octopress的GitHub博客空间就创建完毕了。

Comments