1. git环境搭建

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
    

    运行后安装完成

  • 安装必要的插件
    1. jekyll-paginate用于实现分页功能。一个博客不可能只有几篇文章,如果所有文章全部放在一个页面中,在文章不多的情况下也许较为直观,一旦文章数量增加,不仅加大了用户需要加载的数据量,也为用户检索文章造成了障碍,所以基本上每个博客都会有文章的分页。
    2. bundler
      gem install bundler
      gem install jekyll-paginate
      
  • 生成原始网页结构
    jekyll new myblog
    

    一定要在管理员权限下运行!,否则bundler无法运行,会一直卡住

配置主题

两种下载方法

  1. 一种在作者推荐的github模板库中直接fork,然后会生成自己的分支,把分支克隆到本地即是模版文件;
  2. 将配置命令添加到Gemfile中,执行 bundle install 模版文件会默认安装到 C:\Ruby23-x64\lib\ruby\gems\2.3.0\gems 文件夹下 ** jekyll主题模板大全 http://jekyllthemes.org/ **
  3. 下载完成后,把模板文件复制到username.github.io文件夹下即完成安装。

修改主题参数

1. 基本知识

修改jekyll的主题需要一些基本的网络编程知识:

  • 网页基本结构:side bar侧边栏,nav bar导航栏(如主页,关于),header主页 文字大小h1最大,h6最小。
  • html和css语言
  • Front Matter是文件最上方以 — 分隔的区域。 用于指定个别文件的布局及其他一些变量。设置好变量以后,你就可以在当前页面或者你的页面依赖的_layouts或者_includes里的文件通过Liquid 标记,比如{page.title}访问了。

    2. jekyll 目录结构

    1. 一个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 给搜索引擎看的,如何爬取这个站
  1. 其中,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/#添加来必力评论