Github上搭建博客

日期：2021-10-06 栏目：程序人生浏览：次

本文将详细介绍如何在Windows系统下搭建博客，并发布到GitHub Pages上，以及后期博客发布后的更新工作....

一、博客整体效果

搭建博客效果：（绑定域名后的效果，未绑定则调转到sunfanwu.github.com）

网站成本：域名注册 50元（可不要）

服务器：免费托管在GitHub个人主页上（无数据库，但有整个网站备份。由于GitHub网站性质，博客源码文档为所有人可见）。

博客类型：静态博客，无数据库，博客通过html编写。

本地软件：msysgit、ruby、DevKit、python。

备注：GitHub为开源项目网站，请不要上传过大的且无意义的附件（如视频等）。

二、搭建本地环境

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

安装Git，下载msysgit，安装可参考官方文档。（Git分布式版本管理系统，在此主要是用来操作GitHub。不推荐使用Git 客户端—github for windows）

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

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

path

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

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

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

本地环境配置结束。

三、更新本地环境配置

为了支持中文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
gem sources -r
gem sources -l

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

四、下载并配置Octopress

首先下载Octopress源码，可以使用下面git命令（具体应用可参见git官方文档）下载，也可直接在Octopress Github库中下载octopress的zip包（点击下载），然后将下载的压缩包解压到E盘根目录，修改解压后的文件夹名称为 octopress。

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

然后更新 Octopress 的gem更新源：进到 E:octopress 目录，用文本编辑器（例如记事本）打开文件Gemfile，将里面source “”改为source “”。

最后安装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，需先注册账户），如下图：