View source for Template:Chem2/doc

{{documentation subpage}}{{Lua|Module:Chem2}}
{{二次利用}}
{{tl|chem2}} is a template used to format a [[chemical formula]] or [[Chemical equation|equation]].

== Use ==
{| class="wikitable"
|-
! Symbol
! Gives
! Example
! Output
|-
| <code>\s</code> || {{chem2|\s}} || <code><nowiki>{{chem2|CH3\sCH3}}</nowiki></code> || {{chem2|CH3\sCH3}}
|-
| <code>\d</code> || {{chem2|\d}} || <code><nowiki>{{chem2|CH2\dCH2}}</nowiki></code> || {{chem2|CH2\dCH2}}
|-
| <code>\t</code> || {{chem2|\t}}  || <code><nowiki>{{chem2|HC\tCH}}</nowiki></code> || {{chem2|HC\tCH}}
|-
| <code>\q</code> || {{chem2|\q}}  || <code><nowiki>{{chem2|[Cl4Re\qReCl4](2−)|}}</nowiki></code> || {{chem2|[Cl4Re\qReCl4](2−)|}}
|-
| <code>\-</code> || {{chem2|\-}} || ||
|-
| <code>\\</code> || {{chem2|\\}} || ||
|-
| <code>\h</code> || {{chem2|\h}} || ||
|-
| <code>\h{1}</code> || {{chem2|\h{1}|}} || ||
|-
| <code>\m{1}</code> || {{chem2|\m{1}|}} || ||
|-
| <code>-></code> || {{chem2| ->}} || <code><nowiki>{{chem2|2H2 + O2 -> 2H2O}}</nowiki></code> || {{chem2|2H2 + O2 -> 2H2O}}
|-
| <code><-></code> || {{chem2| <->}} || ||
|-
| <code>*</code> || {{chem2|*}} || <code><nowiki>{{chem2|CoCl2*6H2O}}</nowiki></code> || {{chem2|CoCl2*6H2O}}
|-
| <code>\*</code> || * || <code><nowiki>{{chem2|Cp\*2Fe}}</nowiki></code> || {{chem2|Cp\*2Fe}}
|-
| <code>_{}</code> || || <code><nowiki>{{chem2|CH4_{(g)}|}}</nowiki></code> <span id="why-vert-bar">[[#vert-bar-explained|{{sup|*}}]]</span> || {{chem2|CH4_{(g)}|}} 
|-
| <code>^{}</code> || || <code><nowiki>{{chem2|^{13}CH4}}</nowiki></code> || {{chem2|^{13}CH4}}
|-
| <code>&amp;nabla;</code> || {{chem2|&nabla;}} || <code><nowiki>{{chem2|&amp;nabla;}}</nowiki></code> || {{chem2|&nabla;}}
|}

<p id="vert-bar-explained"><small>[[#why-vert-bar|'''^''']] If the last character of the template input is <code><nowiki>}</nowiki></code>, MediaWiki will confuse it with the end-of-template tag <code><nowiki>}}</nowiki></code>. Adding <code><nowiki>&#124;</nowiki></code> between the two resolves this ambiguity.  Other options include instead inserting <code><nowiki> </nowiki></code> (space), <code><nowiki>{{null}}</nowiki></code> or <code><nowiki><nowiki/></nowiki></code>.</small></p>

Formulas (without charge) are just written. Eg.:
* <code><nowiki>{{chem2|CH3(CH2)5CH3}}</nowiki></code> gives  {{chem2|CH3(CH2)5CH3}} 
* <code><nowiki>{{chem2|Fe3S2(CO)9}}</nowiki></code> gives {{chem2|Fe3S2(CO)9}}
* <code><nowiki>{{chem2|C_{''n''}H_{2''n''+2}|}}</nowiki></code> gives {{chem2|C_{''n''}H_{2''n''+2}|}}

Charges are written inside parenthesis, otherwise it's treated as +1 or −1, e.g.:
* <code><nowiki>{{chem2|Na+}}</nowiki></code> gives {{chem2|Na+}}
* <code><nowiki>{{chem2|O2-}}</nowiki></code> gives {{chem2|O2-}} but can be written as <code><nowiki>{{chem2|O2(-)}}</nowiki></code> too.
* <code><nowiki>{{chem2|SO4(2-)}}</nowiki></code> gives {{chem2|SO4(2-)}} 
* <code><nowiki>{{chem2|S19(2+)}}</nowiki></code> gives {{chem2|S19(2+)}} 

Chemical equations can be written too. E.g.:
* <code><nowiki>{{chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}}</nowiki></code> gives {{chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}}
* <code><nowiki>{{chem2|2S + 3O2 + 2H2O -> 2H2SO4}}</nowiki></code> gives {{chem2|2S + 3O2 + 2H2O -> 2H2SO4}}
The arrows can be written as <code>-></code> or just <code>→</code>. All characters (and unicode markup) are valid input except <code>\</code>, = (Mediawiki use it), <code>_</code> and <code>-</code> (endash etc.)
* <code><nowiki>{{chem2|2 H2_{(g)} + O2_{(g)} -> 2H2O_{(g)}|}}</nowiki></code> gives {{chem2|2 H2_{(g)} + O2_{(g)} -> 2H2O_{(g)}|}}
* <code><nowiki>{{chem2|NH2RCHCO2H <-> NH3+RCHCO2-}}</nowiki></code> gives {{chem2|NH2RCHCO2H <-> NH3+RCHCO2-}}

[[Hapticity]] and mu:
* <code><nowiki>{{chem2|W(CO)3(PiPr3)2(\h{2}H2)}}</nowiki></code> gives {{chem2|W(CO)3(PiPr3)2(\h{2}H2)}}
* <code><nowiki>{{chem2|auto=yes|W(CO)3(PiPr3)2(\h{2}H2)}}</nowiki></code> gives {{chem2|auto=yes|W(CO)3(PiPr3)2(\h{2}H2)}}

Links: Use <code><nowiki>link=</nowiki></code><wiki page> or ordinary wiki link (<code><nowiki>[[</nowiki></code> and <code><nowiki>]]</nowiki></code>), e.g.:
* <code><nowiki>{{chem2|link=Iron(III) chloride|FeCl3}}</nowiki></code> gives {{chem2|link=Iron(III) chloride|FeCl3}}
* <code><nowiki>{{chem2|3[[hydrogen|H2]] + 2[[nitrogen|N2]] <-> 2[[ammonia|NH3]]}}</nowiki></code> gives {{chem2|3[[hydrogen|H2]] + 2[[nitrogen|N2]] <-> 2[[ammonia|NH3]]}}

Auto links: Automatic link elements: Use <code><nowiki>auto=</nowiki></code><something> (e.g. <code><nowiki>yes</nowiki></code>):
* <code><nowiki>{{chem2|auto=yes|CH3CH2CH3CBrFCIClCH3}}</nowiki></code> gives {{chem2|auto=yes|CH3CH2CH3CBrFCIClCH3}}

== Examples ==
* <code><nowiki>{{chem2|[Cl4Re\qReCl4](2−)|}}</nowiki></code> gives {{chem2|[Cl4Re\qReCl4](2−)|}}
* <code><nowiki>{{chem2|[Cl4Re\qReCl4](2-)|}}</nowiki></code> gives {{chem2|[Cl4Re\qReCl4](2-)|}}
* <code><nowiki>{{chem2|NH2RCHCO2H <-> NH3+RCHCO2−}}</nowiki></code> gives {{chem2|NH2RCHCO2H <-> NH3+RCHCO2−}}
----
* <code><nowiki>{{chem2|\\hallo}}</nowiki></code> gives {{chem2|\\hallo}}
* <code><nowiki>{{chem2|H3CC\tCH <-> H2C\dC\dCH2}}</nowiki></code> gives {{chem2|H3CC\tCH <-> H2C\dC\dCH2}}
* <code><nowiki>{{chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}}</nowiki></code> gives {{chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}}
----
* "H2O &amp;#8594; H2O" is {{chem2|H2O &#8594; H2O}}
* "H2O_{(l)} -> H2O_{(g)}" is {{chem2|H2O_{(l)} -> H2O_{(g)}|}}
----
* "4 NH3 + 5 O2 → 4 NO + 6 H2O" is {{chem2|4 NH3 + 5 O2 → 4 NO + 6 H2O}}
* " 4 NH3 + 5 O2 → 4 NO + 6 H2O" is {{chem2| 4 NH3 + 5 O2 → 4 NO + 6 H2O}}
* " 4NH3 + 5O2 → 4NO + 6H2O" is {{chem2| 4NH3 + 5O2 → 4NO + 6H2O}}
* " 2Mn2(+)" is {{chem2| 2Mn2(+)}}
* " 2Mn2(+) + 3H2O" is {{chem2| 2Mn2(+) + 3H2O}}
* Mn– is {{chem2|Mn–}}
----
* Mn2(2-) is {{chem2|Mn2(2-)}}
* Mn2☃+ is {{chem2|Mn2☃+}}, Mn2(2–) is {{chem2|Mn2(2–)}}, Mn2(2☃–) is {{chem2|Mn2(2☃–)}}
* Mn2(+) is {{chem2|Mn2(+)}}
* Mn2+ is {{chem2|Mn2+}}
* Mn2(-) is {{chem2|Mn2(-)}}
* Mn2- is {{chem2|Mn2-}}
----
*<nowiki>{{chem2|C_{''n''}H_{2''n''&nbsp;+&nbsp;2}|}}</nowiki> gives {{chem2|C_{''n''}H_{2''n''&nbsp;+&nbsp;2}|}}
*<nowiki>{{chem2|C_{abc}|}}</nowiki> gives {{chem2|C_{abc}|}}
*(chem gives {{chem|C|''n''|H|2''n''&nbsp;+&nbsp;2}})
*<nowiki>{{chem2|CoCl2*1.5H2O}}</nowiki> gives {{chem2|CoCl2*1.5H2O}}
*Mn22– is {{chem2|Mn22–}}
* Cu2C2*H2O is {{chem2|Cu2C2*H2O}} 
----
;Special

*<nowiki>{{chem2|[Me2Al(\m{2}Me)]2}}</nowiki> gives {{chem2|[Me2Al(\m{2}Me)]2}}
*<nowiki>{{chem2|^{13}CO2}}</nowiki> gives {{chem2|^{13}CO2}}
*<nowiki>{{chem2|auto=yes|^{13}CO2}}</nowiki> gives {{chem2|auto=yes|^{13}CO2}}
*<nowiki>{{chem2|\h{5}(C5H5)2TiCl2}}</nowiki> gives {{chem2|\h{5}(C5H5)2TiCl2}}
*<nowiki>{{chem2|\h{5}\s(C5H5)}}</nowiki> gives {{chem2|\h{5}\s(C5H5)}}
*<nowiki>{{chem2|CH2\dCH2\sCH2\sC\tCH\qMn}}</nowiki> is {{chem2|CH2\dCH2\sCH2\sC\tCH\qMn}}
----
*<nowiki>{{chem2|RC(OR’)3}}</nowiki> gives {{chem2|RC(OR’)3}}
*<nowiki>{{chem2|C\\C}}</nowiki> gives {{chem2|C\\C}}
*<nowiki>{{chem2|C2*NH3}}</nowiki> gives {{chem2|C2*NH3}}
*<nowiki>{{chem2|C2*2NH3}}</nowiki> gives {{chem2|C2*2NH3}}
*<nowiki>{{chem2|C1.2H3.5}}</nowiki> gives {{chem2|C1.2H3.5}}
----
* <nowiki>{{chem2|12|6|C}}</nowiki> is {{chem2|12|6|C}}
* <nowiki>{{chem2|12|C}}</nowiki> is {{chem2|12|C}}
* <nowiki>{{chem2|CH3\i{13}CH2CH3}}</nowiki> is {{chem2|CH3\i{13}CH2CH3}}
* <nowiki>{{chem2|\{\{abc\}\}}}</nowiki> is {{chem2|\b\bAbC\e\e}}
* C2(μ\-C) is {{chem2|C2(μ\-C) }}
----
* SO4(2-) is {{chem2|SO4(2-)}}
* 2Mn2(2+) is {{chem2|2Mn2(2+)}}
* CH3-CH2-OH is {{chem2|CH3-CH2-OH}}
* [ZnCl4]- is {{chem2|[ZnCl4]-}}
* [ZnCl4](2-) is {{chem2|[ZnCl4](2-)}}
* AUTO: ((H2O)5{CoCl2})2 is {{chem2|auto=yes|((H2O)5{CoCl2})2}}
* Si(OH)4 is {{chem2|Si(OH)4}}
----
* AUTO: Cu2C2*H2O is {{chem2|auto=yes|Cu2C2*H2O}} 
* Cu2C2*2H2O is {{chem2|Cu2C2*2H2O}} 
* CuSO*2H2O is {{chem2|CuSO*2H2O}} 
* CuSO4*15H2O is {{chem2|CuSO4*15H2O}} 
* CuSO4(H2O)5 is {{chem2|CuSO4(H2O)5}} 
* H+ + OH- → H2O is {{chem2|H+ + OH- → H2O}}
* H → O is {{chem2|H → O }}
----
* ZxPo4 is {{chem2|ZxPo4}}        &nbsp;&nbsp;&nbsp;&nbsp;Unknown element.
* ((Na)Cl is {{chem2|((Na)Cl}}      &nbsp;&nbsp;&nbsp;&nbsp;Too many "(".
* Si(OH))4 is {{chem2|Si(OH))4}}     &nbsp;&nbsp;&nbsp;&nbsp;Too many ")".
* Si&[[☃]]Si is {{chem2|Si&[[☃]]Si}}
* {{chem2|1=CH2=CH2}}

=== More ===
* <nowiki>{{chem2|Cl2O6|link=dichlorine hexoxide}}</nowiki> is {{chem2|Cl2O6|link=dichlorine hexoxide}}
* [Fe(Phen)(Phen)3](2+) is {{chem2|[Fe(Phen)(Phen)3](2+)}}
* AUTO: [Fe(Phen)(Phen)3](2+) is {{chem2|auto=yes|[Fe(Phen)(Phen)3](2+)}}
* <nowiki>{{chem2|[C2O2](2+)}}</nowiki> is {{chem2|[C2O2](2+)}}
* <nowiki>{{chem2|link=Tomato|SI4}}</nowiki> is {{chem2|link=Tomato|SI4}}
* H2SO4+ is {{chem2|H2SO4+}}
* Mn- is {{chem2|Mn-}}
* Mn22+ is {{chem2|Mn22+}}, Mn22- is {{chem2|Mn22-}}, 
* Mn(2+) is {{chem2|Mn(2+)}}
* Mn2(+) is {{chem2|Mn2(+)}}
* Mn(22-) is {{chem2|Mn(22-)}}
* Mn3(22-) is {{chem2|Mn3(22-)}}
* Mn(22+) is {{chem2|Mn(22+)}}
* Mn2(22+) is {{chem2|Mn2(22+)}}
* Mn2(2+) is {{chem2|Mn2(2+)}}
* Mn22(2+) is {{chem2|Mn22(2+)}}

=== Chem vs chem2 ===
* {{chem|(CH|3|)|2|CO}}    &nbsp;&nbsp;&nbsp;&nbsp;Chem
* {{chem2|(CH3)2CO}}     &nbsp;&nbsp;&nbsp;&nbsp;Chem2
* {{chem|H|2|+}}     &nbsp;&nbsp;&nbsp;&nbsp;Chem
* {{chem2|H2+}}     &nbsp;&nbsp;&nbsp;&nbsp;Chem2

==TemplateData==
{{TemplateData header}}

<includeonly>{{Sandbox other||
[[Category:Modules in beta]]
[[Category:Chemistry formatting and function templates]]
 
}}</includeonly>
<templatedata>
{
	"params": {
		"1": {},
		"auto": {},
		"link": {}
	}
}
</templatedata>

==See also==
* {{tl|Chem}}
* {{tl|Chemical formula}}
* &lt;chem>, [[WP:MATHCHEM]] — by TeX