关于Octopress的配置教程已经有很多了,我也参考了不少,实际上,最好的Documentation就是官方的Octopress Documentation是最靠谱的,但作者是假设你已经安装好Git及Ruby环境的前提下。我习惯性先搜了一下中文的配置教程,由于不同人的理解及系统环境不一样,还是有些弯路,现在总结一下从零开始配置Octopress的方法。
什么是从零开始?我的系统是Fedora 17,从零开始即从装好系统的那一刻起。
安装Ruby环境
Ruby环境的配置主要是参考ruby-china上的方法,ruby-china上面提供了较详细的unbuntu版本的配置方法,似乎有些过时,但仍比较有参考价值,如何快速正确的安装 Ruby, Rails 运行环境.
对于Fedora17,由于其软件包跟unbuntu命名不一致,如果对linux不够熟悉的话,只能自己揣摩其对应的软件包,我这样配置的。
步骤0 - 安装系统需要的包
" 所有的操作都在root权限下
" 安装开发基本组件
$yum group install Development Tools
" 根据ruby-china wiki 上面unbuntu的配置,一次进行配置:
" 由于Fedora上面很多软件包的叫法都不太一样,所以根据每一个的作用推测Fedora上面的相应软件包
$yum install openssl
$yum install curl libcurl libcurl-devel
$yum install readline readline-devel
$yum install git " 提示已安装
$yum install zlib zlib-devel " 提示已安装
$yum install libyaml-devel libxml2-devel libxslt-devel
$yum install autoconf automake libtool " 提示已安装
$yum install ImageMagick ImageMagick-devel
$yum install pcre-devel sqlite-devel ruby-mysql
$yum install mysql
$yum install libffi-devel openssl-devel
以上是ruby环境可能会依赖的一些库,以及开发头文件
其次,你系统用 yum group install Development Tools的话,会自动装上ruby 1.9.3(对于Fedora 17)而言,为了防止其他意外,最好先卸载这一步安装的ruby,因为后面是安装rvm对ruby进行管理,如果系统已经安装了的话,将会导致在终端中输入ruby时,不知道是rvm的ruby还是系统的ruby,当然可以用which ruby来查看,但毕竟不方便管理。
$yum remove ruby " 卸载非RVM安装的ruby
步骤1 - 安装RVM
为什么安装RVM?ruby-china上面有一句话:
RVM 是干什么的这里就不解释了,后面你将会慢慢搞明白
其实RVM是ruby的版本管理器,从C/C++/Java等转过来的就有些不解(包括我自己),为什么语言需要版本管理器?实际上是因为这门语言不够成熟,或者是这门语言觉得有很多空间改进,以至于会有很多版本,而且最重要的,版本间未必兼容,所以需要相应的版本管理器来进行语言版本控制。
关于RVM的命令,其实不需要了解很多,会基本就够用了。
$curl -L https://get.rvm.io | bash -s stable
等待一段时间后就可以成功安装好 RVM。
$source ~/.rvm/scripts/rvm
检查一下是否安装正确
$rvm -v
rvm 1.19.6 (stable) by Wayne E. Seguin wayneeseguin@gmail.com, Michal Papis mpapis@gmail.com [https://rvm.io/]
步骤2 - 用RVM安装Ruby环境
可以用以下命令查看当前RVM支持的ruby:
$rvm list known
用RVM安装1.9.3(以目前来看,似乎1.9.3最主流)
$rvm install 1.9.3
等待漫长的下载,编译过程,完成以后,Ruby, Ruby Gems 就安装好了。
步骤3 - 设置Ruby版本
RVM 装好以后,需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
$rvm 1.9.3 --default
查看安装是否正确
$ruby -v
ruby 1.9.3p392 (2013-02-22 revision 39386) [i686-linux]
" 将gem源修改
$gem source -r https://rubygems.org/
$gem source -a http://ruby.taobao.org
配置Git 及 GitHub
默认情况下,系统都是已经安装好Git了,可以通过以下命令查看
$ git --version
git version 1.7.11.7
然后可以看以下Set Up Git来进行设置
$git config --global user.name "Your Name Here"
$git config --global user.email "your_email@example.com"
通过下面命令查看是否设置成功:
$ git config --list
user.name=Xiangli Liao
user.email=liaoxl2012@gmail.com
其次比较重要的,就是生成连接GitHub的SSH Keys,具体设置请见Generating SSH Keys
" 3个Step
1, 查看有无ssh目录
$ cd ~/.ssh "如果有可以直接跳到3
2, 生成一个新的SSH key
$ ssh-keygen -t rsa -C "your_email@example.com"
3, 添加SSH key 到GitHub
$ yum install xclip " 一个拷贝工具
$ xclip -sel clip < ~/.ssh/id_rsa.pub
接下来在GitHub上面操作,具体请见GitHub页面Generating SSH Keys:
- Go to your Account Settings
- Click “SSH Keys” in the left sidebar
- Click “Add SSH key”
- Paste your key into the “Key” field
- Click “Add key”
- Confirm the action by entering your GitHub password
配置Octopress + GitHub
在github上面新建一个Repo,假设你的github用户名为 username, 则你的Repo名应该为 username.github.com。举个例子,我的用户名是liaoxl,repo就是liaoxl.github.com
根据官方文档,进行以下命令行操作:
$ git clone git://github.com/imathis/octopress.git octopress $ cd octopress " If you use RVM, You'll be asked if you trust the .rvmrc file (say yes). $ ruby --version # Should report Ruby 1.9.3 $ $ gem install bundler $ bundle install $ rake install
在本地装好之后,需要在GitHub上面进行部署,具体参见官方文档Deploying to Github Pages中的With Github User/Organization pages:
$ rake setup_github_pages
$ rake generate
$ rake deploy
$ git add .
$ git commit -m 'your message'
$ git push origin source
至此,Octopress博客的环境已经搭建好了,有了这个平台就可以很好的写博客了,Blogging Basics给你指出了如何用Octopress进行写博客。
此外Octopress支持很多第三方插件及自定义主题,其中自定义主题可以参照Octopress的GitHub wiki来做,3rd Party Octopress Themes
另外很多与Octopress相关的资源都在Octopress wiki上面罗列出来了,使用感觉还是挺好的。