知识卡片
标记单一来源
Red Hat 最初把标记复制进 Markdown 文档,用来说明品牌 logo、视频区块等的组合方式。但每复制一次,标记被改动的概率就增加一分,很快难以维护。解决办法是让 HTML 片段只有一个来源、按需重用:文档交给 Hologram 之前先用 Twig 处理,用 include 传不同参数输出同一个 CTA 模板。改 CTA 时只更新一个 Twig 文件,全系统随之生效。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《前端架构设计》第17章《Red Hat 文档》(源文件:_epub-src/OEBPS/text00000.html)
- 结论依据:原文说明把 HTML 标记复制到 Markdown 模板文档中,每复制一次标记被改变的概率就增加,难以维护,于是寻找对标记片段使用单一源并按需重用,最终在 Hologram 处理前用 Twig 处理文档。
- 原始内容:问题是,每次将 HTML 标记从一个地方复制到另一个地方,标记被改变的概率就会无限增加。……我们很快就发现这种方式有多么难以维护,因此很快开始寻找新的解决方案:对 HTML 标记片段使用单一源,并按需重用。