定义框：格式、规则与示例

定义框在文章展开之前为页面的核心术语提供一个精确、有边界的解释。它是一种开头元素：一种可复用的内容组件，应出现在页面起始附近，因为读者不应从示例、收益或背景信息中推断核心术语的含义。

这个实际示例就是完整的元素，而不是页面下方定义的预告。其标题是可选的；正文是必需的。下面的制作规范规定了该元素何时适用、每个字段的含义，以及相同内容如何在不同的发布系统中映射。

为什么这个元素很重要

读者很少从头到尾按顺序阅读信息性页面。他们通过扫描标题、开头行、标题和视觉上独立的块来判断该页面是否回答了他们的疑问。埋藏在引言段落中的定义会迫使读者将答案从上下文、主张和背景设定中分离出来。定义框消除了这项劳动：它的边界表明了"这就是定义"。

这个边界还为定义提供了一个稳定、可寻址的位置。编辑知道在哪里检查它，模板知道在哪里渲染它，后续修订不会迫使读者或质量检查人员搜索多个开头段落。一致的放置位置在整个内容库中都很重要，因为同样的信息任务不应在不同页面间无规律地移动。

机器可提取性是指软件能够在不丢失含义的情况下隔离内容单元的能力。带有标题和正文的类型化定义可以被独立地索引、比较、引用或转换。一个仅仅在自由文本中定义了某个术语的句子会溶解在其周围的散文中：软件必须猜测定义从哪里开始、在哪里结束，以及前面的主张是否属于该定义。遵循元素撰写规则 ，以确保即使视觉设计发生变化，语义标识仍然存在。

措辞在脱离定义框后也必须有效。样式为人类创造了对比；而自包含的主语、谓语和区别性含义为机器创造了可提取性。“它是一种改进它们的方法"在脱离段落后就无法成立。“内容修剪是删除、合并或更新不再具有有用搜索或商业目的的页面的过程"则能够独立存在。

何时使用

当页面围绕一个术语组织，且该术语可以用简短陈述精确定义时，使用定义框。对于术语表词条和什么是-X 格式，定义框是必需的。对于诊断或病症类内容也是必需的：读者在考虑原因、测试或治疗方案之前，必须知道所命名的病症是什么。

以症状为主导的页面和操作指南页面很少使用该元素。仅当一个简短定义能解决任务所需的真正歧义时才添加。例如，题为"如何修复关键词蚕食"的指南可以在步骤之前定义关键词蚕食，因为诊断决定了哪种修复方案适用。题为"如何更改标题标签"的指南如果受众和开头指令已经使对象明确，则不需要定义标题标签的定义框。

不要在以下情况使用定义框：

• 广泛的引言、历史、收益声明或解释主题为何重要的内容。这些段落展开文章内容；它们不是对术语的定义。
• 页面摘要。摘要收集多个结论，而定义陈述一个术语的含义。
• 产品承诺，如"AmICited 是提高可见度的最简单方法”。这是定位，而不是可验证的定义。
• 警告、提示、先决条件或建议。即使某个主题可能使其看起来像相同颜色的面板，其交际功能也完全不同。
• 文章中间引入的次要术语。在该术语首次出现的句子中定义它，或者当它值得持续讨论时为其创建单独的页面。
• 以权威性代替清晰度的引用。当需要注明出处时，在周围正文中归属正式定义；保持定义框本身作为直陈语句的可读性。

常见的"接近但不合格"的情况是"定义导言”：“客户流失是订阅业务最重要的概念之一，理解它可以改变增长。“这句话说明了这个概念很重要，但从未说明它是什么。定义框无法使空洞的背景设定变得精确。

放置位置

放置位置体现了优先级。将定义框放在引言段落或简短介绍之后，作为第一个内容块。引言确立读者为何来到该页面；定义框随后在任何原因、示例、收益、步骤或比较依赖它之前确定含义。

不要在引言和定义框之间放置导航、目录、关键要点、图片库或促销行动号召。这些块会迫使读者在获得术语含义之前先穿越不相关的材料。面包屑导航和页面英雄区属于模板装饰而非创作内容，因此可以出现在引言之前。

每个页面使用一个定义框。存在此规则是因为该组件标识了页面的主要定义对象。两个定义框会创建两个竞争的核心术语并使提取变得模糊。如果两个术语确实都是核心的，将主题拆分为两个页面并用正文连接。如果第二个术语是从属的，则内联定义它，而不是将其样式化为第二个规范答案。

直接答案块 只有在回答不同主要问题时才能与定义框共存。在诊断页面上，定义框可以说明病症是什么，而直接答案说明推荐的第一项行动。当页面的主要问题是"什么是 X？“时，直接答案和定义框是相同的答案。将它们合并为一个定义框；相邻的版本只是重复措辞并竞争提取。

