风行的博客

GitHub Pages + Octopress 搭博客

Github Pages - Websites for you and your projects.
可用来搭建静态网站,提供免费的域名、空间、无限流量,并且在世界各地都有较好的访问速度。不过网站也会轻易被人 clone,如果在意的话可以付费给 GitHub,然后将版本库建成私有的。

Octopress - A blogging framework for hackers.
开源的静态博客系统,可用来为我们的静态网站提供所需的 HTML。


准备工作

  • 需要有 Git 环境,最好为 GitHub 另外维护一个 SSH Key
  • 在 GitHub 上新建名为 yourname.github.io 的版本库,之后可通过 yourname.github.io 域名来访问博客,如果你有自己的域名,可通过配置 Octopress 的 CNAME 文件进行关联
  • 需要有 1.9.3 及以上版本的 ruby 环境。(通过 ruby –version 查看,如需升级可用 rvm 或 rbenv)
  • 更改 ruby 的源,可提高下载速度
1
2
3
gem sources -a https://gems.ruby-china.org/  (添加)
gem sources -r https://rubygems.org/  (删除)
gem sources -l  (检查一下)


Octopress 环境搭建

  • 安装 Octopress
1
git clone git://github.com/imathis/octopress.git octopress
  • clone 完成后 cd octopress,然后安装所需依赖
1
2
3
sudo gem install bundler 
rbenv rehash 
bundle install
  • 安装默认模板
1
rake install
  • 关联 GitHub Pages
1
2
rake setup_github_pages
git@github.com:yourname/yourname.github.io.git
  • 配置 Octopress,建议同时删除 HTML 和 CSS 中用不到的东西,可提高访问速度


写博客并发布

  • 新建文章(博客存储为 markdown 文件,位于 \octopress\source\_posts 目录下)
1
rake new_post["new_blog_title"]
  • 生成静态网站
1
rake generate
1
rake preview
  • 部署并将 Octopress 生成的 HTML 等文件提交到 master 分支
1
rake deploy

如果提交失败,提示让先 pull 文件,但是本地文件已经是最新的,可按下面方式解决:进入 _deploy 目录,执行 git reset –hard origin/master 将本地状态回退到和远程一样,然后回到根目录下重新 generate 并 deploy。

  • 将 Octopress 修改过的 markdown 等资源文件提交到 source 分支
1
2
3
git add .
git commit -m ‘your commit message’
git push origin source


如果更换了电脑或希望多台电脑能够写博客

  • 首先需要下载 source 分支到你的电脑上
1
git clone -b source git@github.com:lijingcheng/lijingcheng.github.io.git
  • 然后进入下载目录
1
cd lijingcheng.github.io
  • 下载 master 分支到 _deploy 目录
1
git clone -b master git@github.com:lijingcheng/lijingcheng.github.io.git _deploy
  • 生成网站并部署
1
2
rake generate
rake deploy