模板:Redact/doc
 | 本文档是Template:Redact的文档子页面 （见页面自身）。 本页包含用法信息、分类和其他非原页面的内容。 |
 | 此模板使用 详情请见 H:DIVSPAN。 |
{{redact}} 模板可以以脱敏文献的风格渲染已被删减的文字部分 (请参阅维基词典 redact 词条)。此模板主要用于录入原本为机密、后来应《自由信息法案》等法律要求向社会公开的文献。
用法
[编辑]{{redact}}→{{redact|5}}→{{redact|颜色=cyan}}→
参数
[编辑]| 参数 | 默认值 | 说明 |
|---|---|---|
| 宽度 | 8 | 脱敏区域的宽度，单位为 em。参阅维基百科关于 “em” 的条目。
要绘制一整行的脱敏区域，可以使用关键词 |
| 颜色 | #000 | 脱敏区域的颜色。可以是 HTML 颜色关键词 (例如 “black” “white”)，也可以是十六进制形式的 RGB 值 (例如 “#000” 表示黑色，“#ff0000” 表示红色)。 |
| 替代文字 | 如果填写该参数，当鼠标指针指向脱敏区域时，鼠标工具提示中将在 “替代内容 = ” 后方显示此参数填写的文本内容。 | |
| 文本 | |
如果填写该参数，将在 “脱敏区域” 渲染此参数的文本内容。注意，此文本本身只能渲染为黑色；要想让读者看清文字，请使用 {{{颜色}}} 参数调整脱敏区域的整体颜色。 |
| foia例外 | 如果填写该参数，当鼠标指针指向脱敏区域时，鼠标工具提示中将在 “FOIA 准予脱敏的例外条款:” 后方显示此参数填写的文本内容。此功能旨在列出《自由信息法案》中的豁免条款 (编号)。 |
示例
[编辑]整行
[编辑]将 {{{宽度}}} 参数设为 整行 可绘制一整行的脱敏区域:
{{redact|整行}}与{{redact|宽度=整行}}都会渲染为:
脱敏部分的颜色
[编辑]可以通过 {{{颜色}}} 参数，使用其他颜色来进行脱敏处理，例如 颜色 = white。如果需要在脱敏部分显示原始文本，这个功能会很有用处。
{{redact|颜色=white}}渲染为:
文本内容
[编辑]如果经脱敏处理的原始文本仍然清晰可见，可以使用 {{{文本}}} 参数添加这些文本。注意，您可能需要将脱敏部分改为黑色以外的颜色，才能让读者看到文本内容。
{{redact|颜色=grey|文本=这是已被脱敏处理的文本}}渲染为:
这是已被脱敏处理的文本
备注 (鼠标工具提示消息)
[编辑]使用默认参数时，将鼠标指针移动到已脱敏文字上面，会显示内容为 “已脱敏文本” 的鼠标工具提示消息。如果使用 {{{替代}}} 参数，该参数的值将显示在鼠标工具提示中。您可以将鼠标指针移到下面的示例上感受该功能。
注意: 此功能依赖鼠标的 “移动”(悬浮) 功能。因此不支持手机、平板等触屏设备，以及视障人士使用的文本阅读器等设备。尽可能避免使用该功能。
- 不填写 {{{替代}}} 参数的普通脱敏文本:
{{redact}}→ - 填写 {{{替代}}} 参数的脱敏文本:
{{redact|替代=示例文字。}}→
信息自由法案（FOIA）准予脱敏的例外条款 (鼠标工具提示消息)
[编辑]强制美国联邦政府公开档案的美国《信息自由法案》，包含一系列例外条款。档案被公开时，这些例外条款准许对部分信息进行脱敏处理。如果例外条款在原始扫描件中出现且明确标注，则可以使用 {{{foia例外}}} 参数为已脱敏部分添加显示例外条款的鼠标工具提示消息。
此参数可以与 {{{备注}}} 参数同时使用。
- 此例包含根据 FOIA 豁免条款准予进行脱敏处理的内容:
{{redact|foia例外=(b)(6), (b)(7)(c)}}→
分类
[编辑]此模板会自动设置以下分类，以便于跟踪：
参见
[编辑]- {{?}}
- {{illegible}}
- {{reconstruct}}