Difference between revisions of "Template:Frac/doc"

From blackwiki
Jump to navigation Jump to search
imported>Quondum
(→‎See also: mathematical articles → scientific and mathematical articles (in line with guidelines))
imported>Plastikspork
(Being deleted)
 
(43 intermediate revisions by 25 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]]) -->
 +
{{No subst}}
 
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.  
 
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 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 {{tl|sortfrac}} instead. It is a combination of this template and {{tl|sort}}.
+
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|C}}</nowiki></code>: {{frac|A|B|C}} (integer, numerator and denominator)
:<source lang=html5><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)
 
;<code><nowiki>{{frac|A|B}}</nowiki></code>: {{frac|A|B}} (numerator and denominator)
:<source lang=html5><span class="frac"><sup>A</sup>⁄<sub>B</sub></span></source>
 
 
;<code><nowiki>{{frac|A}}</nowiki></code>: {{frac|A}} (denominator only)
 
;<code><nowiki>{{frac|A}}</nowiki></code>: {{frac|A}} (denominator only)
:<source lang=html5><span class="frac"><sup>1</sup>⁄<sub>A</sub></span></source>
 
 
;<code><nowiki>{{frac}}</nowiki></code>: {{frac}} (fraction slash only)
 
;<code><nowiki>{{frac}}</nowiki></code>: {{frac}} (fraction slash only)
:<source lang=html5><span class="frac">⁄</span></source>
 
  
 
==Examples==
 
==Examples==
Line 17: Line 14:
 
;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 */
 
{
 
  vertical-align: inherit/* or baseline*/;
 
  font-size: inherit/* or 1em*/;
 
  line-height: inherit/* or 1*/;
 
  position: inherit/* or static*/;
 
}</source><!--untested-->
 
<!-- The following would work if the fraction slash was enclosed in a <code>span</code>
 
These selectors and properties can also be used as a base for custom rendering of vulgar fractions:
 
<source lang="css">/* Stacked Fractions */
 
.frac {
 
  display: inline-block;
 
  vertical-align: -0.6em;
 
  font-size: 85%;
 
  text-align: center;
 
}
 
.frac>span /* fraction slash */ {
 
  display: none;
 
}
 
  
.frac>sup /* numerator */,
+
== Parameters ==
.frac>sub /* denominator */ {
+
{{TemplateData header}}
   vertical-align: baseline;
+
<templatedata>{
   line-height: 1.2em;
+
"description": "A template for displaying common fractions of the form int+num/den nicely. It supports 0–3 anonymous parameters with positional meaning.",
  font-size: 1em;
+
"params": {
   position: static;
+
"1": {
   display: block;
+
  "label": "leftmost part",
   padding: 0 0.1em;
+
  "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.",
 +
  "type": "string/line",
 +
  "required": false
 +
},
 +
"2": {
 +
   "label": "middle-right part",
 +
  "description": "Denominator if 2 parameters supplied. Numerator if 3 parameters supplied.",
 +
   "inherits": "1"
 +
},
 +
"3": {
 +
   "label": "rightmost part",
 +
   "description": "Denominator, always.",
 +
   "inherits": "1"
 
}
 
}
.frac>sub {
+
}}</templatedata>
  border-top: 1px solid;
 
}
 
 
 
</source>-->
 
 
 
== Code ==
 
 
 
<source lang=html5>
 
<span class="frac nowrap">{{#if:{{{3|}}}
 
|{{{1}}}<sup>&#32;{{{2}}}</sup>&frasl;<sub>{{{3}}}</sub>
 
|{{#if:{{{2|}}}
 
  |<sup>{{{1}}}</sup>&frasl;<sub>{{{2}}}</sub>
 
  |{{#if:{{{1|}}}
 
  |<sup>1</sup>&frasl;<sub>{{{1}}}</sub>
 
  |&frasl;
 
  }}
 
}}
 
}}</span>
 
</source>
 
 
 
==Notes==
 
*<code>&amp;frasl;</code> may be used to print out the fraction glyph " &frasl; "
 
  
 
==See also==
 
==See also==
*{{tl|1/2}} ({{1/2}}), {{tl|1/3}}, {{tl|2/3}}, {{tl|1/4}}, {{tl|3/4}}, shorthands
+
* [[Wikipedia:Rendering math]]
*{{tl|fraction}} ({{fraction|2}}), only uses precomposed glyphs, which usually is not preferred due to accessibility concerns
+
* {{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]], which is preferable for scientific and mathematical articles.
+
* {{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}}
  
<includeonly>
+
{{Math templates|notation}}
<!--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:الگو:تقسیم]]
 
[[gan:Template:Frac]]
 
[[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