七七事件前一天，我有幸加入了本校OJ2.0项目组。非常高兴能够为我们学校自己的OJ开源项目做出一份贡献，虽然只是一份整理Wiki的小活儿，但是这是我第一次真正的参与一个源项目。经过谨慎考虑之后，我决定项目的Wiki使用Github Pages来构建。
为什么是Github Pages？
- 免费，无限流量
- 享受git的版本管理功能，不用担心文章遗失。
- 你只要用自己喜欢的编辑器写文章就可以了，其他事情一概不用操心，都由github处理。 以上引用自阮一峰先生的相关博文
- 同Github Wiki一样支持多人协作，但是更加便于查阅，特别是在涉及主题繁杂的时候。
- 比Github Wiki拥有更大的控制权限，避免Wiki被错误操作。
前期准备
Hexo的安装与配置
Windows环境下
32位地址:http://nodejs.org/dist/v0.10.29/node-v0.10.29-x86.msi 64位地址:http://nodejs.org/dist/v0.10.29/x64/node-v0.10.29-x64.msi
Mac OS环境下
安装包地址:http://nodejs.org/dist/v0.10.29/node-v0.10.29.pkg
Linux环境下
建议使用nvm来管理nodejs环境
- 打开终端，输入
wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh - 重启终端之后,输入
nvm ls，则会列出所有的可用版本 - 输入
nvm install 0.10.29（此处以最新版为例） - 下面配置nodejs的环境，分别输入
nvm use 0.10.29以及nvm alias default 0.10.29
Git的安装与配置
Windows环境下
不妨使用Github For Windows， 通过添加命令行参数启动环境，无须配置PATH，完全绿色化。（TODO：有待补充）
Mac OS环境下
同理，使用Github For Mac即可。
Linux环境下
Ubuntu, Debian：sudo apt-get install git-core
Fedora, Red Hat, CentOS：sudo yum install git-core
开启SSH，避免重复输入帐号密码
可以参考此处。
Wiki配置
感谢wzpan开源的主题，其实还是我主动索要的- -，幸好他非常热情地提供了帮助，在此表示衷心的感谢。 致谢完毕，下面转入配置的细节。
- 在github上建立一个新的仓库，名为
yourname.github.io - 事先建立好准备存放wiki的文件夹，然后在当前目录下打开终端（或者不停地cd进入），然后输入
hexo init，初始化。 - 然后输入
npm install，自动下载相关的依赖包，此时一个最基本的框架已经构建完毕了。 - 然后输入
git clone https://github.com/wzpan/hexo-theme-wixo.git themes/wixo，下载wiki用的主题。 - 然后修改
_config.yml中的theme条目为wixo，注意theme后有一个空格。
补充一下关于deploy的设置
同样是在_config.yml文件夹中，修改deploy的部分为
deploy:
type: github
repo: repository url //使用之前创建的那个库，建议使用SSH
branch: branch //Hexo会自动识别个人wiki还是项目wiki
---
title: your title //这将会是wiki文档的标题
date: 2014-03-16 10:17:16 //构建时间，wiki中用不到
categories: Docs //这将会是本文档所属的类别
toc: true //默认开启，生成table of contents
--- //不可省略，敲回车后，下面的内容就自由发挥了～
协作注意事项
项目创建者
按照上述设置，wiki默认保存在yourname.github.io的master分支下。建议另外开启一个source分支，用来将整个wiki文件夹上传，方便多地编辑以及同步协作。
一开始可能会发现wiki文件夹不能使用git管理，这是因为主题wixo是使用git管理的。所以在上传wiki文件夹之前，要删除位于wixo文件夹下的.git文件夹。
项目参与者
让项目创建者在项目的settings中的Collaborators栏目中输入自己的用户名，即可获得对这个项目的控制权。
环境配置完毕后，forksource分支，即可开始编辑工作。根据.gitignore文件的不同，可能还需要进行npm install以解决依赖问题。
更新日志
- 2014年07月07日 完成
前言和为什么板块 - 2014年07月24日 完成
前期准备和Wiki配置以及注意事项版块，接下来完成免PATH配置的详细步骤以及SSH的配置。此外发现步骤有些混杂不清，下一个版本中将进行修正。 - 2015年04月01日 添加了SSH配置。