【应用软件】Jekyll 配置

实现功能

• TOC （目录）
• 代码高亮
• LaTeX 显示：支持 MathJax 和 KaTeX 两种方式
• 序列图

Ubuntu 下安装

sudo apt-get install jekyll

Markdown 文章

存放在 _post 目录下，可分子目录存放

以下内容均以 kramdown 实现

TOC

Table of Contect

kramdown 默认支持 TOC 功能

在需要插入目录的地方加入如下内容

* toc
{:toc}

时间

文章日期需增加时区，否则可能导致无法显示

date: 2017-08-07 13:26:51 UTC+8

语法高亮

配置 _config.yml

highlighter: rouge
markdown: kramdown
kramdown:
  input: GFM

下载 pygments，附下载地址

HTML head 中添加

article_content.css 中覆盖了部分样式

body {
    font-size:2rem;
}

/* 代码块 */
.highlight {
    padding:1rem 2rem 1rem 2rem;
    border:2rem solid transparent;
    border-radius:.8rem .8rem .8rem .8rem;
    box-shadow:0 0 15px rgba(0,0,0,.3);

    font-size:1.8rem;
    line-height:2.1rem;

    background:#272822;
    color:#f8f8f2;
}

/* 字符串背景色与代码块背景色一致 */
.highlight .s {
    background-color: #272822
}

LaTeX 支持

支持 LaTeX 数学公式显示，以 KaTex 方式为例，公式均以 $$ 括起来

1. 公式放在段落内或紧挨着段落，则为行内公式
2. 公式前后有空行，则为整行公式

行内公式 $$ E=mc^2 $$

行内公式
$$ \sum_{i=1}^n a_i=0 $$

整行公式

$$ f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$
f(x) = \int_{-\infty}^\infty
\hat f(\xi)\,e^{2 \pi i \xi x}
\,d\xi
$$

中不支持，可查看我另外两篇博客预览

• 码云Pages
• 作业部落

MathJax

在线方式

本地方式

1. 下载 MathJax.js
2. HTML head 中添加如下内容

KaTeX

在线方式

本地方式

1. 下载 KaTeX
2. HTML head 中添加如下内容

KaTeX 方式均需要在 前增加如下内容

序列图

js-sequence-diagrams

1. 下载依赖：webfont.js，snap.svg-min.js，underscore-min.js
2. 下载 js-sequence-diagrams
3. HTML head 中添加如下内容

在 前增加

或者

theme: 'hand' 表示草绘效果
theme: 'simple' 为标准效果

markdown 文件中使用 sequence 替代 python/shell 之类的代码块，其语法可访问官网

```sequence
Andrew->China: Says Hello
Note right of China: China thinks\nabout it
China-->Andrew: How are you?
Andrew->>China: I am good thanks!
```

中不支持，可查看我另外两篇博客预览

• 码云Pages
• 作业部落