Octopress 是基于 jeklly 的开源博客引擎,静态界面 + Markdown + Git + 不需要服务器,搭建于 GitHub Pages 托管,配置还是十分简单的。暑假的时候看到有人写过 Blog,也尝试了一下,遇到了各种各样问题。由于没有学过 Ruby,在添加各种插件的尝试中也是有各种问题,前后重复了不下二三十次,暑假的时候安装好了一次,也调整好了主题 CSS,上上周上课的时候也不知道改动了什么文件,就给彻底搞坏了,花了好久才修好 Orz。这过程中还顺带学了 Git,Terminal 和 Vim 都是十分酷的东西,把步骤整理一下备忘。
0. Git 和 Ruby 环境
这两个可以用 Homebrew 安装,Homebrew 安装、使用参考Homebrew。安装完成后查看版本:
1 | git —version |
1. Octopress git clone 到本地
进入主目录 octopress 文件夹下安装相关依赖项及 Ruby 相关问题:
1 | git clone git://github.com/imathis/octopress.git octopress |
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 | git clone git://github.com/lucaslew/whitespace.git .themes/whitespace |
3. 在 GitHub 上进行部署
GitHub 创建一个 repository,名为yourBlogname.github.io
。
1 | rake setup_github_pages # input your repository's url |
然后就是用Git 本地文件上传至GitHub 仓库:
1 | git add . # 工作区全部修改提交至暂存区 |
到这里结束就已经搭建完成了,但是里面什么东西都没有。 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,贴几个连接: