最新消息:蔓草札记的微信公众号开通了,赶紧在微信通讯录公众号中搜索“蔓草札记”关注下吧 :)

在Github上搭建Octopress博客

博客经验 xhhjin 13140浏览 25评论

本文将详细叙述在Windows下如何安装、运行Octopress博客并发布到Github Pages上,然后就可以通过http://username.github.com来访问你的站点了。先看下我发布在Github上的Octopress演示博客:

演示地址:http://xhhjin.github.com

绑定域名:http://github.xuhehuan.com/

因为我已经绑定了域名,所以点击第一个演示地址时会自动跳转到绑定的域名上。

Octopress

安装Octopress博客前需在本机上安装Ruby运行环境和Devkit,另外还要下载Octopress,更改gem的更新源,安装依赖项。本文将针对Github上的Octopress博客搭建进行详细说明。

一、搭建本地环境

为了在Github上使用Octopress,需要首先配置一下本地环境:

首先安装Git,下载msysgit,目前最新版本是 Git-1.7.10-preview20120409.exe ,安装可参考官方文档

然后安装Ruby, Octopress 官方文档中指定的 Ruby 版本是 1.9.2,所以我们选择 Ruby 1.9.2-p290,下载 rubyinstaller-1.9.2-p290.exe,双击安装,安装时记得选中“Add Ruby executables to your PATH”。

为了检查ruby是否已加入到PATH中,可在 Windows 的cmd窗口中执行以下命令:

ruby –version

接着安装Devkit,选择下载 4.5.2 版本:DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe,下载完成后,将其解压到如 E:\DevKit,然后在win的cmd窗口中执行如下命令进行安装:

E:
cd DevKit
ruby dk.rb init
ruby dk.rb install

最后安装python,主要是博客代码加亮模块需要python环境的支持,下载2.7版,安装完以后,在Windows的cmd窗口中执行:

easy_install pygments

本地环境配置结束。

二、更新本地环境配置

为了支持中文UTF-8编码,对Windows环境变量配置如下:

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

也可在直接在Windows的cmd窗口下运行命令

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

更新gem的更新源,ruby的官方更新源经常被河蟹,换成国内的更新源,这样速度就快多了,变更如下:

gem sources -a http://ruby.taobao.org/
gem sources -r http://rubygems.org/
gem sources -l

最后一个命令可查看更该后的更新源列表。

三、下载并配置Octopress

首先下载Octopress源码,可以使用下面git命令下载,也可直接在Octopress Github库中下载octopress的zip包(点击下载),然后将下载的压缩包解压到E盘根目录,修改解压后的文件夹名称为 octopress。

E:
git clone git://github.com/imathis/octopress.git  octopress

然后更新 Octopress 的gem更新源:进到 E:octopress 目录,用文本编辑器(例如记事本)打开文件Gemfile,将里面source “http://rubygems.org/”改为source “http://ruby.taobao.org/”。

最后安装Octopress的依赖项,在Windows的CMD窗口输入以下命令:

E:
cd octopress
gem install bundler
bundle install

四、新建Github Repositories

登录Github,假设你的用户名是username,首先要新建一个命名为 username.github.com 的Repo,命名必须是这个格式,如果不这样命名的话,在运行命令 rake setup_github_pages  之后不能够自动创建后面提到的master和source 分支,而是作为普通仓库生成 gh-pages 分支。

创建Repo,如下图:

在Github上搭建Octopress博客-01

Repo的设置,如下图:

在Github上搭建Octopress博客-02

五、发布Octopress到Github

1、打开Windows下的命令窗口,进入到Octopress所在的目录,输入命令:

rake setup_github_pages

按照提示输入刚才新建的Repo地址,类似:git@github.com:username/username.github.com或git@github.com:username/username.github.com.git。

在Github上搭建Octopress博客-03

2、接着输入命令:

rake install

rake generate

rake preview

其中rake install是安装Octopress默认主题的,rake gnerate是生成静态页面的,这两个命令是必须运行的,而rake preview则是用来本地浏览的(运行时看屏幕上提示,按Ctrl+C并输入Y来终止批处理操作),运行后打开浏览器,输入 http://localhost:4000/ 就可以看到如下的界面了,不想预览的话也可以不运行,直接进入下一步。

在Github上搭建Octopress博客-04

3、将博客发布到Github上,输入下面命令:

rake deploy

这样,生成的内容将会自动发布到master分支,并且可以使用 http://username.github.com 访问内容。

在Github上搭建Octopress博客-05

4、别忘了把所有源文件发布到 source 分支下面:

git add .

git commit -m “your message”

git push origin source

至此,所有发布完成,接下来就是对博客的设置了。

六、Ocotpress博客配置

更改下面的配置后,还需要运行 rake generate、rake deploy等等命令的。

1、默认的博客运行成功的话,就需要按照自己的要求对博客配置进行修改了,主要是修改Octopress根目录下的主配置文件_config.yml。

url:  http://username.github.com                 # 博客地址

title:  蔓草札记                                            # 博客标题
subtitle:  感受生活,感悟工作,感触心灵           # 副标题
author:  xhhjin                                                       # 作者
simple_search:  http://www.google.com.hk/search     # 搜索引擎
description:                                                            # 关于博客的描述
subscribe_rss:  /atom.xml                  # Rss订阅地址, 默认是  /atom.xml
subscribe_email:                               # 提供Email订阅的地址
email:                                              # Rss订阅的Email地址

