Template:Clarify: Difference between revisions

Revision as of 21:19, 22 April 2025

Description

This template can be used to mark a fact or sentence in need of clarification or improvement. The first parameter gives an explanation of why clarification is necessary, and appears as a tool-tip when you hover over the notation. The article will be added to Category: Articles in Need of Clarification.

This template is one of several Editorial Notations.

Usage

Note: When used on article pages, this template will render as follows ( ^{[clarification needed]} ) It does not render correctly on this page due to recursive linking logic.

Tag Only When just `{{clarify}}` is passed, it will add a superscript note that says "[clarification needed]". When you hover over it for a moment, a pop-up message will appear that says "This statement needs clarifying.".
You Type	You Get
An example sentence.{{clarify}}	An example sentence.^{[clarification needed]}
Reason Parameter When `reason=` is passed, it will replace the text "This statement needs clarifying." in the pop-up message with your input.
You Type	You Get
An example sentence.{{clarify\|reason=Explanation of reason.}}	An example sentence.^{[clarification needed]}
Date Parameter When `date=` is passed, it will add your input to the end of the pop-up message in parentheses. The pop-up message "This statement needs clarifying." will still appear unless `reason=` is also passed.
You Type	You Get
An example sentence.{{clarify\|date=March 1883}}	An example sentence.^{[clarification needed]}

Articles using Template

@@ Line 1: / Line 1: @@
-<includeonly><sup title="{{{1|This statement needs clarifying.}}}">''[<span class="plainlinks">[[:Template:Clarify|clarification needed]]</span>]''</sup><!--
+<includeonly><sup>''[<span class="plainlinks"><span class="editorial-notation-tooltip">[[Template:Clarify<!--
+  -->|<span title="{{#if:{{{reason|}}}<!--
+    -->|{{{reason}}}<!--
+    -->|This statement needs clarifying.}} {{#if:{{{date|}}}| ({{{date}}})<!--
+  -->}}">clarification needed</span>]]</span></span>]''</sup><!--
 -->{{#ifeq:{{NAMESPACE}}|{{ns:0}}|[[Category: Articles in Need of Clarification]]}}</includeonly><noinclude>
 == Description ==
 This template can be used to mark a fact or sentence in need of clarification or improvement. The first parameter gives an explanation of why clarification is necessary, and appears as a tool-tip when you hover over the notation. The article will be added to [[:Category: Articles in Need of Clarification]].
-It is one of several [[:Help:References#Editorial_Notations|Editorial Notations]].
+This template is one of several [[:Help:References#Editorial_Notations|Editorial Notations]].
 ==Usage==
+:'''Note:''' When used on article pages, this template will render as follows ( <sup>''[<span class="plainlinks">[[:Template:Clarify#Description|clarification needed]]</span>]''</sup> ) It does not render correctly on this page due to [[:Help:Markup#Internal_Links|recursive linking logic]].
 {| style="width: 100%; text-align: left; margin: auto;" class="wikitable"
+|-
+! colspan="2" style="text-align: center;" | <span style="font-size: 115%;">Tag Only</span><br><span style="font-weight: normal;">When just <code><nowiki>{{clarify}}</nowiki></code> is passed, it will add a superscript note that says "''[clarification needed]''".<br>When you hover over it for a moment, a pop-up message will appear that says "This statement needs clarifying.".</span>
+|-
+! width=60%|You Type
+!You Get
+|- style="text-align: center; background-color: white;"
+| <pre>An example sentence.{{clarify}}</pre>
+| An example sentence.{{clarify}}
 |-
-! colspan="2" style="text-align: center;" | <span style="font-size: 115%;">Tag Only</span><br><span style="font-weight: normal;">When just <code><nowiki>{{clarify}}</nowiki></code> is passed, it will add a superscript note that says "''[clarification needed]''". When you hover your cursor over it for a moment, a pop-up message that says "This statement needs clarifying." will appear.</span>
+! colspan="2" style="text-align: center;" | <span style="font-size: 115%;">Reason Parameter</span><br><span style="font-weight: normal;">When <code>reason=</code> is passed, it will replace the text "This statement needs clarifying." in the pop-up message with your input.</span>
 |-
-! width=55%|You Type
+! width=60%|You Type
 !You Get
+|- style="text-align: center; background-color: white;"
+|<pre>An example sentence.{{clarify|reason=Explanation of reason.}}</pre>
+|An example sentence.{{clarify|reason=Explanation of reason.}}
 |-
-| style="text-align: center; background-color: white;" |<pre>This is a sentence that needs clarification.{{clarify}}</pre>
+! colspan="2" style="text-align: center;" | <span style="font-size: 115%;">Date Parameter</span><br><span style="font-weight: normal;">When <code>date=</code> is passed, it will add your input to the end of the pop-up message in parentheses.<br>The pop-up message "This statement needs clarifying." will still appear unless <code>reason=</code> is also passed.</span>
-| style="background-color: white;" |This is a sentence that needs clarification.<sup title="{{{1|This statement needs clarifying.}}}">''[<span class="plainlinks">[[:Template:Clarify#Usage|clarification needed]]</span>]''</sup>
 |-
-! colspan="2" style="text-align: center;" | <span style="font-size: 115%;">User Claim</span><br><span style="font-weight: normal;">When <code>user=</code> is passed, the user is added to the notice.</span>
+! width=60%|You Type
-|-
-! width=55%|You Type
 !You Get
-|-
+|- style="text-align: center; background-color: white;"
-| style="text-align: center; background-color: white;" |<pre>This is a sentence that needs clarification.{{clarify}}</pre>
+|<pre>An example sentence.{{clarify|date=March 1883}}</pre>
-| style="background-color: white;" |This is a sentence that needs clarification.{{clarify}}
+|An example sentence.{{clarify|date=March 1883}}
 |}