标签术语#

API 标签：示例中包含 API 参考的哪些内容？#

`tag`	用例
主要或相关的情节组成部分
`component: axes`	显著或非常清晰的组件使用
`component: axis`
`component: marker`
`component: label`
`component: title`
`component: legend`
`component: subplot`
`component: figure`
`component: annotation`
`component: label`
`component: ticks`
`component: spines`	经常与 `component: axis` 配对使用
`component: error`
`component: animation`

样式
当图表包含可教学的示例时使用这些标签
`styling: color`
`styling: shape`
`styling: size`
`styling: position`
`styling: texture`
`styling: colormap`
`styling: linestyle`
`styling: small-multiples`
`styling: conditional`	样式是通过满足某个条件以编程方式确定的

互动性
`interactivity: event handling`
`interactivity: click`
`interactivity: mouseover`
`interactivity: zoom`
`interactivity: pan`
`interactivity: brush`
`interactivity: drag`
`interactivity: scroll`

绘图类型
`plot-type: bar`	示例包含一个条形图
`plot-type: line`	示例包含一条线图
`plot-type: pie`	示例包含一个饼图
`plot-type: polar`	示例包含一个极坐标图
`plot-type: 3D`	示例包含一个3D图
`plot-type: histogram`	示例包含一个直方图
`plot-type: specialty`
`plot-type: scatter`

`tag`	用例
`level`	level 指的是用户需要多少上下文/背景
`level: beginner`	概念是独立的、自包含的，只需要一个模块。
`level: intermediate`	概念可能需要其他模块的知识，存在依赖关系
`level: advanced`	概念需要多个模块并且有依赖关系
`purpose`	它在这里的目的是什么？
`purpose: 讲故事`	讲故事的典范 -- 构建视觉论点
`purpose: reference`	参考文档如“标记参考”或“命名颜色列表” 密集的短格式信息集合明确的范围，可访问的信息
`purpose: fun`	只是为了好玩！
`purpose: showcase`	好的展示示例

试图在“谁拥有什么”之间划定界限是徒劳的，而这并不是域标签的重点。请参见下面的现有域标签列表。如果你没有找到你想要的，并且你认为它应该存在，可以考虑提出建议。

这些标签应仅用于开发目的；因此请将它们单独添加在版本保护之后：

.. ifconfig:: releaselevel == 'dev'
    .. tags::  internal: needs-review

`tag`	用例
`internal: high-bandwidth`	允许用户过滤掉像动画这样占用带宽的示例
`internal: untagged`	允许文档贡献者轻松找到未标记的示例
`internal: deprecated`	包含已弃用的功能或概念的示例
`internal: needs-review`	需要对示例进行准确性或教学价值的审查
`internal: outstanding-todo`	示例有一个未完成的待办事项
`internal: too-much`	该示例应进行改进，拆分为多个示例，或重新格式化为教程或参考文档。