Template:Tone indicator/doc: Difference between revisions

Content deleted Content added
expanding
always valid
 
(22 intermediate revisions by 8 users not shown)
Line 1:
{{Documentation subpage}}
{{Template shortcut|tind}}
{{Subst only|auto=yes}}
 
This template displays [[tone indicator]]s, an indicator to explicitly state the intonation or intent of the message, for use in discussions, '''not''' in articles.
 
== Usage ==
This template implements [[tone indicators]], a symbol to explicitly state the intonation or intent of the message, for use in discussions.
Tone indicators are generally appended to messages (or sentences) to reflect the intonation/intent of the content preceding them.
 
=== But why?Example ===
<code>I love vandalism! <nowiki>{{Tone indicator|s}}</nowiki></code>
Inferring meaning, tone and intent of a textual message over the internet can be ''difficult'' at times, especially in heated situations or when the wording could easily mean many things.
 
would produce
Some contributors can find this inference especially difficult (such as our many [[Neurodiversity|neurodivergent]] editors) - the use of indicators to explicitly state your tone is one thing you can do to help ''everyone'' out in certain circumstances.
 
"I love vandalism! {{Tone indicator|s}}"
More information can be found in our article on [[tone indicators]], and at {{plain link|https://toneindicators.carrd.co/#introduction www.toneindicators.carrd.co}}.
 
==Examples= Options ===
{| class="wikitable"
! Available parameters
|+
! Output
!Parameter(s) to use
!Example
!Output
|-
| {{code|scon}}, {{code|sarcasmconcerned}}
|This is a sarcastic comment {{tls|Tone indicator|sarcasmcon}}
|This is a sarcastic comment {{#switch:sarcasm
|s
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|pc
|pos
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|nc
|neg
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|j
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
|g
|gen
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
|lh
|light-hearted
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
<!-- We default to sarcasm because of course we do -->
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
}}
|-
| {{code|pcg}}, {{code|posgen}}, {{code|positivegenuine}}
|I mean this in a positive way {{tls|Tone indicator|posgen}}
|I mean this in a positive way {{#switch:pos
|s
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|pc
|pos
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|nc
|neg
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|j
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
|g
|gen
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
|lh
|light-hearted
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
<!-- We default to sarcasm because of course we do -->
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
}}
|-
| {{code|ncgq}}, {{code|neggenq}}, {{code|negativegenuine question}}
|I really do mean this in a negative way {{tls|Tone indicator|neggq}}
|I really do mean this in a negative way {{#switch:neg
|s
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|pc
|pos
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|nc
|neg
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|j
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
|g
|gen
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
|lh
|light-hearted
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
<!-- We default to sarcasm because of course we do -->
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
}}
|-
| {{code|jhj}}, {{code|jokehalf-joking}}
|I only mean this as a joke! {{tls|Tone indicator|jokehj}}
|I only mean this as a joke! {{#switch:joke
|s
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|pc
|pos
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|nc
|neg
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|j
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
|g
|gen
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
|lh
|light-hearted
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
<!-- We default to sarcasm because of course we do -->
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
}}
|-
|{{code|g}}, {{code|genhyp}}, {{code|genuinehyperbole}}
|I mean this genuinely {{tls|Tone indicator|genhyp}}
|I mean this genuinely {{#switch:gen
|s
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|pc
|pos
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|nc
|neg
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|j
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
|g
|gen
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
|lh
|light-hearted
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
<!-- We default to sarcasm because of course we do -->
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
}}
|-
| {{code|lhj}}, {{code|light-heartedjoke}}, {{code|lightheartedjoking}}
|This is a light-hearted comment {{tls|Tone indicator|lhjoke}}
|-
|This is a light-hearted comment {{#switch:lh
| {{code|lh}}, {{code|lighthearted}}, {{code|light-hearted}}
|s
| {{Tone indicator|lh}}
|sarcasm =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
|-
|pc
| {{code|lhj}}, {{code|lighthearted joke}}, {{code|light-hearted joke}}
|pos
| {{Tone indicator|lhj}}
|positive =<span title='positive tone'>/[[:wikt:positive|pos]]</span>
|-
|nc
| {{code|nay}}, {{code|not at you}}
|neg
| {{Tone indicator|nay}}
|negative =<span title='negative tone'>/[[:wikt:negative|neg]]</span>
|-
|j
| {{code|nbh}}, {{code|nobody here}}
|joke =<span title='joke'>/[[:wikt:joke|j]]</span>
| {{Tone indicator|nbh}}
|g
|-
|gen
| {{code|neg}}, {{code|nc}}, {{code|negative}}
|genuine =<span title='genuine tone'>/[[:wikt:genuine|gen]]</span>
| {{Tone indicator|neg}}
|lh
|-
|light-hearted
| {{code|nm}}, {{code|not mad}}
|lighthearted =<span title='lighthearted tone'>/[[:wikt:lighthearted|lh]]</span>
| {{Tone indicator|nm}}
<!-- We default to sarcasm because of course we do -->
|-
|#default =<span title='sarcastic tone'>/[[:wikt:sarcasm|s]]</span>
| {{code|nsrs}}, {{code|not serious}}, {{code|non-serious}}
}}
| {{Tone indicator|nsrs}}
|-
| {{code|pos}}, {{code|pc}}, {{code|positive}}
| {{Tone indicator|pos}}
|-
| {{code|ref}}, {{code|reference}}
| {{Tone indicator|ref}}
|-
| {{code|s}}, {{code|sarc}}, {{code|sarcasm}}
| {{Tone indicator|sarcasm}}
|-
| {{code|srs}}, {{code|serious}}
| {{Tone indicator|srs}}
|}
 
=== TemplateData ===
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "Tone indicator",
"description": "The tone indicator to display, or a valid alias",
"example": "s",
"type": "string",
"default": "s",
"required": true,
"suggestedvalues": [
"con",
"g",
"gq",
"hj",
"hyp",
"j",
"lh",
"lhj",
"nay",
"nbh",
"neg",
"nm",
"nsrs",
"pos",
"ref",
"s",
"srs"
]
}
},
"description": "Displays a tone indicator with hover description"
}
</templatedata>
 
== IndicatorsBut why? ==
Inferring meaning, tone and intent of a textual message over the internet can be ''difficult'' at times, especially in heated situations or when the wording could easily mean many things.
=== Sarcasm ===
{{wti|Sarcasm}}
 
=== Positive ===
{{wti|Positive}}
 
Some contributors can find this inference especially difficult (such as our many [[Neurodiversity|neurodivergent]] editors) - the use of indicators to explicitly state your tone is one thing you can do to help ''everyone'' out in certain circumstances.
=== Negative ===
{{wti|Negative}}
 
=== Joke ===
{{wti|Joke}}
 
=== Genuine ===
{{wti|Genuine}}
 
More information can be found in the article on [[tone indicators]], and at {{plain link|https://toneindicators.carrd.co/#introduction www.toneindicators.carrd.co}}.
=== Light-hearted ===
<includeonly>{{Sandbox other||
{{wti|Lighthearted}}
[[Category:Talk namespace templates]]
}}</includeonly>