技术博客利器——Octopress

Octopress简介

Octopress is a framework designed by Brandon Mathis for Jekyll, the blog aware static site generator powering Github Pages.

优点

用文件方式储存数据，无需数据库
以静态方式发布，可直接挂在github等地方
用markdown格式写博客
可以轻松的配置和发布

常用命令

注意

有些机子上运行可能会报错，需要在命令前加上bundle exec

添加文章

$ rake new_post["title"]

运行后会通过title生成相关文件、链接，可在文件里修改显示出来的标题。
title可以使用中文，会自动转化为拼音（个人不建议，因为链接会比较无意义）。

$ rake generate       #发布文件到public目录
$ rake watch          #监控source和sass目录的变动
$ rake preview        #启动服务器并监控变动，通过http://localhost:4000预览

发布

$ rake generate
$ rake deploy

# 或者直接使用一条命令，看名字就知道是怎么回事了
$ rake gen_deploy

保存源代码

因为发布的只是生成的静态页面，
需要在项目里建立source分支用于保存整个项目源代码（配置、markdown文件等）。

$ git add .
$ git commit -m 'blog'
$ git push origin source

更多设置

添加"关于我"

在source下新建about目录，并在里面添加index.markdown文件。
编辑导航条source/_includes/custom/navigation.html
注意:index.markdown文件需要加上头，否则会找不到。

首页只显示摘要

• 在文中加入<!--more-->来控制摘要截取位置
• 修改_config.yml里的excerpt_link控制链接文字

部署到Github

操作步骤参考：Deploying to Github Pages
如果你有自己的域名，可参考：Github Page绑定自己域名

Bug Fix

不能进行deploy(Github)

问题：有次发现$ rake deploy不能发布，但是预览正常。检查github上source分支代码已更新，但master仍为老代码。
原因：发现是因为代码是新从github下clone下来的，未进行初始化deploy。
解决：需要执行$ rake setup_github_pages进行初始化。
注意：rake操作应该在source分支下进行，若是刚从github里clone下来的，请先执行$ git checkout source。

修改的样式preview时不生效

问题：预览时发现之前设置成功的自定义样式不生效，变回默认样式。
解决：$ rake generate即可，会重新生成css。

无法update octopress

每过一段时间，可能需要更新一下Octopress版本，
问题：执行$ git pull octopress master时报错：fatal: 'octopress' does not appear to be a git repository
原因：没有相应远程分支（第一次生成博客的项目中才有？）。打开.git/config查看，应该不包含[remote "octopress"]块。
解决：手动添加，或者在命令行执行：$ git remote add octopress https://github.com/imathis/octopress.git

参考

Octopress官方文档
markdown语法