使用GitHub¶
记录使用github的一些经历。
GitHub Pages¶
github pages可以方便的用来建立一个BLOG，默认，也是最常用的是jekyll引擎，jekyll的文件使用Markdown方法，Markdown是一种非常简方便的文本撰写格式，不过Python文档使用sphinx工具对我更有吸引力，因此转用sphinx来写文档，生成HTML文件然后上传至GitHub Pages就可以了。
由于github pages默认使用jekyll引擎，使用sphinx生成的HTML文件会显示不正常，主要是因为无法找到CSS和javascript文件，此时需要告诉github pages：“我不使用jekyll”，只需要在repo中加入一个文件.nojekyll就可以了[1]。
.gitignore¶
在repo的根目录下添加文件.gitignore，然后将当前目录下你不希望加入仓库的文件名，目录名加入其中，这样能减少不必要的烦恼。.gitignore的内容如：
_site/*
_theme_packages/*
Thumbs.db
.DS_Store
!.gitkeep
.rbenv-version
.rvmrc