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/#添加来必力评论