Mac OS X 下 Octopress + GitHub Pages 发布博客

前言

Octopress 已经比较久不维护, 不建议继续使用. 大家可以考虑使用 Hexo. (2017-05)

优点

• 广泛的使用者及相关文档
• Octopress 整合了丰富的第三方插件
• 内置支持 Gitub、Twitter、Google Plus One、Pinboard、Delicious、Disqus Comments、Google Analytics、Facebook
• 源码版本信息完全自己通过 github 控制，可定制高度个性化的个人博客

官方文档

相关资源

安装及配置

Git 安装

Ruby 安装，版本号要求大于1.9.3

• 通过 rbenv 或者 RVM 安装。

设置 Octopress

• 从 git 复制 Octopress

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

• 下一步，安装依赖

gem install bundler     # 若报权限错误，加 sudo 执行相关命令
rbenv rehash            # If you use rbenv, rehash to be able to run the bundle command
bundle install

• 安装 Octopress 默认主题

rake install    # 由于默认主题名为“classic” 该命令等效于：rake install['classic‘]

• 或者安装第三方主题

cd octopress
git clone GIT_URL .themes/THEME_NAME
rake install['THEME_NAME']
rake generate

• Octopress发布在Github Pages上

rake setup_github_pages   # 该命令将进行一系列的 github 相关配置
rake generate             # This will generate your blog, copy the generated files into _deploy/
rake preview              # 本地预览页面，页面默认发布在 localhost:4000
rake deploy               # dd them to git, commit and push them up to the master branch

• 将 octopress 目录下所有代码提交到 source 分支

git add .
git commit -m '源码提交'
git push origin source

• 自定义域名

echo 'your-domain.com' >> source/CNAME
# 或者
echo 'www.your-domain.com' >> source/CNAME
# 然后，你必须访问你得域名注册商或者 DNS 主机，为你的域名增加一个 record
# 注意最好不要使用顶级域名作为 CNAME，另外，DNS 解析生效需要比较长的时间

• 按规范发布文章，新发布文章的默认扩展名是 markdown，你可以在 Rakefile 文件中更改扩展名

rake new_post["title"]                    # 按规范发布文章，并且为文章自动生成 yaml metadata
rake new_page[super-awesome]              # 创建 /source/super-awesome/index.markdown
rake new_page[super-awesome/page.html]    # 创建 /source/super-awesome/page.html

• 远程更新至本地

git pull octopress master     # Get the latest Octopress
bundle install                # Keep gems updated
rake update_source            # update the template's source
rake update_style             # update the template's style
# rake update命令相当于以上rake update_source和rake update_style 两个命令合并执行(该命令无效？？？)