基于 Octopress 和 GitHub 的个人博客搭建——安装

2014-09-23

Octopress 是基于 jeklly 的开源博客引擎,静态界面 + Markdown + Git + 不需要服务器,搭建于 GitHub Pages 托管,配置还是十分简单的。暑假的时候看到有人写过 Blog,也尝试了一下,遇到了各种各样问题。由于没有学过 Ruby,在添加各种插件的尝试中也是有各种问题,前后重复了不下二三十次,暑假的时候安装好了一次,也调整好了主题 CSS,上上周上课的时候也不知道改动了什么文件,就给彻底搞坏了,花了好久才修好 Orz。这过程中还顺带学了 Git,Terminal 和 Vim 都是十分酷的东西,把步骤整理一下备忘。

0. Git 和 Ruby 环境

这两个可以用 Homebrew 安装,Homebrew 安装、使用参考Homebrew。安装完成后查看版本:

1
2
git —version
ruby --version

1. Octopress git clone 到本地

进入主目录 octopress 文件夹下安装相关依赖项及 Ruby 相关问题:

1
2
3
4
5
git clone git://github.com/imathis/octopress.git octopress
cd octopress
gem install bundler
rbenv rehash
bundle install

gem install bundler 如提示权限问题这条命令可能要加上:sudo
rbenv rehash 执行会提示没有这条命令,这个是 Ruby 的环境管理工具,也是通过 Homebrew 安装:brew rbenv
安装完成后检查是否可用:rbenv -v
如还有问题就参考这里:Rbenv的一些使用记录

支线任务完成再次回到主线继续安装依赖项:
bundle install
每当切换 Ruby 版本和执行 bundle install 后都必须执行一次 rbenv rehash

2. 继续安装默认主题或者是安装第三方主题

各种主题参考:3rd Party Octopress Themes

1
rake install    # 安装默认主题

我这里用的是 whitespace 主题:

1
2
3
4
5
git clone git://github.com/lucaslew/whitespace.git .themes/whitespace
rake install["whitespace"]
rake generate # 生成静态界面
rake preview # localhost:4000 端口预览,预览完成 Ctrl+C
rake deploy # 部署

3. 在 GitHub 上进行部署

GitHub 创建一个 repository,名为yourBlogname.github.io

1
rake setup_github_pages    # input your repository's url

然后就是用Git 本地文件上传至GitHub 仓库:

1
2
3
4
git add .    # 工作区全部修改提交至暂存区
git commit -m "first commit" # 添加commit 信息
git push origin source # 提交至source 分支
rake deploy # 部署

到这里结束就已经搭建完成了,但是里面什么东西都没有。 octopress 目录中_config.yml 是配置文件,里面保存这配置信息,博客名称,第三方组件设置信息,这个就留着第二篇在写吧。

还有就是建立电脑 SSH Key 链接到 GitHub 的问题,很容易,直接看 GitHub 的英文说明都能看得懂:Generating SSH Keys

4. 发布文章

1
rake new_post["title"]    # 生成 source/_post/YYYY-MM-DD-title.markdown 文件

编辑好文章之后从第四步的 git add .,接下来四个命令就完成了文章的发布。

5. 参考链接

当时自己搭建的时候各种问题都遇到了也查了很多其他人 Blog,贴几个连接: