Jekyll版本升级到4.x

作者：nunumick 发布时间：27 Jun 2023 分类： blog

博客多年时间后的又一次更新，源于发现页面代码过于陈旧，assets 资源引入还是 http 协议的，而 github 早就全站切到 https。其实原因是配置文件 _config.yml 里固定了博客 url，修改重新构建就行。不过安装了新版 jekyll，发现变化太大跑不起来……

升级印象

总体比较顺畅，基本上看看文档就行了，不过时间跨度&版本代差太大，现有文档也会缺少参考意义。

比较庆幸的是升级对 post 内容格式是兼容的，主要的改动在 plugins 的升级替换，引入方式有变化但不多。

尝试过想用新版的分类和tags，好像会影响原有的文章路径格式，会造成旧链接 404。所以最好还是采用 _plugins 插件，很可惜 github 因为安全策略仍然不支持自定义插件，最终采用的是 github action 构建来代替原来的本地 grunt 构建再同步。

jekyll serve 比之前更简便了。

另外顺手用 github issues 完成了对 disqus 的替换，用作文章的评论系统。

Archives 的支持

本地使用 jekyll-archives 插件，github 采用 workflow 生成 archives collections。调整 permalink 保证两个环境可以得到一致的访问体验。

# Local Archives
jekyll-archives:
  enabled:
    - categories
    - tags
  layouts:
    category: archive-categories-local
    tag: archive-tags-local
  permalinks:
    tag: /blog/tags/:name/
    category: /blog/categories/:name/

# Custom Archives for github
collections:
  archives:
    output: true
    permalink: /blog/:path/

其他必要步骤

bundle Gemfile 管理项目，安装依赖

gem install bundler jekyll
bundle init
bundle add jekyll
bundle add jekyll-paginate
bundle add jekyll-seo-tag
...

config.yml 配置变更，主要是

rdiscount -> kramdown
pygments -> rouge
http -> https

markdown: kramdown
highlighter: rouge
plugins:
  - jekyll-seo-tag
  - jekyll-paginate

# Markdown Processors
kramdown:
  input             : GFM
  syntax_highlighter: rouge

url: 'https://nunumick.github.io'

最后删除陈旧的目录&文件，更新高亮样式

rougify style monokai.sublime > css/monokai.sublime.css

<!-- assets.html -->
<link rel="stylesheet" href="/css/monokai.sublime.css" />

troubleshoot

Conflict: The following destination is shared by multiple files.
          The written file may end up with unexpected contents.

构建时出现上述冲突告警信息，排查下来是因为文章分类构建目录时不区分大小写，文章分类设置中有字母大小写会造成文件写冲突。

# post a
---
layout: post
category: javascript
---

# post b
---
layout: post
category: JavaScript
---

解决办法：全站统一使用小写命名规范，包括分类与标签。

另外，如果目录中存在同名的 .html 和 . markdown 文件，也会在构建时产生冲突。

如：

xxx目录
    - index.html
    - index.markdown

参考链接

标签： jekyll , blog , github
<<< EOF

默尘