View source for Template:Pars/doc

{{Documentation subpage}}
This template may be used to enclose text between two parentheses. It adds padding (of width 0.1 em) on each side inside the parentheses. 

== Usage ==
{{tlx|Pars|s{{=}}200%|Content-inside-parentheses|_show_result=yes}}
# Places <code>(  )</code> around the content: (Content-inside-parentheses)
# Scales their size to 200%
#* You can also use the units px, em, pt, or %
# Adds small spaces immediately after ( and immediately before )

== Parameters ==
This template has the following parameters
* {{para|1}} (positional parameter) - the text that goes inside of the parentheses. 
* {{para|s}} or {{para|2}} - "s" stands for "size". size=SIZE（px, em, pt, or %. If {{para|s|100%}} then the size of the parentheses is not changed (i.e. the parentheses have their usual size). If {{para|s|200%}} (resp. {{para|s|50%}}) then the parentheses are twice (resp. half) their usual size. 
** You may use the positional parameter 2 instead of s (e.g. you may use {{tlx|Pars|text|50%}} in place of {{tlx|Pars|text|s{{=}}50%}}).
** If neither the parameter s nor 2 is assigned a value then the size of the parentheses is not changed (i.e. the parentheses have their usual size) ''and'' no call to the {{tl|font}} template is made.

== Examples ==

===No arguments passed===
<syntaxhighlight lang="wikitext>
This call {{math|{{pars}}}} produces parentheses.
</syntaxhighlight>
This call {{math|{{pars}}}} produces parentheses.

===No resizing used and content is passed===
<syntaxhighlight lang="wikitext>
If {{math|{{pars|X}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|X}} < 0}}, then {{mvar|X}} is negative.

===Parentheses are resized and no content passed===
<syntaxhighlight lang="wikitext>
If {{math|{{pars|2=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|2=210%}} < 0}}, then {{mvar|X}} is negative.

<syntaxhighlight lang="wikitext>
If {{math|{{pars|s=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|s=210%}} < 0}}, then {{mvar|X}} is negative.

===Content is resized but parentheses aren't===
<syntaxhighlight lang="wikitext>
If {{math|{{pars|{{large|X}}}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|{{large|X}}}} < 0}}, then {{mvar|X}} is negative.

===Parentheses are resized but content isn't===
<syntaxhighlight lang="wikitext>
If {{math|{{pars|X|210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|X|210%}} < 0}}, then {{mvar|X}} is negative.

<syntaxhighlight lang="wikitext>
If {{math|{{pars|X|s=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|X|s=210%}} < 0}}, then {{mvar|X}} is negative.

===Content and parentheses are resized. Using parameter s for size of parentheses===
<syntaxhighlight lang="wikitext>
If {{math|{{pars|{{large|X}}|s=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|{{large|X}}|s=210%}} < 0}}, then {{mvar|X}} is negative.

===Content and parentheses are resized. Passing arguments by their position===
Here we indicate the size of the parentheses (as a percentage) by using parameter position number 2 rather than the named parameter {{para|s}}. 

<syntaxhighlight lang="wikitext>
If {{math|{{pars|{{large|X}}|210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|{{large|X}}|210%}} < 0}}, then {{mvar|X}} is negative.

This is equivalent to the following two lines: 

<syntaxhighlight lang="wikitext>
If {{math|{{pars|1={{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|1={{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.

<syntaxhighlight lang="wikitext>
If {{math|{{pars|{{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars|{{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.

'''WARNING''': in the following line, 1 is first set to <nowiki>{{large|X}}</nowiki> and then because "210" is the '''''first''' unlabelled'' positional argument, the value of 1 is overwritten and replaced by "210" (which is why 210 appears inside the parentheses) while the positional argument 2 is never assigned a value (which is why the parentheses have their usual size). This is a documented quirk of Wikipedia templates that could occur with many templates that take two or more arguments. 

<syntaxhighlight lang="wikitext>
If {{math|{{pars|1={{large|X}}|210%}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>
If {{math|{{pars<!--|1={{large|X}}-->|210%}} < 0}}, then {{mvar|X}} is negative.

'''WARNING''': the following is '''''NOT''''' valid since it would attempt to place the text "210" inside the parentheses (this is because the positional parameter 1 is assigned the value 210) and then attempt to pass {{large|X}} as the percentage number to the template {{tl|font}} (this is because the positional parameter 2 is assigned the value <nowiki>{{large|X}}</nowiki>) even though it is not a valid number.

<syntaxhighlight lang="wikitext>
If {{math|{{pars|210%|{{large|X}}}} < 0}}, then {{mvar|X}} is negative.
</syntaxhighlight>

It results in the following ill-formed output:

:If <span><span>{{math|{{pars|210%|{{large|X}}}} < 0}}, then {{mvar|X}} is negative.

== See also ==
* {{tl|abs}}
* {{tl|bra-ket}}
* {{tl|math}}
* {{tl|norm}}
* {{tl|pipe}}
* {{tl|langle}} and {{tl|rangle}}

{{Math templates|notation}}

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Mathematical formatting templates]]

}}</includeonly>