Template:Pars/doc

From Wikipedia, the free encyclopedia

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[edit]

{{Pars|s=200%|Content-inside-parentheses}}(Content-inside-parentheses)

  1. Places ( ) around the content: (Content-inside-parentheses)
  2. Scales their size to 200%
    • You can also use the units px, em, pt, or %
  3. Adds small spaces immediately after ( and immediately before )

Parameters[edit]

This template has the following parameters

  • |1= (positional parameter) - the text that goes inside of the parentheses.
  • |s= or |2= - "s" stands for "size". size=SIZE(px, em, pt, or %. If |s=100% then the size of the parentheses is not changed (i.e. the parentheses have their usual size). If |s=200% (resp. |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 {{Pars|text|50%}} in place of {{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 {{font}} template is made.

Examples[edit]

No arguments passed[edit]

This call {{math|{{pars}}}} produces parentheses.

This call (  ) produces parentheses.

No resizing used and content is passed[edit]

If {{math|{{pars|X}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

Parentheses are resized and no content passed[edit]

If {{math|{{pars|2=210%}} < 0}}, then {{mvar|X}} is negative.

If (  ) < 0, then X is negative.

If {{math|{{pars|s=210%}} < 0}}, then {{mvar|X}} is negative.

If (  ) < 0, then X is negative.

Content is resized but parentheses aren't[edit]

If {{math|{{pars|{{large|X}}}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

Parentheses are resized but content isn't[edit]

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

If (X) < 0, then X is negative.

If {{math|{{pars|X|s=210%}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

Content and parentheses are resized. Using parameter s for size of parentheses[edit]

If {{math|{{pars|{{large|X}}|s=210%}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

Content and parentheses are resized. Passing arguments by their position[edit]

Here we indicate the size of the parentheses (as a percentage) by using parameter position number 2 rather than the named parameter |s=.

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

If (X) < 0, then X is negative.

This is equivalent to the following two lines:

If {{math|{{pars|1={{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

If {{math|{{pars|{{large|X}}|2=210%}} < 0}}, then {{mvar|X}} is negative.

If (X) < 0, then X is negative.

WARNING: in the following line, 1 is first set to {{large|X}} 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.

If {{math|{{pars|1={{large|X}}|210%}} < 0}}, then {{mvar|X}} is negative.

If (210%) < 0, then 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 X as the percentage number to the template {{font}} (this is because the positional parameter 2 is assigned the value {{large|X}}) even though it is not a valid number.

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

It results in the following ill-formed output:

If <span style="font-family:sans-serif;font-size:X;color:black;background-color:transparent;;">(210%<span style="font-family:sans-serif;font-size:X;color:black;background-color:transparent;;">) < 0, then X is negative.

See also[edit]