Template:Redacted content/sandbox
████████
 | This is the template sandbox page for Template:Redacted content (diff). See also the companion subpage for test cases. |
{{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
[edit]{{redacted content}}→ ████████{{redacted content|5}}→ █████{{redacted content|color=cyan}}→ ████████
Parameters
[edit]| Parameter | Default | Explanation |
|---|---|---|
| length | 8 | The length of the redaction and thus the number of blocks to use. |
| color | #000 | The color of the redacted text. This can be either an HTML color name (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
[edit]Full width
[edit]Set the width= parameter to full to get a full width redaction:
{{redacted content|full}} and {{redacted content|width=full}} render as:
Redaction colour
[edit]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
[edit]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)
[edit]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)
[edit]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)}} → ████████
See also
[edit]- {{RPA}}
- {{RBLPV}}
- {{Redacted}}
- {{Inappropriate comment}}
- {{Copyvio-revdel}} - for redacting copyright violations in page history.
- Wikipedia:Talk page guidelines
- Wikipedia:Refactoring talk pages
- Wikipedia:Oversight