【应用软件】Jekyll|【应用软件】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! ```

【【应用软件】Jekyll|【应用软件】Jekyll 配置】中不支持,可查看我另外两篇博客预览
  • 码云Pages
  • 作业部落

    推荐阅读