结构

该元素有两个创作区域和一个结构关系。截图必须显示渲染后的元素，而不要将解释性文字嵌入到图像中；下面的图例在视觉设计发生变化时仍保持可选中、可访问和可维护。

渲染图例

1. 可选标题： 通常为"什么是 X？“它标识确切术语，且不得添加第二个主张。
2. 必需正文： 一个自包含的定义，命名术语，将其置于有用的类别中，并说明其区别性特征。
3. 起始位置： 定义框位于引言之后、第一个解释性部分之前。这一关系虽然不是一个字段，但也是规范的一部分。

边框、背景、内边距、图标处理和排版属于渲染器。作者提供含义，而非视觉标记。即使去除所有装饰样式，该元素也必须保持可理解性。

设计示例

图库涵盖支持的内容变体，而不是发明不同语义类型。每次截图应尽可能复用相同的定义，以便评审者判断标题处理、正文换行和视口行为，而不是比较无关的文案。

带标题： 当术语不熟悉、有歧义、使用缩写或与确切页面标题不同时的首选变体。

无标题： 当页面标题和紧接的引言使主题明确无误时允许使用。正文仍必须命名术语；省略标题绝不意味着允许使用"它"等代词替代主语。

最大长度： 渲染器对完整正文进行换行。不得截断、折叠、滚动或缩小字体以容纳编辑最大长度的文案。

窄视口： 标题和正文保持顺序、可读行长度和可见边界。任何含义不得依赖于移动到文字旁的图标。

参数

参数将内容与呈现分开。其限制使定义在不同页面间保持可比性，并防止该组件变成通用标注。

定义框参数

渲染器可以为索引而派生术语，但作者绝不可编写依赖于该派生字段显示的正文。复制的定义必须明确命名其主语。

语法与代码示例

所有三种形式具有相同的标题和正文。可移植的 Markdown 指令是规范的创作形式；Hugo 和 WordPress 是适配器。这些示例特意使用相同的措辞，以便迁移测试可以比较数值，而不仅仅是外观。

可移植 Markdown 指令

:::definition
## 什么是内容修剪？

内容修剪是删除、合并或更新不再具有有用搜索或商业目的的页面的过程。
:::

第一个标题映射到 title；之后的所有内容映射到 body。省略标题以得到无标题变体，但将术语保留在正文中。

Hugo 短代码

{{< callout type="note" title="什么是内容修剪？" >}}内容修剪是删除、合并或更新不再具有有用搜索或商业目的的页面的过程。{{< /callout >}}

该站点为可见的 Hugo 处理复用现有的标注渲染器。定义规范仍来自类型化的可移植源：这里的 note 是一个渲染适配器，而不是允许在定义框中放置普通注解。

WordPress 块或短代码

[definition title="什么是内容修剪？"]内容修剪是删除、合并或更新不再具有有用搜索或商业目的的页面的过程。[/definition]

WordPress 实现可以将相同字段暴露为自定义块。存储的值仍然是 title 和 body；编辑器控件、颜色和间距是呈现设置，不得改变定义的含义。

示例

这是一个好的示例，因为它命名了术语、标识了状况、说明了区别性后果。它没有声称每对共享某个词的页面都在竞争；“相同的搜索意图"这一短语提供了必要的边界。正文在没有标题的情况下仍然有用，且足够简短以便完整引用。

这是一个错误的示例，因为它从未定义关键词蚕食。它提供了重要性、受众、紧迫性和模糊的影响，但没有类别或区别性条件。将"最重要的问题之一"替换为"多个页面竞争相同搜索意图的情况"就能将促销转变为含义。

第二种错误模式是过度填充定义框：定义后紧跟原因、五个示例、一个警告和一个推荐工具。即使第一个句子是准确的，多余的材料也破坏了稳定的边界。保留定义；将原因和示例移至下一部分，警告移至其正确元素，推荐移至读者可以采取行动的位置。

Schema 标记与无障碍

定义框不会自动创建独立的 Schema.org 实体。在普通文章上，其文本仍然是外围 Article 或 TechArticle 的一部分。在术语表页面上，只有当站点已采用该 Schema 策略时，发布实现才可以将术语和定义映射到适当的词汇表。不要发明 DefinitionBox 类型：它在 Schema.org 中不存在。

同样，不要因为定义框看起来重要就在 JSON-LD 中重复正文。Schema 标记 必须如实描述页面，将可见的正文复制到不相关的属性中会造成噪音而非更强的含义。如果填充了 Schema 属性，其值必须在实质上与可见定义一致并随之更新。