root:  /               # 博客路径,默认是“/“,如果你打算在子目录中,记得修改这个路径
permalink: /blog/:year/:month/:day/:title/           # 文章的固定链接形式

2、更换主题

主题位于 octopress/.theme 目录下,默认主题为 classic。 如果需要更改主题(可在网上查找),下载后将主题也放在.theme目录下即可,如果主题名字为blog_theme,那么安装主题时输入以下命令即可:

rake install [‘blog_theme’]

七、绑定域名

Github Pages绑定域名的方法有点特殊,需要在Octopress/source目录下建个无后缀的CNAME文本文件,文件内容就是你的域名,例如github.xuhehuan.com,然后修改A纪录到207.97.227.245 ,或者 CNAME 指向 username.github.com,下面就等着解析生效了。

更多内容可参考这里:
(1)Octopress写作及个性设置
(2)打造Octopress博客在线写作平台
(3)Octopress 博客系统 —— A blogging framework for hackers
(4)Octopress官方帮助文档


欢迎转载,转载请注明出处:蔓草札记 » 在Github上搭建Octopress博客

♥ 喜欢 0 赞赏
发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (25)

  1. 终于搞明白了master分支了。 :roll: :roll: :roll:
    免费资源部落4年前 (2012-08-05)回复
  2. 您好,请问你的博客的主题那里下载的。能告诉我吗?
    mario4年前 (2012-12-25)回复
  3. http://localhost:4000/ 我能看到界面 rake deploy后 显示的界面是404
    boia4年前 (2013-03-01)回复
    • @boia 那应该是部署代码不成功,或者是分支建的不对吧?
      xhhjin博主4年前 (2013-03-02)回复
    • @boia ·我也是 发布后立即进入博客结果404了 郁闷了下 再刷新 就出来了 所以它需要一点点时间 hoho~
      Mirrur3年前 (2013-09-25)回复
  4. 文章不错,不过最后有点问题,关于安装主题的命令 rake install['themename'],install 之后不能有空格,要直接跟[],否则安装了主题不会生效
    红色贝鱼4年前 (2013-03-20)回复
  5. 你给的ruby1.9.2 不对,装了之后是1.9.1的,会导致,bundle install 失败,换成ruby 1.9.3之后就好了
    god chun3年前 (2013-07-21)回复
    • @god chun 哦,我当时用的就是上面的版本,可能现在一些东西变了吧。
      xhhjin博主3年前 (2013-07-21)回复
  6. rake deploy出现错误: # Deploying branch to Github Pages ## Pulling any updates from Github Pages cd _deploy ERROR: Repository not found. fatal: Could not read from remote repository. 请问是什么问题?前面的完全按照教程做的啊,多谢了。
    abdong3年前 (2013-07-30)回复
    • @abdong 应该是新建的Github Repositories不对吧,你到github上看下,错误提示是找不到这个。
      xhhjin博主3年前 (2013-07-31)回复
  7. Github Pages deploy complete 这个之后 我访问 username.github.com 还是404 怎么办
    小呆3年前 (2013-08-04)回复
    • @小呆 看看有错误提示没,没错误提示就不大好找原因了,重新按步骤走一下试试。
      xhhjin博主3年前 (2013-08-04)回复
      • @xhhjin 3Q回复,原因是整个deploy太慢,果了一段时间就可以访问了。
        小呆3年前 (2013-08-04)回复
      • @xhhjin 我也是这样,可以在preview中看到,但是deploy之后要等很久才能看到更新,重新做了好几次都不行。求教啊!!
        leon3年前 (2013-09-25)回复
  8. 博主,在哪里登录啊,不登录,没权限啊?
    ux3年前 (2013-09-15)回复
    • @ux 不大明白,要什么权限,登录什么呢?
      xhhjin博主3年前 (2013-09-15)回复
      • @xhhjin 搞定了,要配置个sshkey; 另外,按照本文的步骤,source 里有文件,master 里没有,网站一直404.
        ux3年前 (2013-09-16)回复
  9. 博主你好 很感谢你的文章 给我带来了很大帮助 但哈有问题没有解决 我给你发了电邮 请您回复一下
    tianyongwei3年前 (2013-10-12)回复
  10. good job
    MonaDogg3年前 (2013-11-15)回复
  11. 你好,我想请问一下为什么我rake generate之后public文件夹依旧空的?也就是无法生成新的页面 $ rake generate ## Set the codepage to 65001 for Windows machines ## Generating Site with Jekyll
    kd2年前 (2014-08-12)回复
    • @kd 不清楚什么原因,可能是Ruby配置的有问题,你仔细确认下第一步的操作吧
      xhhjin博主2年前 (2014-08-13)回复
      • @xhhjin 恩,我重来也不行,算了,换其他电脑试试看
        kd2年前 (2014-08-18)回复
  12. identical source/stylesheets/screen.css E:/Ruby/RailsInstaller/Ruby1.9.3/lib/ruby/gems/1.9.1/gems/execjs-2.2.1/lib/execjs /external_runtime.rb:110:in `split': invalid byte sequence in UTF-8 (ArgumentErro r) win8.1报这个错,折腾太大半天了,坑爹的windows
    Jcdroid2年前 (2014-10-03)回复
  13. 你好,我在rake deploy的时候,出现了这个提示,,there is no tracking information for the current branch,please specify which branch you want to merge with ,在cd _deploy 之后出现的,好像是本地的master与远程仓库的master没匹配上,求解。。。。
    bbos19941年前 (2015-11-15)回复