2015-01-03 11:00#
做为一个程序员，有时候需要记录一些解决问题的过程或一些想法，或者是新东西的学习，博客是个很好的解决方案。又可以分享帮助他人。但是又想做的个性一点，考察了下，最后选择了使用github pages来搭架。
github pages的特点：
-
免费，可靠
-
如果你经常使用github，可以提供很多便利
-
很好的支持Markdown，可以使用大量的主题
-
灵活的配置
搭架过程：
1.申请一个github账号
此过程比较简单，不再赘述。账号申请完成之后就可使用github pages了
2.在github中创建一个Repository
此步也比较简单
3.将创建好的Repository克隆到本地
git clone xxxxxxxxxxx.git(创建的Repository的地址)
4.创建gh-pages分支
github pages规定，只有该分支的的页面，才会生成网页文件
git checkout --orphan gh-pages
以后的所有操作都在该分支下完成，请勿切换分支。
5.安装Jekyll
Jekyll是一个静态站点生成工具，它可以根据源码生成静态HTML页面。jekyll提供了模板，配置，变量，插件等功能。
安装jekyll,首先要安装ruby。安装ruby请参考官网https://www.ruby-lang.org/en/downloads/
并确保ruby的版本在2.0.0之上。
查看ruby版本：
ruby --version
安装Bundler，Bundler是一个ruby项目管理工具，可以安装编译Ruby项目依赖的第三方工具或类库
gem install bundler
使用bundler安装Jekyll，要安装Jekyll首先要在项目文件夹中添加一个配置文件（Gemfile），用来声明用到的插件。文本内容：
source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins
然后安装Jekyll
bundle install
6.配置项目
Jekyll安装完成之后，项目中会自动生成一些文件和文件夹。主要的有
|--- _config.yml 项目配置文件
|--- _layouts 通用布局文件，包含各个页面的默认布局
|--- _includes 模板文件夹，包含默认的页面头部，底部和导航栏等的样式
|--- _posts 用来存放博客文章的文件夹
_config.yml，用来配置站点的名称，url,作者信息，页面变量，markdown解析等，不同主题的配置不一样。以选择的主题配置为准。
-
基本配置
baseurl: 博客的路径，可以配置为申请的域名
markdown配置，例如：
highlighter: rouge
markdown: redcarpet
kramdown:
nput: GFM
其中redcarpet是一个markdown文件解析引擎，它可以把_posts下的.md文件解析为静态HTML页面。具体的安装和配置参考：
https://jekyllrb.com/docs/configuration/
* 添加文章：
将写好的文章（Markdown文件或HTML文件）放到 _posts文件下，github pages会自动解析，添加到页面中。文章名名称的格式是固定。按照”yyyy-MM-dd-文章名称“的格式命名，Jekyll会自动按照日期排序添加文章。
* 头部定义：
按照Jekyll模板的定义，每个模板都要在头部定义一些变量，例如：
```javascript
---
layout: post # 指定使用的模板文件，“_layout” 目录下的模板文件名决定变量名
title: title # 文章的标题
date: date # 覆盖文章名中的日期
category: blog # 文章的类别
description: description
published: true # default true 设置 “false” 后，文章不会显示
permalink: /:categories/:year/:month/:day/:title.html # 覆盖全局变量设定的文章发布格式
---
格式以 ---开始和结束，不同的主题可以配置不同的变量
- 变量
在文章中可以使用声明的变量，官方说明：http://jekyllrb.com/docs/variables/
使用格式，如使用标题：
{{ page.title }} //{\\{ page.title }\\},其中的\\为转义符，使用时请去除
7.预览
项目配置完成之后，可以在本地启动服务器进行预览。
编译并运行项目：
bundle exec jekyll serve
运行该命令之后，Jekyll会编译整个项目，在项目文件中生成_site文件夹，里面就是根据配置生成的站点。
在浏览器器中打开 http://localhost:4000 就可以看到站点和生成的文章。
8.使用主题
Jekyll支持模板，所以可以配置页面的主题，github上有大量的Jekyll主题。
这里推荐一个Jekyll主题网站：
http://jekyllthemes.org/
里面有海量的Jekyll主题，都是在github上开源的，可以直接使用，也可以自己再次修改自定义。
每个主题基本都有主题的配置方法说明，比较简单和方便。
9.更新配置和文章到github pages
- 使用bundler
bundle update github-pages
或者
bundle update
- 使用git
git add . //添加所有文件到版本索引
git push origin github-pages //同步文件到远程仓库
同步完成之后稍等一会，在浏览器中打开https://(github用户名).github.io/(Repository名称)就可看到刚刚搭建的博客了
网友评论