这些天学着使用Github去搭建个人博客, 纯属娱乐, 下面把步骤和一些注意的地方写下来, 免得忘了.
开发准备
1. 注册Github账号, 例如: TonnyYi
2. 安装git
3. 新建一个仓库, 例如: blog
使用Github Pages搭建
1. 进入你的仓库的admin页面, 例如: https://github.com/tonnyyi/blog/admin
2. 向下滚动找到Github pages选项卡, 点击"Automatic Page Generator"
3. 在新页面底部点击"Continue to Layouts"
4. 在打开的页面选择一个主题, 然后点击"PUBLIS"
现在你的博客已经可以访问了, 路径为: http://tonnyyi.github.com/blog
编辑博客
1. 将仓库clone到本地, 命令行下输入: git clone https://github.com/tonnyyi/blog
2. 编辑博客内容, , 命令行下进入仓库目录: cd blog
3. 将文件更改保存到暂存区: git add .
4. 提交文件修改: git commit -m "提交信息"
5. 将修改push到Github上的仓库: git push
( 这一步git会要求你输入用户名密码, 注意是这个仓库的管理员账户和密码, 如果你不想每次push都输入用户名密码或者想使用别的账号push修改记录, 可以生成一个ssh key然后保存到Github. 具体操作可以参考这里 )
使用jekyll搭建
使用jekyll之前先了解下markdown语法, Liquid标签
1. 安装jekyll(最好的方式是:先安装Ruby, 通过Ruby的第三方程序包:gem安装jekyll)
2. 初始化最简单的博客文件结构(jekyll要求的):
|-- _config.yml
|-- _includes
|-- _layouts
| |-- default.html
| |-- post.html
|-- _posts
| |-- 20011-10-25-open-source-is-good.markdown
| |-- 20011-04-26-hello-world.markdown
|-- _site
|-- index.html
_config.yml : 保存了站点的配置信息, 详细配置在这里, 中文翻译看这里.
_includes : 该目录存放可以与_layouts和_posts混合,匹配并重用的文件. Liquid标签{% include file.ext %}可以用于嵌入文件_includes/file.ext.
_layout : 该目录存放用来插入帖子的网页布局模板, 注意是模板, 具体数据在_posts中.
_posts : 发表的博文的内容, 其下文件的命名格式为: YEAR-MONTH-DAY-title.md(使用markdown语法写的文件), 另外还支持textile和html文件.
_site : 这里是Jekyll用以存放最终生成站点的根路径位置, 编译好的html文件都放在这里, 最好把这个目录加到 .gitignore 列表中.
index.html : 博客的首页
3. 本地查看效果: jekyll --server (更多命令参考这里), 然后访问: http://localhost:4000
4. 保存修改, 提交修改, push到Github
从上面可以看到, 有很多文件需要自己手动去写, 有没有简单点的方式? 当然!
使用Jekyll-Bootstrap搭建(推荐)
这里是其主页, 上面介绍了如何使用Jekyll-Bootstrap, 很简单.
1. 在Github上新建一个仓库, 注意仓库名称的格式: USERNAME.github.com, 例如: tonnyyi.github.com
2. clone到本地: git clone https://github.com/plusjade/jekyll-bootstrap.git tonnyyi.github.com
3. 进入目录: cd tonnyyi.github.com
4. 修改远程仓库地址到自己的仓库, 从而可以push到自己的仓库: git remote set-url origin git@github.com:tonnyyi/tonnyyi.github.com.git
5. 推送到Github上自己的仓库: git push origin master (注意这里是master分支, 不是之前Github Pages的gh-pages分支)
6. 访问http://tonnyyi.github.com, 你的博客已经搭好了.
[Tips]
1. Jekyll默认的markdown解析器是 Maruku, 但据说对中文支持不太好, 所以建议安装 RDiscount: gem install rdiscount (Ruby安装好以后), 然后在_config.yml文件中 "auto: true" 后添加一行 "markdown: rdiscount"
2. 如果你希望在页面使用源码高亮, 你可以安装Pygments : easy_install Pygments
[参考博客]