Template:Fraction/doc: Difference between revisions

Content deleted Content added

Inline

Revision as of 09:27, 27 June 2024

This is a documentation subpage for Template:Fraction.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 38,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses TemplateStyles:

Template:Fraction/styles.css (sandbox)

This template builds an alternative form of common fractions. The template takes one, two, or three parameters: the optional integer (may be signed), the optional numerator and the required denominator; in this order.

Please do not subst:itute it. This template should also not be used in certain situations; see MOS:FRAC and MOS:MATH § Fractions. For science or mathematical articles, use {{sfrac}} instead. To allow numerical sorting of a column containing fractions, use data-sort-value="X.YYY" where X.YYY is a rounded decimal equivalent. See Help:Sorting for more information and options. Inside citation templates, use the cleaner {{citefrac}}.

{{fraction|A|B|C}}: A+B⁄C (integer, numerator and denominator)
{{fraction|B|C}}: B⁄C (numerator and denominator)
{{fraction|C}}: 1⁄C (denominator only)
{{fraction}}: ⁄ (fraction slash only)

Examples

Numbers: 1⁄2, 1⁄3, 2⁄3, 1⁄4, 3⁄4, 1⁄5, 2⁄5, 3⁄5, 4⁄5, 1⁄6, 5⁄6, 1⁄7, 2⁄7, 3⁄7, 4⁄7, 5⁄7, 6⁄7, 1⁄8, 3⁄8, 5⁄8, 7⁄8, 1⁄16, 3⁄16, 5⁄16, 7⁄16, 9⁄16, 11⁄16, 13⁄16, 15⁄16
Units: m⁄s, km⁄h, kg·m⁄s², 1⁄s, Mbit⁄s

Notes

{{fraction}} or &frasl; may be used to print out the fraction slash glyph " ⁄ ".
For mixed fractions, in some contexts (like link targets) a "+" is generated between the whole number part and fraction part. If this is not desirable, put the whole number part outside the template, and put a non-breaking space between when the spacing is desirable. For example: "33 {{frac|1|3}}".

Parameters

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Fraction in articles based on its TemplateData.

TemplateData for Fraction

A template for displaying common fractions of the form int+num/den nicely. It supports 0–3 anonymous parameters with positional meaning.

Template parameters
Parameter		Description	Type	Status
leftmost part	`1`	Denominator if only parameter supplied. Numerator if 2 parameters supplied. Integer if 3 parameters supplied. If no parameter is specified the template will render a fraction slash only.	Line	optional
middle-right part	`2`	Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.	Line	optional
rightmost part	`3`	Denominator, always.	Line	optional

@@ Line 6: / Line 6: @@
 This template builds an alternative form of [[common fraction]]s. The template takes one, two, or three parameters: the optional integer (may be signed), the optional numerator and the required denominator; in this order.
