Changes
Jump to navigation
Jump to search
no edit summary
{{Documentation subpage}}
{{nosubst}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{template shortcut|clarifyspan|clarify-span}}
== Usage ==
The {{tl|clarify span}} template may be used when there is text that needs further explanation or clarification. Unlike the template {{tl|clarify}}, this template attaches explicitly to a portion of text, for example one or more specific sentences, by surrounding the text with the template. This is especially useful for flagging ''multiple facts'' or multiple sentences as needing clarification, and for singling out ''a specific unclear fact'' among many.
Once the passage is clarified, please remove this template from the surrounded text.
:<blockquote>{{tlx|clarify span|text{{=}}<var>Passage(s) needing clarification</var>|explain{{=}}<var>Reason for the needed clarification</var>|date{{=}}<var>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}</var>}}</blockquote>
The date and explain parameters are optional. The parameter names for {{para|text}} and {{para|explain}} can be omitted, as long as the text is in the first position, and the explanation is in the second. Therefore, the minimal syntax is:
:<blockquote>{{tlx|clarify span|<var>Passage(s) needing clarification</var>}}</blockquote>
'''Example of usage:'''
::: <code>... the treaty. {{tlx|clarify span|One of the terms|explain{{=}}which one?}} of the treaty of Versailles led to ...</code>
:produces:
::: ... the treaty. {{clarify span|One of the terms|reason=which one?}} of the treaty of Versailles led to ...
=== Parameters ===
There are three parameters to the template:
;{{para|text}}:The text needing clarification. This parameter is mandatory.
;{{para|explain}}:Specifics explaining the clarification that is needed. If omitted, "This passage needs to be better explained" will be used. This text is shown as a [[tooltip]].
;{{para|date}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}:Adds month & year to the category, as well as helping identify how long ago the template was added. If omitted, a bot will eventually add it for you.
== Categorization of articles ==
Adding this template to an article places the article into the hidden categories [[:Category:All Wikipedia articles needing clarification]] and [[:Category:Wikipedia articles needing clarification from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]].
== See also ==
* {{Tl|Clarify}} — detailed information on the usage of this and similar templates
{{Inline tags}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:Coherency templates]]
[[Category:Inline cleanup templates]]
}}</includeonly>
<templatedata>
{
"params": {
"1": {
"aliases": [
"text"
],
"label": "text needing clarification",
"description": "The text needing clarification",
"example": "a vague sentence fragment",
"type": "unbalanced-wikitext",
"required": true
},
"2": {
"aliases": [
"reason",
"explain"
],
"label": "Reason",
"description": "An explanation as to why the text needs to be clarified",
"example": "It's unclear what \"Green Army\" means for unfamiliar readers"
},
"date": {
"label": "Month and year",
"type": "string",
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
"suggested": true
}
}
}
</templatedata>
{{nosubst}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{template shortcut|clarifyspan|clarify-span}}
== Usage ==
The {{tl|clarify span}} template may be used when there is text that needs further explanation or clarification. Unlike the template {{tl|clarify}}, this template attaches explicitly to a portion of text, for example one or more specific sentences, by surrounding the text with the template. This is especially useful for flagging ''multiple facts'' or multiple sentences as needing clarification, and for singling out ''a specific unclear fact'' among many.
Once the passage is clarified, please remove this template from the surrounded text.
:<blockquote>{{tlx|clarify span|text{{=}}<var>Passage(s) needing clarification</var>|explain{{=}}<var>Reason for the needed clarification</var>|date{{=}}<var>{{CURRENTMONTHNAME}} {{CURRENTYEAR}}</var>}}</blockquote>
The date and explain parameters are optional. The parameter names for {{para|text}} and {{para|explain}} can be omitted, as long as the text is in the first position, and the explanation is in the second. Therefore, the minimal syntax is:
:<blockquote>{{tlx|clarify span|<var>Passage(s) needing clarification</var>}}</blockquote>
'''Example of usage:'''
::: <code>... the treaty. {{tlx|clarify span|One of the terms|explain{{=}}which one?}} of the treaty of Versailles led to ...</code>
:produces:
::: ... the treaty. {{clarify span|One of the terms|reason=which one?}} of the treaty of Versailles led to ...
=== Parameters ===
There are three parameters to the template:
;{{para|text}}:The text needing clarification. This parameter is mandatory.
;{{para|explain}}:Specifics explaining the clarification that is needed. If omitted, "This passage needs to be better explained" will be used. This text is shown as a [[tooltip]].
;{{para|date}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}:Adds month & year to the category, as well as helping identify how long ago the template was added. If omitted, a bot will eventually add it for you.
== Categorization of articles ==
Adding this template to an article places the article into the hidden categories [[:Category:All Wikipedia articles needing clarification]] and [[:Category:Wikipedia articles needing clarification from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]].
== See also ==
* {{Tl|Clarify}} — detailed information on the usage of this and similar templates
{{Inline tags}}
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here and interwikis go in Wikidata. -->
[[Category:Coherency templates]]
[[Category:Inline cleanup templates]]
}}</includeonly>
<templatedata>
{
"params": {
"1": {
"aliases": [
"text"
],
"label": "text needing clarification",
"description": "The text needing clarification",
"example": "a vague sentence fragment",
"type": "unbalanced-wikitext",
"required": true
},
"2": {
"aliases": [
"reason",
"explain"
],
"label": "Reason",
"description": "An explanation as to why the text needs to be clarified",
"example": "It's unclear what \"Green Army\" means for unfamiliar readers"
},
"date": {
"label": "Month and year",
"type": "string",
"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
"suggested": true
}
}
}
</templatedata>
