- 开始
- 组件
- 评论与 Google/Baidu Analytics
- 高级部分
如果你安装了 jekyll，那你只需要在命令行输入jekyll serve 或 jekyll s就能在本地浏览器中输入http://127.0.0.1:4000/预览主题，对主题的修改也能实时展示（需要强刷浏览器）。
你可以通用修改 _config.yml文件来修改博客:
# Site settings
title: KW Blog # 你的博客网站标题
SEOTitle: 寇伟的博客 | KW Blog # SEO 标题
description: "Hello" # 随便说点，描述一下
# SNS settings
github_username: withgakki # 你的github账号
jianshu_username: b48dbe0577c0 # 你的简书ID。
# Build settings
# paginate: 10 # 一页你准备放几篇文章
Jekyll官方网站还有很多的参数可以调，比如设置文章的链接形式...网址在这里：Jekyll - Official Site 中文版的在这里：Jekyll中文.
要发表的文章一般以 Markdown 的格式放在这里_posts/。
yaml 头文件:
---
layout: post
title: SpringCloud
subtitle: SpringCloud与微服务
date: 2019-04-01
author: KW
header-img: img/post-bg-ios9-web.jpg
catalog: true
tags:
- 微服务
- 分布式
---
设置是在 _config.yml文件里面的Sidebar settings。
# Sidebar settings
sidebar: true #添加侧边栏
sidebar-about-description: "简单的描述一下你自己"
sidebar-avatar: /img/avatar-by.jpg #大头贴
侧边栏是响应式布局的，当屏幕尺寸小于992px的时候，侧边栏就会移动到底部。具体请见bootstrap栅格系统 http://v3.bootcss.com/css/
Mini-About-Me 这个模块将在你的头像下面，展示你所有的社交账号。这个也是响应式布局，当屏幕变小时候，会将其移动到页面底部，只不过会稍微有点小变化，具体请看代码。
看到这个网站 Medium 的推荐标签非常的炫酷，所以我将他加了进来。 这个模块现在是独立的，可以呈现在所有页面，包括主页和发表的每一篇文章标题的头上。
# Featured Tags
featured-tags: true
featured-condition-size: 1 # A tag will be featured if the size of it is more than this condition value
唯一需要注意的是featured-condition-size: 如果一个标签的 SIZE，也就是使用该标签的文章数大于上面设定的条件值，这个标签就会在首页上被推荐。
内部有一个条件模板 {% if tag[1].size > {{site.featured-condition-size}} %} 是用来做筛选过滤的.
在下面输入的社交账号，没有的添加的不会显示在侧边框中。新加入了简书链接, http://www.jianshu.com/u/e71990ada2fd
# SNS settings
RSS: false
jianshu_username: jianshu_id
zhihu_username: username
facebook_username: username
github_username: username
# weibo_username: username
好友链接部分。这会在全部页面显示。
设置是在 _config.yml文件里面的Friends那块，自己加吧。
# Friends
friends: [
{
title: "KW Blog",
href: "https://withgakki.github.io/"
}
]
HTML5幻灯片的排版：
这部分是用于占用html格式的幻灯片的，一般用到的是 Reveal.js, Impress.js, Slides, Prezi 等等.
其主要原理是添加一个 iframe，在里面加入外部链接。你可以直接写到头文件里面去，详情请见下面的yaml头文件的写法。
---
layout: keynote
iframe: "http://huangxuan.me/js-module-7day/"
---
iframe在不同的设备中，将会自动的调整大小。保留内边距是为了让手机用户可以向下滑动，以及添加更多的内容。
博客加入了 Gitalk 评论系统，支持 Markdwon 语法
优点：界面干净简洁，利用 Github issue API 做的评论插件，使用 Github 帐号进行登录和评论，最喜欢的支持 Markdown 语法，对于程序员来说真是太 cool 了。
缺点：配置比较繁琐，每篇文章的评论都需要初始化。
使用：
参考这篇文章：《为博客添加 Gitalk 评论插件》
网站分析，现在支持百度统计和Google Analytics。需要去官方网站注册一下，然后将返回的code贴在下面：
# Baidu Analytics
ba_track_id: 4cc1f2d8f3067386cc5cdb626a202900
# Google Analytics
ga_track_id: 'UA-49627206-1' # 你用Google账号去注册一个就会给你一个这样的id
ga_domain: huangxuan.me # 默认的是 auto, 这里我是自定义了的域名，你如果没有自己的域名，需要改成auto。
如果你喜欢折腾，你可以去自定义这个模板的 Code。
如果可以理解 _include/ 和 _layouts/文件夹下的代码（这里是整个界面布局的地方），可以使用 Jekyll 使用的模版引擎 Liquid的语法直接修改/添加代码，来进行更有创意的自定义界面啦
博客每页的标题底图是可以自选。
上传的图片最好先压缩，这里推荐 imageOptim 图片压缩软件，让你的博客起飞。
但是需要注意的是本模板的标题是白色的，所以背景色要设置为灰色或者黑色，总之深色系。
我的博客标题是 “KW Blog” 但是我想要在搜索的时候显示，这个就需要 SEO Title 来定义了。
其实这个 SEO Title 就是定义了<title>标题</title>这个里面的东西和多说分享的标题，可自行修改的。
遵循 MIT 许可证。