Sobekyll搭配一些插件会有更好的使用体验,下面介绍若干插件,后续遇到更好的插件,会不断补充。

jekyll-paginate

这是一个用于分页的插件,避免首页一次性展示所有的文章造成加载时间过长。Sobekyll对此插件已经做了支持。接入方式如下: 在Gemfile中添加如下代码并执行bundle install。

gem "jekyll-paginate", "~> 1.1.0"

_config.yml文件中,启用并配置该插件。

plugins:
  - jekyll-paginate

paginate: 5   # 每页显示的文章数量
paginate_path: "/page:num/"  # 分页路径,:num 会被页码替换

更多使用配置请参考: jekyll-paginate

jekyll-archives

这是用于自动生成tag/category页面的插件,Jekyll默认不会按照tag/category生成页面,也就是说,如果你想点击某个tag/category,查看对应的文章列表,会自动跳转到404页面。为了解决这个问题,接入此插件: 在Gemfile中添加如下代码并执行bundle install。

gem 'jekyll-archives'

_config.yml文件中,启用并配置该插件。

plugins:
  - jekyll-archives
jekyll-archives:
  enabled: 
    - tags
    - categories
  layout: archive
  permalinks:
    year: '/:year/'
    month: '/:year/:month/'
    day: '/:year/:month/:day/'
    tag: '/tag/:name/'
    category: '/category/:name/'

更多使用配置请参考: jekyll-archives

jekyll-sitemap

该插件用于自动生成sitemap.xml,提交给相关搜索引擎的控制平台后,该搜索引擎就会知道你的目录结构,方便被搜索引擎索引到。接入方式如下: 在Gemfile中添加如下代码并执行bundle install。

gem 'jekyll-sitemap'

_config.yml文件中,启用该插件。

plugins:
  - jekyll-sitemap

更多使用配置请参考: jekyll-sitemap

jekyll-seo-tag

该插件用于自动生成一些页面头信息,方便搜索引擎检索。插件安装方式如下: 在Gemfile中添加如下代码并执行bundle install。

gem 'jekyll-seo-tag'

_config.yml文件中,启用并配置该插件。

plugins:
  - jekyll-seo-tag

更多使用配置请参考: jekyll-seo-tag

jekyll-mermaid

该插件用于解析以mermaid方式添加到图表。插件安装方式如下: 在Gemfile中添加如下代码并执行bundle install。

gem 'jekyll-mermaid'

_config.yml文件中,启用并配置该插件。

plugins:
  - jekyll-mermaid

mermaid:
  src: 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js'

使用方式如下:

<script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script><div class="mermaid">
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
</div>

效果如下: <div class="mermaid"> graph TD; A–>B; A–>C; B–>D; C–>D; </div>

更多使用配置请参考: jekyll-mermaid