Top

本地磁盘小日记ヾ(≧▽≦*)ゝ

世界无限大.且行且珍惜w~
编码.计算机视觉.网络.语言.绘图在学/M2F/各种发烧友/死宅/见习公主w;

教程(转):在Win下搭建Octopress博客.

这篇文章将在日后将会被重新整理。

GayHub的链接:https://github.com/octopress/octopress

使用Octopress来搭建博客,还是有一定门槛的,看完本文后,希望您不会觉得很难。

Octopress 是一款基于 Jekyll 的静态站点生成系统,使用Ruby实现,所以您需要懂点Ruby的知识,其实会几个命令就行;

Octopress的博客内容是通过Markdown来书写,所以您需要了解Markdown的编写规则,Markdown 语法说明可以让你在几分钟之内熟悉Markdown的语法,在Windows下可以使用MarkDown Pad或是使用在线的编辑器http://mahua.jser.me/%E8%BF%9B%E8%A1%8C%E7%BC%96%E8%BE%91%EF%BC%9B

Octopress通常会部署在GitHub上,所以您需要会一些简单的Git命令以及Gtihub的使用。

安装前你需要安装:

Git Ruby DevKit和Python。

这是DevKit的下载地址:http://cloud.github.com/downloads/oneclick/rubyinstaller/DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe

安装

安装Git Windows下安装Git很简单,一路next就可以了。

安装Ruby Ruby的安装也是一路next就可以,不过记得勾选“Add Ruby executables to your PATH”,将Ruby的执行路径加入到环境变量中,如果忘记勾选,也可以手动设置。安装完后可以在命令提示符中输入ruby –version 来确认是否安装成功。

安装DevKit DevKit下载下来的是一个自压缩文件,我们将其解压到D:/DevKit,有两点需要注意:

  1. 解压目录中没有有中文和空格;

  2. 必须先安装Ruby,而且Ruby需要是RubyInstallser安装。

解压DevKit后,在命令行输入以下命令来进行安装:

1
2
3
4
d: 
cd DevKit
ruby dk.rb init 
ruby dk.rb install

安装Python 安装Python,也是一路next就可以,博客的代码高亮用到了Python的Pygments模块,在Python中安装第三方库需要使用easy_install,在下面地址下载跟Python相对应的安装程序安装后就可以使用easy_install了。

https://pypi.python.org/pypi/setuptools

easy_install会安装在Python安装目录的Scripts目录中,例如我的Python目录是C:\Python27,所以需要将C:\Python27\Scripts目录加入到环境变量中才能在命令提示符中使用easy_install命令。

在命令提示符中输入如下命令就可以安装Pygments了。

easy_install pygments 安装Octopress 首先在GitBash中输入如下命令将Octopress代码拉到本地,

cd d:/GitProject git clone git://github.com/imathis/octopress.git octopress 然后需要安装Octopress的依赖项,安装依赖项需要用到Ruby的gem,使用下面的命令可以更换gem的更新源,使用国内的淘宝镜像速度相对快点。

gem sources -a http://ruby.taobao.org/ gem sources -r http://rubygems.org/ gem sources -l 修改Octopress目录下的Gemfile文件,将第一行的http://rubygems.org/ 修改为http://ruby.taobao.org/

在命令提示符中进入到Octopress目录,输入下面命令进行依赖项的安装

gem install bundler bundle install 输入下面的命令来安装Octopress的默认主题

rake install 到此所有的安装工作已经结束,输入下面的命令可以在本地进行预览。

rake preview

解决中文问题 如果博客中包含中文,需要进行如下设置:

  1. 在环境变量中设置下面的键值对;

LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8

  1. 含有中文的文件需要保存为UTF-8无BOM格式编码。

  2. 在Ruby的安装路径找到 文件convertible.rb

C:\Ruby193\lib\ruby\gems\1.9.1\gems\jekyll-0.12.0\lib\jekyll\convertible.rb

将27行修改为:self.content = File.read(File.join(base, name), :encoding => ‘utf-8’)

在Octopress中添加文章 使用下面命令可以在Octopress中添加文章

注意,rake new_post[‘my first octopress blog’]中的my first octopress blog 并不是博客标题,而是和生成的文件名以及url地址有关,该名称不支持中文。博客标题可以在生成的markdown文件中修改。生成的markdown文件在octopress/source/_posts目录中。

编辑markdown文件,将标题可以修改为中文标题,还可以设置分类等信息以及编写正文部分

每次执行了添加博客的命令,或是修改了现有博客的内容后,都要执行下面命令进行重新生成

rake generate 如果之前有输入rake preview的命令提示符窗口没关,可以直接localhost:4000来进行预览,否则需要重新执行下rake preview才能进行预览。

搬运自:http://www.cnblogs.com/oec2003/archive/2013/05/27/3100896.html?utm_source=tuicool

更多参考(建议octopress安装部分参照这篇文章):

http://www.open-open.com/lib/view/open1423539522764.html