其他
零散开源贡献复盘:MyBatis 中文文档修正,以及 docsy-jekyll 标签页和 jQuery 加载问题。
其他
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 进行授权