笨熊之家

欢迎来到笨熊之家~

0%

一次 Pull Request 引发的问题 -- 甲之蜜糖,乙之砒霜

本博客用的 Hexo,有一个功能在文章中插入 <!-- more --> ,之前的内容成了摘要,显示在首页上,点击查看更多才跳转到正文页面。

这是手动设置摘要的方法,也有插件可以实现自动选取摘要,例如这次我们要谈到的 chekun/hexo-excerpt: Automatic excerpt generator for Hexo,可以根据设置,以标签为单位进行摘要的选取,避免选取到不完整的内容。

有次在写短文的时候发现,即使除去摘要,正文没有更多内容时,首页还是会显示“查看更多”字样,于是发起了一个 Pull Request,尝试去修正这个问题,我提出的方案是短文不再自动生成摘要。

It seems to be confusing when excerpt is showed and there is no more content, so i add a condition to check if the length of moreNodes is more than zero.

这个更改当天就被合并到主分支了。

有趣的是,前几天查看,发现有个人因为这次更改碰到了问题,他发现他的短文章在主页上只剩下标题的日期,没有自动生成的摘要。所以他后续的 Pull Request 是把这个功能作为可选项加入配置文件中。

The change seems very odd to me, and definitely isn’t what I want from this module so I added a configuration option to switch between the behaviour introduced in that pull request and the previous behaviour.

叙述起来是很短的一件事,不过对我来说挺有纪念意义的,作为开源项目,许多用户都会用到,所以改动需要考虑大多数人的需求。这次我觉得是问题的,另一个用户反倒觉得是正常的,很有意思。确实,作为配置项会更好,这样用户可以自定义。