الگو:Redacted content/توضیحات

این زیرصفحهٔ مستندات الگو:Redacted content است.
این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمی‌گیرد.

{{redacted content}} stylistically renders text that has been censored (see redact in Wiktionary). This template will commonly be used when citing formerly-classified documents that have been released via a Freedom of Information Act request or similar.

Usage

{{Redacted content}} →

{{Redacted content|5}} →

{{Redacted content|color=cyan}} →

Parameters

Parameter	Default	Explanation
length	8	The length, in em. For a full width redaction, the keyword `full` may be used.
color	#000	The color of the redacted text. This can be either an رنگ‌های وب (eg "black" or "white"), or a RGB hexadecimal representation of a color (eg "#000" for black, "#ff0000" for red).
replacement		If present, a tooltip will display this text when hovering over the redacted area with the heading "replacement = ".
text	` `	If present, the text will be rendered on the "redacted" area. Note that this text will always be rendered in black; to be visible, utilize the `color=` parameter to adjust the color of the redaction.
foia-exceptions		If present, a tooltip will display this text while hovering over the redacted area with the heading "FOIA Request Exceptions:". This is intended to be used to list exemptions to the Freedom of Information Act.

Examples

Full width

Set the width= parameter to full to get a full width redaction:

{{Redacted content|full}} and {{Redacted content|width=full}} render as:

Redaction colour

To redact in another colour then utilise the parameter color=, eg. color = white. This can be useful when the redaction still shows the original text.

{{Redacted content|color=white}} renders as:

Text content

If the redacted text is still visible, you can add the text with the text= parameter. Note you probably need to change the colour to something other than black for it to be visible.

{{Redacted content|color=grey|text=This was redacted}} renders as: This was redacted

Remarks (Tooltip)

By default, when hovering over a redaction, a tooltip will show that reads "redacted text". If the replacement= parameter is used, this value will be added to the tooltip. Hover your mouse over the examples below.

NOTE: this functionality makes use of "hovering" a mouse. It is therefore not available to users on mobile devices, tablets, touch screens, visually impaired users with text readers, and so on. Use sparingly.

A regular redaction with no replacement= parameter: {{Redacted content}} →

A redaction with a replacement= parameter: {{Redacted content|replacement=Example Text.}} →

Freedom of Information Act Request Exceptions (Tooltip)

The US Freedom of Information Act, which forces the US government to release documents, includes a number of listed exceptions. When a document is released, these exceptions may cause information to be redacted. If present and documented, this exception can be included in a tooltip on the redacted area using the foia-exceptions= parameter.

This parameter may be used in conjunction with the remarks= parameter.

The following redaction includes an FOIA request exception: {{Redacted content|foia-exceptions=(b)(6), (b)(7)(c)}} →