មើលកូដរបស់ ទំព័រគំរូ:Math/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

The '''math''' template formats HTML- or wikimarkup generated mathematical formulas in the similar fashion as [[MathJax]], a web-based [[TeX]] formula interpreter. The template uses the <code>texhtml</code> class, which aims to match the size of the serif font with the surrounding sans-serif font (see below). The template also prevents line-wrapping.

Use this template for non-complex formulas as an alternative to using the {{tag|math}} format (see: [[Help:Math]]).

== Usage ==

Use this template to wrap an inline formula in wikitext.

=== Examples ===
<pre>
{{math|''f''(''x'') {{=}} ''b''<sup>''x''</sup> {{=}} ''y''}}
</pre>
: produces: {{math|''f''(''x'') {{=}} ''b''<sup>''x''</sup> {{=}} ''y''}}
<pre>
{{math|sin &amp;pi; {{=}} 0}}
</pre>
: produces: {{math|sin &pi; {{=}} 0}}.

<pre>
{{math|{{intmath|int|0|+&amp;infin;}} ''e''<sup>−''x''</sup> d''x'' {{=}} 1}}
</pre>
: produces: {{math|{{intmath|int|0|+&infin;}} ''e''<sup>−''x''</sup> d''x'' {{=}} 1}}

<pre>
'''{{math|{{sfrac|1|2}} − {{sfrac|1|3}} {{=}} {{sfrac|1|6}}}}'''
</pre>
: produces: '''{{math|{{sfrac|1|2}} − {{sfrac|1|3}} {{=}} {{sfrac|1|6}}}}'''.  Note the triple-apostrophes have set the whole formula as bold.

<pre>
{{math|({{sqrt|2}})<sup>2</sup> {{=}} 2}}
</pre>
: produces: {{math|({{sqrt|2}})<sup>2</sup> {{=}} 2}}.

===Use of equals-sign and absolute value bars===

If a single equals-sign ("=") is used, it will fail to render, instead showing "<nowiki>{{{1}}}</nowiki>". For example, the following template-coding would be invalid:

<pre>{{math|1 + 2 = 3}}</pre>
: produces: {{math|1 + 2 = 3}}, which is invalid code

To resolve this, either: (a) Start the formula with "<code>1=</code>" as in:
<pre>{{math|1=1 + 2 = 3}}</pre>
: produces: {{math|1=1 + 2 = 3}}, or else, (b) include the equals-sign in double-braces <nowiki>"{{=}}"</nowiki> as in:
<pre>{{math|1 + 2 {{=}} 3}}</pre>
: produces: {{math|1 + 2 {{=}} 3}}.

A similar difficulty concerns the vertical bars ("|") used to indicate absolute value, which without care would get interpreted as part of the template syntax. The solution is different than for the equals sign: such bars should be entered as "<nowiki>{{!}}</nowiki>":
<pre>{{math|{{!}}''f''(''x'') − ''a''{{!}} < ε}}</pre>
: produces: {{math|{{!}}''f''(''x'') − ''a''{{!}} < ε}}.

This example can also be produced by the following:
<pre><nowiki>{{math|{{mabs|''f''(''x'') − ''a''}} < ε}}</nowiki></pre>
: produces: {{math|{{mabs|''f''(''x'') − ''a''}} < ε}}

=== Parameters ===

The following parameters are optional:
* <code>big=1</code> – This will render the formula in a bigger fontsize, increased to 165%.
* <code>size=''font-size''</code> – Use this to specify your own fontsize.
<pre>
<nowiki>{{math|big=1|1 + 2 {{=}} 3}}</nowiki>
</pre>
: produces: {{math|big=1|1 + 2 {{=}} 3}}

=== TemplateData ===
{{TemplateDataHeader}}
<templatedata>{
"description": "This template formats markup generated mathematical formulas with HTML and CSS. The template tries to match the size of the serif font with the surrounding sans-serif font. The template also prevents line-wrapping. Use this template for non-complex formulas as an alternative to using the <math> format.",
"params": {
  "1": {
    "label": "formula",
    "description": "wrap an inline formula in wikitext.",
    "type": "string",
    "required": true
  },
  "big": {
    "label": "bigger font size",
    "description": "if set to ‘1’, this will render the formula in a bigger font size, increased to 165%",
    "type": "string",
    "required": false
  },
  "size": {
    "label": "custom font size",
    "description": "use this to specify your own font size",
    "type": "string",
    "required": false
  }
}}</templatedata>

== Notes ==

The font and fontsize used for <code>texhtml</code>, as defined in [[MediaWiki:Common.css]], was determined by comparing common default fonts found on Windows, OS X and Linux and is scaled to 118% to match their [[x-height]]. However, not everyone uses the default fonts. If you find that the rendered math is not of the same size as the surrounding text, you can adjust this in your personal CSS. For instance, the DejaVu Sans and DejaVu Serif fonts do ''not'' need scaling, in which case <code>span.texhtml { font-size: 100%; }</code> will restore proper display.

The <code>texhtml</code> classname is a remnant from the {{TeX}} renderer, which had a user preference to render {{TeX}}-written formulae in "HTML when simple". That option has been removed some time ago, but the classname continues to be used for formulae written in HTML.

== See also ==

;Help and information

* [[Help: Displaying a formula]]
* [[WP:«math»]], a comparison of different representation of mathematical expressions

;Related templates
{{Math templates}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Mathematical formatting templates]]

</includeonly>