元素不需要交互式 ARIA 角色。按正常文档顺序将其渲染为带标签的区域或语义容器，标题在前、正文在后。不要使用 role="alert"，因为静态定义不是紧急或新到达的信息。不要仅使用颜色或图标作为该块是定义的唯一信号。如果标题以标题元素实现，其级别必须遵循页面层级；源文件中的 ## 是字段映射约定，而非创建无效标题跳级的指令。

键盘行为遵循普通阅读行为：定义框本身不可聚焦。其中的任何链接遵循普通链接语义，需要描述性锚文本。屏幕阅读器输出必须保持与屏幕上相同的标题在前、正文在后的顺序。

撰写规则

在撰写定义的收益之前先撰写定义本身。从术语本身开始，然后使用"是”、“意味着"或"发生在……时"等系动词。陈述最近的可用类别以及将该术语与邻近概念区分开来的特征。这个顺序存在的原因是：没有区别的类别过于宽泛，而没有类别的区别则让读者不确定该术语属于何种事物。

将正文保持在最多约 300 个字符（包括空格）。优先使用一个句子。仅当必要的边界无法在第一个句子中清晰表达时，才允许使用第二个短句。这个限制是编辑性的，而不是要求压缩标点、删除冠词或堆砌从句。如果准确性需要更多空间，将精确核心放入定义框，并立即在其后进行限定。

使用中性、陈述性语气。避免"重要”、“强大”、“改变游戏规则”、“你需要知道"等类似判断。避免循环定义，例如"内容优化就是优化内容的行为”。首次使用缩写时展开，除非缩写本身就是页面的术语。使用与页面标题相同的规范名称。

绝不要在正文中放置以下内容：

• 多于一个核心术语或相关术语列表。
• 收益、历史、原因、症状、示例、步骤、产品推销或行动号召。
• 表格、图片、视频、表单、按钮、脚注或嵌套标注。
• 无依据的夸张、虚构的统计数据或需要整段证据的主张。
• 第二个标题、项目符号列表或块引用。
• 含义依赖于前面引言的代词。

一个归属链接是例外而非目标。仅当法律、科学或基于标准的定义依赖于具名来源时使用。将扩展引用和来源间的分歧放在普通正文中，让读者能看到限定条件，而不是将某个有争议的措辞误认为通用定义。

使用定义框的文章类型

postTypes 前置元数据记录了已注册的关联。下表将这些关联转化为编辑规则。诊断/病症类和以症状为主导的格式在此描述为使用模式，但未作为独立的操作手册文章类型链接，因为它们不在当前的规范注册表中。

文章类型要求

对于诊断或病症类页面，始终使用定义框并将其放在症状、原因、严重程度或治疗方案之前。对于以症状为主导的页面，仅当症状名称具有真正简短、稳定的定义时使用。如果定义框仅仅重复标题——“慢速网站就是速度慢的网站”——则省略它，并在正文中以诊断阈值或可观察问题开头。

QA 检查清单

评审者在检查外观之前先检查含义。一个精致的定义框如果包含模糊的引言，仍然是一个失败的定义。

• 一个核心术语： 页面和定义框定义恰好一个主要概念。
• 正确位置： 定义框是引言后的第一个创作内容块，其前没有插入目录、要点、图库或促销内容。
• 唯一出现： 没有第二个定义框与规范答案竞争。
• 实际定义： 正文陈述术语是什么或条件何时存在；它不仅说明术语为何重要。
• 自包含措辞： 正文命名其主语，在脱离附近正文或样式复制时仍有意义。
• 精确性： 类别、区别性特征和任何必要的边界均准确。措辞不过度泛化。
• 长度： 正文不超过约 300 个字符，保持可读性而非被压缩。
• 内容清洁： 内部无收益、历史、示例、步骤、产品声明、媒体、表格或嵌套元素。
• 直接答案决策： 如果页面询问"什么是 X？"，定义框是唯一的直接答案元素。如果两个元素同时出现，它们回答的问题必须明显不同。
• 无障碍语义： 标题在正文之前，标题级别有效，颜色不是唯一标识符，无警报角色或不必要的焦点目标。
• 可移植对等性： Markdown、Hugo 和 WordPress 映射保留相同的标题和定义。
• 结构化数据克制： 任何 Schema 值与可见文案匹配，不使用发明的 Schema.org 类型。
• 截图状态： 注释保留为非渲染的截图说明，直到指定文件存在；不引用不存在的图像路径作为图像。

常见问题

学院模板渲染此页面 [[faq]] 前置元数据中存储的五个审阅问题。它们共同涵盖必要性、与直接答案共存、链接和引用、长度限制以及每页一个定义框的规则。