文章

其他

零散开源贡献复盘:MyBatis 中文文档修正,以及 docsy-jekyll 标签页和 jQuery 加载问题。

其他
  1. MyBatis
    1. #2836
  2. docsy-jekyll
    1. #76
    2. #26

MyBatis

#2836

这个 PR 修正了一个有误导性的中文文档翻译。读中文文档的时候半天没看明白,换成英文就通顺了。

这类改动不复杂,但很有价值:文档翻译一旦偏掉,读者会怀疑自己理解错了,而不是第一时间怀疑文档错了。顺手修掉,后面的人就少绕一圈。

docsy-jekyll

在使用 Chirpy 之前,我用的是 docsy-jekyll。这两次贡献都来自真实使用时踩到的坑:一个是标签页生成问题,一个是资源加载问题。

#76

标签页总有某些标签找不到,后来不能忍了,看了看源码,发现是拼接 tag 的时候,有两个标签被错误拼接成一个了。

flowchart LR
    A["文章 tag A"] --> C["生成 tags 列表"]
    B["文章 tag B"] --> C
    C --> D["错误拼接成一个 tag"]
    D --> E["某些标签页找不到内容"]
    C --> F["修正拼接逻辑"]
    F --> G["每个 tag 正常生成页面"]

    style D fill:#ffe3e3,stroke:#c92a2a
    style E fill:#ffe3e3,stroke:#c92a2a
    style F fill:#e3f2fd,stroke:#1976d2
    style G fill:#e8f5e9,stroke:#2e7d32

#26

这个 PR 处理的是 jQuery 加载问题。问题本身倒不复杂,复杂的是它出现的原因非常现实:

唉,这尴尬的墙啊……你墙 jQuery 干嘛……

所以这次修复的核心不是炫技,而是让站点资源加载更可靠。博客这种东西,页面能打开是第一位的,别让一个外部资源把整页交互都拖没了。

本文由作者按照 CC BY 4.0 进行授权