关于本文
初用octopress,感觉很适合我。不许要操心管理网站的问题,也不会受到广告等等的烦恼。关于octopress的中文资料不多,我就尝 试尝试把octopress的文档整理翻译一下。本文并非是文档的正式翻译,只是单纯介绍一下Ubuntu上使用octopress+github建立个 人博客的基本流程,部分内容为方便就直接翻译了原文。如果有误,欢迎指正。
我的操作系统是Ubuntu 12.10,octopress版本是2.0
关于github
github是一个全球性的代码托管平台,支持github Pages服务。这个服务可以为个人、组织或项目建立静态主页。github为用户提供项目托管、git、pages等用于项目开发的功能。我们使用的就 是其pages服务。相对于其他提供免费博客的网站,github的最大优点是无任何广告且提供git版本管理工具对博客进行管理。但劣势是需要一定的命 令行操作,对于普通用户有一定门槛。也因此,octopress+github被成为最适合hack的建博方式。
Step 1 注册github
打开github.com,输入用户名、邮箱、密码,然后点sign up for free即可注册完成。
Step 2 安装octopress
(1)安装git和ruby
在终端中执行:
sudo apt-get install git ruby ruby-dev
(2)准备octopress
执行
git clone git://github.com/imathis/octopress.git octopress cd octopress # 如果你使用RVM, 你会被询问你是否信任 .rvmrc 文件 (选择 yes). ruby --version # 这条命令应该输出 Ruby 1.9.3
然后安装依赖
gem install bundler rbenv rehash # 如果你使用 rbenv, 执行 rehash 以运行 bundle 命令 bundle install
最后安装默认主题
rake install
Step 3 部署到github上
(1)建立一个新的github项目
点击【Create a New Repository】,然后以 用户名/用户名.github.io 的格式建立一个新项目。
(2)部署
首先运行
rake setup_github_pages
这条命令会询问你刚才建立的项目的地址,按提示输入,然后就会生成一些用于部署的文件。 接着执行
rake generate rake deploy
这两条命令会生成博客内容,然后添加到git中,自动执行git commit然后推送到主分支(master branch)。几分钟后,你会收到github通知你你的提交已经被接受并发布了你的网站的email。
不要忘记把为你的博客提交source(Don’t forget to commit the source for your blog)
git add . git commit -m 'your message' git push origin source
Step 4 发布博客
你发布的文章被放在source/_posts目录下,并按照Jekyll的命名规则命名:YYYY-MM-DD-post- title.markdown。这个名字会被用于生成url且日期会被用于为文章按时间排序。 但这样比较麻烦,于是Octopress提供了一个rake task来自动按照正确的命名规则建立博文,并生成基本内容。
格式是: ``` rake new_post["title"] ```
官网给出这样的样例:
rake new_post["Zombie Ninjas Attack: A survivor's retrospective"] # 这条命令会创建 source/_posts/2011-07-03-zombie-ninjas-attack-a-survivors-retrospective.markdown文件
会生成如下内容的文件:
--- layout: post title: "Zombie Ninjas Attack: A survivor's retrospective" date: 2011-07-03 5:59 comments: true external-url: categories: ---
你可以在这里设置评论功能开关,设置分类。如果你的博客有多个作者共用,你可以在文件中添加【author:Your Name】。如果你在编辑一个草稿,你可以添加【published: false】以使其在生成博客内容时被自动忽略。
Step 5 生成 & 预览
rake generate # 在公开目录中生成博文和页面 rake watch # 查看 source/ and sass/ 的改动 rake preview # 在浏览器中输入 http://localhost:4000 即可预览。
Step 6 推送到github
git add . git commit -m 'your message' git push origin source 然后过几分钟,github就会自动更新你的博客了。
注意:执行rake deploy前一定要先rake generate一下
来源: http://fzyz999.github.io/blog/2013/04/10/ubuntushang-shi-yong-octopressjian-li-bo-ke/