-Please '''do not''' <code>subst:</code>itute it. This template should '''not''' be used in certain situations; see [[MOS:FRAC]] and {{slink|MOS:MATH#Fractions}}. For science or mathematical articles, use {{tl|sfrac}} instead. To allow numerical sorting of a column containing fractions, use <code>data-sort-value="X.YYY"</code> where <code>X.YYY</code> is a rounded decimal equivalent.  See [[Help:Sorting]] for more information and options. Inside citation templates, use the cleaner {{tl|citefrac}}.
+Please '''do not''' <code>subst:</code>itute it. This template should also ''not'' be used in certain situations; see [[MOS:FRAC]] and {{slink|MOS:MATH#Fractions}}. For science or mathematical articles, use {{tl|sfrac}} instead. To allow numerical sorting of a column containing fractions, use <code>data-sort-value="X.YYY"</code> where <code>X.YYY</code> is a rounded decimal equivalent.  See [[Help:Sorting]] for more information and options. Inside citation templates, use the cleaner {{tl|citefrac}}.
-;<code><nowiki>{{fraction|A|B|C}}</nowiki></code>: {{fraction|A|B|C}} (integer, numerator and denominator)
+; <code><nowiki>{{fraction|A|B|C}}</nowiki></code> : {{fraction|A|B|C}} (integer, numerator and denominator)
-;<code><nowiki>{{fraction|A|B}}</nowiki></code>: {{fraction|A|B}} (numerator and denominator)
+; <code><nowiki>{{fraction|B|C}}</nowiki></code> : {{fraction|B|C}} (numerator and denominator)
-;<code><nowiki>{{fraction|A}}</nowiki></code>: {{fraction|A}} (denominator only)
+; <code><nowiki>{{fraction|C}}</nowiki></code> : {{fraction|C}} (denominator only)
-;<code><nowiki>{{fraction}}</nowiki></code>: {{fraction}} (fraction slash only)
+; <code><nowiki>{{fraction}}</nowiki></code> : {{fraction}} (fraction slash only)
 == Examples ==
+<!--the fractions are separated by commas that are only visible to screen readers because they do not read out the space separators here-->
-;Numbers: {{fraction|2}} {{fraction|3}} {{fraction|2|3}} {{fraction|4}} {{fraction|3|4}} {{fraction|5}} {{fraction|2|5}} {{fraction|3|5}} {{fraction|4|5}} {{fraction|6}} {{fraction|5|6}} {{fraction|7}} {{fraction|2|7}} {{fraction|3|7}} {{fraction|4|7}} {{fraction|5|7}} {{fraction|6|7}} {{fraction|8}} {{fraction|3|8}} {{fraction|5|8}} {{fraction|7|8}} {{fraction|16}} {{fraction|3|16}} {{fraction|5|16}} {{fraction|7|16}} {{fraction|9|16}} {{fraction|11|16}} {{fraction|13|16}} {{fraction|15|16}}
+; Numbers : {{fraction|2}}{{sronly|,}} {{fraction|3}}{{sronly|,}} {{fraction|2|3}}{{sronly|,}} {{fraction|4}}{{sronly|,}} {{fraction|3|4}}{{sronly|,}} {{fraction|5}}{{sronly|,}} {{fraction|2|5}}{{sronly|,}} {{fraction|3|5}}{{sronly|,}} {{fraction|4|5}}{{sronly|,}} {{fraction|6}}{{sronly|,}} {{fraction|5|6}}{{sronly|,}} {{fraction|7}}{{sronly|,}} {{fraction|2|7}}{{sronly|,}} {{fraction|3|7}}{{sronly|,}} {{fraction|4|7}}{{sronly|,}} {{fraction|5|7}}{{sronly|,}} {{fraction|6|7}}{{sronly|,}} {{fraction|8}}{{sronly|,}} {{fraction|3|8}}{{sronly|,}} {{fraction|5|8}}{{sronly|,}} {{fraction|7|8}}{{sronly|,}} {{fraction|16}}{{sronly|,}} {{fraction|3|16}}{{sronly|,}} {{fraction|5|16}}{{sronly|,}} {{fraction|7|16}}{{sronly|,}} {{fraction|9|16}}{{sronly|,}} {{fraction|11|16}}{{sronly|,}} {{fraction|13|16}}{{sronly|,}} {{fraction|15|16}}
-;Units: {{fraction|m|s}} {{fraction|km|h}} {{fraction|kg·m|s²}} {{fraction|s}} {{fraction|Mbit|s}}
+; Units : {{fraction|m|s}}{{sronly|,}} {{fraction|km|h}}{{sronly|,}} {{fraction|kg·m|s<sup>2</sup>}}{{sronly|,}} {{fraction|s}}{{sronly|,}} {{fraction|Mbit|s}}
 == Notes ==
 * <code><nowiki>{{fraction}}</nowiki></code> or <code>&amp;frasl;</code> may be used to print out the fraction slash glyph " &frasl; ".
-* For mixed fractions, in some contexts a "+" is generated between the whole number part and fraction part. If this is not desirable, put the whole number part outside the template and put a [[non-breaking space]] between. For example: "<nowiki>33&amp;nbsp;{{frac|1|3}}</nowiki>".
+* For mixed fractions, in some contexts (like link targets) a "+" is generated between the whole number part and fraction part. If this is not desirable, put the whole number part outside the template, and put a [[non-breaking space]] between when the spacing is desirable. For example: "<nowiki>33&amp;nbsp;{{frac|1|3}}</nowiki>".
 == Parameters ==
@@ Line 51: / Line 52: @@
 * {{tl|sub}} ({{sub|subscript}} text) – to show a [[subscript]]
 * {{tl|sup}} ({{sup|superscript}} text) – to show a [[superscript]]
-* [[Help:Displaying a formula#Fractions, matrices, multilines]]
+* {{Section link|Help:Displaying a formula|Fractions, matrices, multilines}}
-* [[Help:Convert#Fractions]]
+* {{Section link|Help:Convert|Fractions}}
 * [[Number Forms]], a Unicode block consisting primarily of vulgar fractions
 * [[OpenType]] fonts feature ''frac'', [[CSS]] {{code|font-variant-numeric:diagonal-fractions|css}}

Revision as of 09:27, 27 June 2024

Examples

Notes

Parameters

See also