Octopress的官方网站上有详细文档,可先参考此网站上的相关文档。 配置完后,已安装jekyll。
配置Octopress - windows7 环境
1. 安装msysgit
下载msysgit,当前版本为Git-1.7.8-preview20111206.exe
,
安装在D:\Git-1.7.8,默认安装即可,其他路径也可以,但是路径中不要包含中文和空格,免得自找麻烦。
2. 安装yari
使用刚才的工具下载,输入命令如下:
$ git clone git://github.com/scottmuc/yari.git /d/yari
完成后添加D:\yari\bin
到windoes环境变量PATH
,打开dos,运行命令如下:
D:\yari>yari 1.9.2
3. 安装python2.7.3 - Python 2.7.3 Windows Installer
安装路径:D:\Python27
4. 添加git环境变量PATH
修改文件D:\Git-1.7.8\etc\profile
:
export PATH="/d/Python27:/d/yari/ruby-1.9.2-p290-i386-mingw32/bin:$PATH"
5. 安装gem包
git clone git@github.com:meegoo-tsui/meegoo-tsui.github.com.git
git chehckout source
gem install bundler
bundle install
6. 解决rake generate的错误
错误内容如下:
...
ruby-1.9.2-p290-i386-mingw32/lib/ruby/gems/1.9.1/gems/jekyll-0.11.2/lib
/jekyll/convertible.rb:29:in `read_yaml': invalid byte sequence in GB2312 (ArgumentError)
...
修改D:\yari\ruby-1.9.2-p290-i386-mingw32\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\tags\include.rb
source = File.read(@file)
替换为
source = File.read(@file, :encoding => "utf-8")
修改D:\yari\ruby-1.9.2-p290-i386-mingw32\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\convertible.rb
self.content = File.read(File.join(base, name))
替换为
self.content = File.read(File.join(base, name), :encoding => "utf-8")
7. 测试
git generate
git preview
查看:http://127.0.0.1:4000/
配置Octopress - linux 环境
ubuntu10.04安装rvm
1. 安装ruby依靠包、curl、ruby
sudo apt-get install build-essential openssl libreadline6 libreadline6-dev curl git zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev automake libtool bison subversion
sudo apt-get install ruby
2. 通过下面指令安装rvm
bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer )
3. 查询安装结果
添加如下内容到~/.bashrc
,删除~/.bash_profile
:
[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"
重新进入终端使环境变量生效,然后运行如下命令:
rvm list known
[ruby-]1.9.3-[xxx]
如上所示,显示出可安装的ruby版本,至此rvm的安装完成。
ubuntu10.04安装ruby及依靠包
1. 安装ruby
Octopress
当前使用的ruby
版本为1.9.3
,因此使用如下命令安装ruby
,按提示安装相关软件包:
rvm install 1.9.3
需要重装时:
rvm reinstall 1.9.3
设置环境:
. ~/.rvm/scripts/rvm
rvm use 1.9.3
2. 克隆Octopress
的版本库
Octopress
的版本库托管在github
,使用如下命令checkout
:
git clone git://github.com/imathis/octopress.git octopress
cd octopress # 当使用rvm时,提示是否信任.rvmrc文件,输入yes
ruby --version # 显示 Ruby 1.9.3
3. 安装依靠包
Windows环境安装了RailsInstaller,可直接安装下面内容,
以下命令需要在octopress
路径下执行,版本的锁定需要此路径下的Gemfile
文件:
gem install bundler
bundle install
到此已完成Octopress
环境的配置,可以使用Octopress
的相关命令:
rake install
rake generate
rake preview
查看:http://127.0.0.1:4000/