Difference between revisions of "Template:Frac/doc"

From blackwiki
Jump to navigation Jump to search
imported>Crissov
imported>Plastikspork
(Being deleted)
 
(58 intermediate revisions by 29 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
+
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
This template builds an alternative form of [[common fraction]]s. It 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 mathematical articles, per [[MOS:MATH#Fractions]].
+
{{No subst}}
; <code><nowiki>{{frac|A|B|C}}</nowiki></code>: {{frac|A|B|C}} (integer, numerator and denominator)
+
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.  
: <source lang=html4strict><span class="frac">A<sup>&nbsp;B</sup>⁄<sub>C</sub></span></source>
 
; <code><nowiki>{{frac|A|B}}</nowiki></code>: {{frac|A|B}} (numerator and denominator)
 
: <source lang=html4strict><span class="frac"><sup>A</sup>⁄<sub>B</sub></span></source>
 
; <code><nowiki>{{frac|A}}</nowiki></code>: {{frac|A}} (denominator only)
 
: <source lang=html4strict><span class="frac"><sup>1</sup>⁄<sub>A</sub></span></source>
 
  
== Examples ==
+
Please '''do not''' <code>subst:</code>itute it. This template should '''not''' be used in science or mathematical articles, per [[MOS:FRAC]] and [[MOS:MATH#Fractions]]; 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.
 +
;<code><nowiki>{{frac|A|B|C}}</nowiki></code>: {{frac|A|B|C}} (integer, numerator and denominator)
 +
;<code><nowiki>{{frac|A|B}}</nowiki></code>: {{frac|A|B}} (numerator and denominator)
 +
;<code><nowiki>{{frac|A}}</nowiki></code>: {{frac|A}} (denominator only)
 +
;<code><nowiki>{{frac}}</nowiki></code>: {{frac}} (fraction slash only)
 +
 
 +
==Examples==
 
;Numbers: {{frac|2}} {{frac|3}} {{frac|2|3}} {{frac|4}} {{frac|3|4}} {{frac|5}} {{frac|2|5}} {{frac|3|5}} {{frac|4|5}} {{frac|6}} {{frac|5|6}} {{frac|7}} {{frac|2|7}} {{frac|3|7}} {{frac|4|7}} {{frac|5|7}} {{frac|6|7}} {{frac|8}} {{frac|3|8}} {{frac|5|8}} {{frac|7|8}} {{frac|16}} {{frac|3|16}} {{frac|5|16}} {{frac|7|16}} {{frac|9|16}} {{frac|11|16}} {{frac|13|16}} {{frac|15|16}}
 
;Numbers: {{frac|2}} {{frac|3}} {{frac|2|3}} {{frac|4}} {{frac|3|4}} {{frac|5}} {{frac|2|5}} {{frac|3|5}} {{frac|4|5}} {{frac|6}} {{frac|5|6}} {{frac|7}} {{frac|2|7}} {{frac|3|7}} {{frac|4|7}} {{frac|5|7}} {{frac|6|7}} {{frac|8}} {{frac|3|8}} {{frac|5|8}} {{frac|7|8}} {{frac|16}} {{frac|3|16}} {{frac|5|16}} {{frac|7|16}} {{frac|9|16}} {{frac|11|16}} {{frac|13|16}} {{frac|15|16}}
 
;Units: {{frac|m|s}} {{frac|km|h}} {{frac|kg·m|s²}} {{frac|s}} {{frac|Mbit|s}}
 
;Units: {{frac|m|s}} {{frac|km|h}} {{frac|kg·m|s²}} {{frac|s}} {{frac|Mbit|s}}
  
== Deactivation and customization ==
+
==Notes==
Users who prefer to see fractions inline, e.g. „1&nbsp;2⁄3“ instead of „{{frac|1|2|3}}, can turn off the effects of this template by adding the following code to [[Help:User style|their user stylesheet]]:
+
*<code><nowiki>{{frac}}</nowiki></code> or <code>&amp;frasl;</code> may be used to print out the fraction slash glyph " &frasl; ".
<source lang="css">.frac>sup /* numerator */,
+
 
.frac>sub /* denominator */
+
== Parameters ==
{
+
{{TemplateData header}}
  vertical-align: inherit/* or baseline*/;
+
<templatedata>{
  font-size: inherit/* or 1em*/;
+
"description": "A template for displaying common fractions of the form int+num/den nicely. It supports 0–3 anonymous parameters with positional meaning.",
  line-height: inherit/* or 1*/;
+
"params": {
  position: inherit/* or static*/;
+
"1": {
}</source><!--untested-->
+
   "label": "leftmost part",
These selectors and properties can also be used as a base for custom rendering of vulgar fractions:
+
   "description": "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.",
<source lang="css">/* Stacked Fractions (does not work with three parameters currently) */
+
   "type": "string/line",
.frac
+
   "required": false
{
+
},
  display: inline-block;
+
"2": {
   margin-bottom: -0.3em;
+
   "label": "middle-right part",
   vertical-align: 0.8em;
+
  "description": "Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.",
  line-height: 1.2em;
+
   "inherits": "1"
   text-align: center;
+
},
   visibility: hidden;/*hide fraction slash*/
+
"3": {
}
+
   "label": "rightmost part",
.frac>sup /* numerator */,
+
   "description": "Denominator, always.",
.frac>sub /* denominator */
+
   "inherits": "1"
{
 
   vertical-align: inherit;
 
   font-size: 85%;
 
  line-height: inherit;
 
   position: static;
 
   visibility: show;
 
}
 
.frac>sup::after
 
{
 
   content: "\A" /* a line break */
 
 
}
 
}
.frac>sub
+
}}</templatedata>
{
 
  text-decoration: overline;
 
}</source><!--untested-->
 
  
== See also ==
+
==See also==
To allow numerical sorting of a column containing fractions, use {{tl|sortfrac}} instead. It is a combination of this template and {{tl|sort}}.
+
* [[Wikipedia:Rendering math]]
 +
* {{tl|1/2}} ({{1/2}}), {{tl|1/3}}, {{tl|2/3}}, {{tl|1/4}}, {{tl|3/4}} – shorthands that use this template
 +
* {{tl|sfrac}} ({{sfrac|2}}) – displays common fractions using a [[vinculum (symbol)|vinculum]] (horizontal line), for scientific and mathematical text
 +
* {{tl|su}} ({{su|p=superscript|b=subscript}} text) – to align both b=subscript & p=[[superscript]]
 +
* {{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]]
 +
* [[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}}
 +
* {{Unichar|2215|DIVISION SLASH|ulink=Mathematical Operators|html=|nlink=slash (punctuation)#Encoding}}
  
*{{tl|1/2}}, {{tl|1/3}}, {{tl|2/3}}, {{tl|1/4}}, {{tl|3/4}}
+
{{Math templates|notation}}
*{{tl|fraction}}, only uses precomposed glyphs
 
*{{tl|fracText}}, use inline fractions, for use in mathematics articles
 
<includeonly>
 
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
 
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
 
[[Category:Mathematical formatting templates|{{PAGENAME}}]]
 
  
[[ca:Plantilla:Frac]]
+
<includeonly>{{Subpage other||
[[cs:Šablona:Zlomek]]
+
<!-- Categories below this line, please; interwikis at Wikidata -->
[[de:Vorlage:Bruch]]
+
[[Category:Fraction templates]]
[[et:Mall:Murd]]
+
}}</includeonly>
[[es:Plantilla:Fracción]]
 
[[fa:الگو:تقسیم]]
 
[[id:Templat:Frac]]
 
[[ko:틀:분수]]
 
[[hi:साँचा:Frac]]
 
[[is:Snið:Brot]]
 
[[lv:Veidne:Frac]]
 
[[mk:Шаблон:Дроп]]
 
[[nl:Sjabloon:Breuk]]
 
[[no:Mal:Brøk]]
 
[[ja:Template:分数]]
 
[[pl:Szablon:U]]
 
[[pt:Predefinição:Frac]]
 
[[ru:Шаблон:Дробь]]
 
[[simple:Template:Frac]]
 
[[sl:Predloga:Ulomek]]
 
[[zh:Template:Fraction]]
 
</includeonly>
 

Latest revision as of 18:16, 8 January 2021

Template:No subst 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 not be used in science or mathematical articles, per MOS:FRAC and MOS:MATH#Fractions; 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.

{{frac|A|B|C}}
APage Template:Screen reader-only/styles.css has no content. BC (integer, numerator and denominator)
{{frac|A|B}}
AB (numerator and denominator)
{{frac|A}}
1A (denominator only)
{{frac}}
(fraction slash only)

Examples

Numbers
121323143415253545165617273747576718385878116316516716916111613161516
Units
mskmhkg·m1sMbits

Notes

  • {{frac}} or &frasl; may be used to print out the fraction slash glyph " ⁄ ".

Parameters

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Frac

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

Template parameters

ParameterDescriptionTypeStatus
leftmost part1

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.

Lineoptional
middle-right part2

Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.

Lineoptional
rightmost part3

Denominator, always.

Lineoptional

See also