1. git环境搭建
- 参考2017-10-11-Github和网络编程基础
 - 确保git环境配置完成,已经生成username.github.io文件夹
 
2. Ruby环境搭建
使用管理员权限打开cmd,在cmd中运行下列命令!
- 与amwiki和hexo依赖node不同,jekyll依赖ruby语言进行编译。
 - 先安装ruby 下载地址 https://rubyinstaller.org/downloads/, 下载安装程序,使用默认配置安装。
 - 安装完ruby,之后就是要安装RubyGems,gem是一个ruby的包管理系统,可以用gem很方便的在本地安装ruby应用。安装方法
    
//在RubyGems官网上下载压缩包,解压到你的本地任意位置 //在Terminal中 cd yourpath to RubyGems //你解压的位置 ruby setup.rb 
3. jekyll安装和配置
安装
使用管理员权限打开cmd,在cmd中运行下列命令!
- 确保git和ruby环境搭建完成。
 - 在username.github.io文件夹下,输入下列命令
    
gem install jekyll运行后安装完成
 - 安装必要的插件
    
- jekyll-paginate用于实现分页功能。一个博客不可能只有几篇文章,如果所有文章全部放在一个页面中,在文章不多的情况下也许较为直观,一旦文章数量增加,不仅加大了用户需要加载的数据量,也为用户检索文章造成了障碍,所以基本上每个博客都会有文章的分页。
 - bundler
        
gem install bundler gem install jekyll-paginate 
 - 生成原始网页结构
    
jekyll new myblog一定要在管理员权限下运行!,否则bundler无法运行,会一直卡住
 
配置主题
两种下载方法
- 一种在作者推荐的github模板库中直接fork,然后会生成自己的分支,把分支克隆到本地即是模版文件;
 - 将配置命令添加到Gemfile中,执行
bundle install模版文件会默认安装到 C:\Ruby23-x64\lib\ruby\gems\2.3.0\gems 文件夹下 ** jekyll主题模板大全 http://jekyllthemes.org/ ** - 下载完成后,把模板文件复制到username.github.io文件夹下即完成安装。
 
修改主题参数
1. 基本知识
修改jekyll的主题需要一些基本的网络编程知识:
- 网页基本结构:side bar侧边栏,nav bar导航栏(如主页,关于),header主页 文字大小h1最大,h6最小。
 - html和css语言
 - Front Matter是文件最上方以 — 分隔的区域。 用于指定个别文件的布局及其他一些变量。设置好变量以后,你就可以在当前页面或者你的页面依赖的_layouts或者_includes里的文件通过Liquid 标记,比如{page.title}访问了。
    
2. jekyll 目录结构
- 
        
一个jekyll文件夹包含以下子目录
- _posts #下的符合YYYY-MM-DD-xxxxxx.md的文件(通过permalink变量设置格式),只要有yaml front matter,它们就会被转换为html格式的静态页面。
 - _drafts #文章草稿,不会发布显示出来。
 - _includes #可以在模板中随时包含的文件
 - _layouts #布局文件,在博客头配置中可以选择 布局文件是整个主题最重要的文件,这些文件告诉Jekyll如何去形成一个html页面。
 - pages 站内固定的页面
 - public 公共资源,包括js,css,img等,还有我博客中调用的图片,我都放这里
 - index.html 站点的首页,整个站的入口文件
 - sitemap.txt 给搜索引擎看的,如何爬取这个站
 
 
 - 
        
 
- 其中,layouts文件夹最重要,用于指定每一类网页文件的布局格式,一般有以下几种模版:
    
- default.html — The base layout that lays the foundation for subsequent layouts.
 - home.html (主页)— The layout for your landing-page / home-page / index-page.
 - page.html (非文章文字页面)— The layout for your documents that contain FrontMatter, but are not posts.
 - post.html (博客文章)— The layout for your posts.
 
 
3. 修改_config.yml。
- 许多配置需要设置自定义变量(custome variable)来实现 。
 
4.添加第三方评论插件
  * 评论我们可以用Disqus或来必力。前者使用广泛,但是国内不翻墙无法访问,后者可以访问,但应用较少。国内的好像都很不稳定,动不动就倒闭,不推荐。
  * 具体步骤: 到Disqus或来必力注册一个账号,选择添加评论区域到自己的网页,你将会的得到一段安装代码
  * 根据不同的主题,把代码添加到comment.html中。
4. 写作工作流
**在git中进行操作,区分上面安装和配置是在cmd中进行*
- 所有的文章直接放在_posts文件夹下面
 - 格式就是我们之前提到的markdown文件,默认的格式是.md或.markdown文件。
 - 每篇文章的开始处需要使用yml格式来注明这篇文章的布局和信息,格式如下:
``` layout: post title: author: comments: true date: 2015-04-28 17:42:32+00:00 categories:- Works
 - Tech tags:
 - bootstrap
 - javascript
 - php
 - AngularJS ```
 
 - 文章的layout为post,让jekyll知道你这是一篇post。
 - date必须按照yml的语法来写,否则就会出现编译错误。可以只用YYYY-MM-DD来显示日期,也可以在后面加上 HH:MM:SS+00:00 来表示更具体的时间。
 
参考资料
- 官翻:http://blog.csdn.net/maoxunxing/article/details/40479753
 - 使用jekyll搭建博客 http://cn.yizeng.me/2013/05/10/setup-jekyll-on-windows/ https://www.zhihu.com/question/30018945?sort=created http://www.jianshu.com/p/c4f145fdd637
 - 添加来必力评论系统 https://showcc.github.io/2017/05/28/Hexo-spfk-LiveRe/#添加来必力评论