我想维护一份勘误表

[Hagb]

我打算维护一份勘误表，针对 2019 及其后的 release(s)，内容为修正的会引起误解的文字（单纯的润色、不影响文义的用词更改等不收录），以篇名、上下文、pdf 文档中的页码来定位。
能不能将这些勘误表 pull 到 beijinglug/fsfs-zh 里？

[tonghuix]

不用啊，有错误直接修改好即可，然后就发布新的 release

[Hagb]

我主要是考虑到看旧版的纸质书的读者，所以想维护一份面向他们的勘误表……
那些读者可能不懂得（或者也没有兴趣）看版本库里的修正，并且（如果没有维护一份勘误表）我也不方便将这些修正向他们反映……

[tonghuix]

那要这么说的话应该从 2016 版开始（也就是最早的那个正式 release），因为当年批量印刷的时候用的是这个版本。

勘误表如果手工来做的话工作量还是挺大的呢，有没有自动化的办法？只要自动生成一个 MD 稳定，然后加到 Makefile 里就行。这样可以在最终生成的 PDF 里加上这样一个页面。

[Hagb]

我想了想…如果用 diff，生成的结果无法直接使用，还是得人工调整（比如同一段落里面变动的是哪个部分，diff 识别出来可能和人工的不一样），其中还有不少是润色一类的。

如果从 2016 版开始，大概确实有不小的工作量…

我有一个思路，需要在书做了更改的时候，手动按照一种格式把更改（以及可以标识版本的信息）写到一个文件里面。可以用脚本生成任意两个版本之间的勘误表（考虑到这种情形：如果你给读者生成了一份2016～2017的勘误表，那么下次再给他们勘误表，是不是就不要重复之前的内容了）。但是如果不收录润色一类的内容的话，就要给每个 release 都单独维护一份文件…
如果润色一类的不影响文义的修改也收录的话，就简便得多，但是这会不会就不是一张勘误表该做的事情了？

另外，不知道有没有能够在 PDF 外自动获取某个内容在 PDF 内页码的办法…
如果把 PDF 的页码这个定位方法去掉的话，维护起来会简便得多…（因为可能需要为每个版本维护一份页码的记录）

[tonghuix]

感觉这个还是挺麻烦的啊

[Hagb]

要不

1. （除非有办法自动获取页码）不包含在 PDF 中的页码（不这么做的话，我想不到有什么办法能使我们无需给每个 release 都维护一份页码）
2. 将不影响文义的文字修改也包含进去（不这么做的话，我想不到有什么办法能使我们无需给每个 release 都维护一份勘误表）

？

当然，最好是能想出好的办法

[tonghuix]

我仔细想了想啊，勘误表可能应用场景不那么广，可以把优先级放低一点，你觉得呢？

[Hagb]

好

[Hagb]

要不退而求其次用 ChangeLog 代替？
感觉该书修正/改的规模有点大。

[tonghuix]

嘿，还真的可以！