模板: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}}