结论先说:只有当重复说明在不同页面里承担的作用基本一致、且不依赖本页独有数据时,才适合抽到公共页面;否则应保留局部版本,或在公共页面上加一层“本页适用条件”的短说明。判断依据不是重复字数,而是这段说明是否替读者回答了“为什么在我当前这页要这样理解”。
很多人把“重复”等同于“同一段话出现多次”,于是直接复制到公共页面并全站引用。真正要保留的上下文有两类:一类是解释性上下文,比如同一句操作说明在教程页和排错页里分别承担“怎么做”和“为什么失败”的功能;另一类是数据性上下文,比如说明里嵌入了本页特有的参数、样本范围或前置条件。前者可以改写后共用,后者一旦抽走,公共页面就会对某些页面给出错误暗示。
一个可操作的判断动作是:把待抽取段落逐句标注“这句是否随页面变化”。如果变化句超过三分之一,抽取后公共页面会变成一份需要频繁打补丁的模板,维护成本反而上升。此时更稳的做法是保留各页版本,只把其中真正稳定的定义句抽出去。
抽取后的结构可以这样分工:公共页面负责术语定义、通用前置条件和共同边界;引用它的局部页面负责说明本页为什么符合这些条件、哪些参数不同。这样做的结果是,读者从局部页面进入公共页面时不会丢失判断依据,从公共页面跳到局部页面时也能看到具体差异。
假设一个场景:三篇教程都提到“先确认样本量再决定是否扩大处理范围”。这句话本身稳定,可以放进公共页面。但其中一篇的样本量口径是按页面统计,另一篇是按目录统计。若公共页面只写“确认样本量”,读者会默认口径一致。合理做法是在公共页面列出两种口径的存在,并在各页用一行短句指明本页采用哪一种。这个动作的直接结果是:公共页面不再假装所有页面条件相同,局部页面也不必重复整段定义。
反例出现在“个别样本成立、规模化后出现例外”的时候。比如你观察到某类重复说明在少数页面上抽取后阅读顺畅,就推断全站都可以照搬。规模化之后,只要有一部分页面的说明依赖本页独有数据,公共页面就会对这些页面产生误导。此时抽取不但没有减少维护量,还增加了一层“公共页面说一套、局部页面做一套”的冲突。
这种冲突的常见证据是:局部页面开始出现“注意,本页不适用公共页面中的某条”这类补丁句。补丁句越多,说明抽取边界划错了。另一个合理解释是搜索需求本身发生了变化,读者关注点转移,而不是抽取动作本身有问题。比较改动前后时,要把季节、需求波动和数据采集口径差异一起考虑,不能把某段时间的波动单独归因于这次抽取。
建议先选一组结构相近的页面做对照:一部分保留局部说明,一部分引用公共页面。观察两件事,一是读者是否还需要回到局部页面找条件,二是维护时是否频繁修改公共页面。若公共页面改动次数明显少于局部页面,且没有出现大量补丁句,再考虑扩大范围;若补丁句持续增加,就回退到局部保留,或把公共页面拆成按条件分支的多个版本。
抽取的目标不是让文字变少,而是让读者在任何入口都能拿到足够的判断依据。把这一点作为取舍标准,比追求统一模板更可靠。