Template:Chem2/sandbox
 | This is the template sandbox page for Template:Chem2 (diff). See also the companion subpage for test cases. |
 | This template is used on approximately 8,900 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 Lua: |
 | This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
{{chem2}} is a template used to format a chemical formula or equation.
Use
[edit]Formula punctuation
[edit]| Symbol | Gives | Example | Output |
|---|---|---|---|
\s |
− | {{chem2|CH3\sCH3}} |
CH3−CH3 |
\d |
= | {{chem2|CH2\dCH2}} |
CH2=CH2 |
\t |
≡ | {{chem2|HC\tCH}} |
HC≡CH |
\q |
≣ | {{chem2|[Cl4Re\qReCl4](2−)}} |
[Cl4Re≣ReCl4]2− |
\- |
- | {{chem2|A\-B}} |
A-B |
\\ |
\ | {{chem2|C\\D}} |
C\D |
\h |
η | {{chem2|\h}} |
η |
\h{1} |
η1- | {{chem2|\h{1} |}} |
η1- |
\m{1} |
μ1- | {{chem2|\m{1} |}} |
μ1- |
-> |
→ | {{chem2|2H2 + O2 -> 2H2O}} |
2H2 + O2 → 2H2O |
<-> |
⇌ | {{chem2|K<->L}} |
K ⇌ L |
* |
· | {{chem2|CoCl2*6H2O}} |
CoCl2·6H2O |
\* |
* | {{chem2|Cp\*2Fe}} |
Cp*2Fe |
_{} |
subscript | {{chem2|C_{''n''}H_{2''n''+2} }} |
CnH2n+2 |
^{} |
superscript | {{chem2|^{13}CH4}} |
13CH4 |
∇ |
∇ | {{chem2|∇}} |
∇ |
( ) |
( ) | {{chem2|R\sCH(OH)CN}} |
R−CH(OH)CN |
End }-bracket issue
[edit]When input ends correctly with a }-bracket, like with A_{x}H_{1-x}, the final }-brackets are technically mixed up:
{{chem2|A_{x}H_{1-x}}}→ AxH_{−1x}
The closing bracket } of input and end of template brackets }} are interpreted by Wikipedia software in reversed order.
- Solutions:
- Result:
{{chem2|A_{x}H_{1-x}|}}→ AxH1−x
Formulas, charges, and equations
[edit]Formulas (without charge) are just written:
{{chem2|CH3(CH2)5CH3}}→ CH3(CH2)5CH3{{chem2|Fe3S2(CO)9}}→ Fe3S2(CO)9{{chem2|C_{''n''}H_{2''n''+2}|}}→ CnH2n+2
Charges are written inside parentheses:
{{chem2|SO4(2-)}}→ SO2−4{{chem2|S19(2+)}}→ S2+19
Charges +1 and −1 can be written plain:
{{chem2|Na+}}→ Na+{{chem2|O2-}}→ O−2
- same as
{{chem2|O2(-)}}→ O−2
Chemical equations:
{{chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}}→ 2 S + 3 O2 + 2 H2O → 2 H2SO4{{chem2|2S + 3O2 + 2H2O -> 2H2SO4}}→ 2S + 3O2 + 2H2O → 2H2SO4
The arrows can be written as -> or just →. All characters (and unicode markup) are valid input except \, = (Mediawiki use it), _ and - (endash etc.)
{{chem2|2 H2(g) + O2(g) -> 2H2O(g)|}}→ 2 H2(g) + O2(g) → 2H2O(g){{chem2|NH2RCHCO2H <-> NH3+RCHCO2-}}→ NH2RCHCO2H ⇌ NH+3RCHCO−2
Hapticity and mu:
{{chem2|W(CO)3(PiPr3)2(\h{2}H2)}}→ W(CO)3(PiPr3)2(η2-H2){{chem2|W(CO)3(PiPr3)2(\h{2}H2)|auto=yes}}→ W(CO)3(PiPr3)2(η2-H2)
Wikilinks
[edit]As of March 2023[update], {{chem2}} should not be used inside wikilinks; this can cause erratic failures to properly render sub/superscripts in other invocations on the same page. Instead, use the following options.
Whole formula link
[edit]Link the whole formula with |link=<wiki pagename>:
{{chem2|FeCl3|link=Iron(III) chloride}}→ FeCl3
Or use wikilink brackets in input like [[ammonia|NH3]]:
Link each element (C, Hg) and generic element code (R, X)
[edit]Use |auto=yes to link from the first occurrence of each element symbol, and some functional-group symbols such as Ph
Link functional groups
[edit]Some common groups are recognized and linked if you wikilink them using [[ ]]
{{chem2|R\-[[COOH]]}}→ R-COOH{{chem2|[[CH3]]C[[R]]2[[I]]}}→ CH3CR2I- In particular H2O links to water of crystallization in
{{chem2|CuSO4 * 5 [[H2O]]}}→ CuSO4 · 5 H2O, because a link to water is generally unnecessary.
You can link to any article even if chem2 is unaware of it:
{{chem2|[[C6H5NH2]]}}→ C6H5NH2
To change the default link:
{{chem2|[[water|H2O]]}}→ H2O
All recognised symbols and codes
[edit]Examples and tests
[edit](The first "→" in each example is not part of the output; it separates the example from its output.)
{{chem2|[Cl4Re\qReCl4](2-)|}}→ [Cl4Re≣ReCl4]2−{{chem2|NH2RCHCO2H <-> NH3+RCHCO2−}}→ NH2RCHCO2H ⇌ NH+3RCHCO−2
{{chem2|\\hallo}}→ \hallo{{chem2|H3CC\tCH <-> H2C\dC\dCH2}}→ H3CC≡CH ⇌ H2C=C=CH2{{chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}}→ 4 NH3 + 5 O2 → 4 NO + 6 H2O
{{chem2|H2O → H2O}}→ H2O → H2O{{chem2|H2O(l) -> H2O(g)}}→ H2O(l) → H2O(g)
{{chem2|4 NH3 + 5 O2 → 4 NO + 6 H2O}}→ 4 NH3 + 5 O2 → 4 NO + 6 H2O{{chem2|4NH3 + 5O2 → 4NO + 6H2O}}→ 4NH3 + 5O2 → 4NO + 6H2O{{chem2|2Mn2(+)}}→ 2Mn+2{{chem2|2Mn2(+) + 3H2O}}→ 2Mn+2 + 3H2O{{chem2|Mn–}}→ Mn−
{{chem2|Mn2(2-)}}→ Mn2−2{{chem2|Mn2☃+}}→ Mn2☃+;{{chem2|Mn2(2☃–)}}→ Mn2(2☃−){{chem2|Mn2(+)}}→ Mn+2{{chem2|Mn2+}}→ Mn+2{{chem2|Mn2(-)}}→ Mn−2{{chem2|Mn2-}}→ Mn−2
{{chem2|C_{''n''}H_{2''n'' + 2}|}}→ CnH2n + 2- (chem:
{{chem|C|''n''|H|2''n'' + 2}}→ C
nH
2n + 2 {{chem2|C_{abc}|}}→ Cabc{{chem2|CoCl2*1.5H2O}}→ CoCl2·1.5H2O{{chem2|Cu2C2*H2O}}→ Cu2C2·H2O
Special
{{chem2|[Me2Al(\m{2}Me)]2}}→ [Me2Al(μ2-Me)]2{{chem2|^{13}CO2}}→ 13CO2{{chem2|^{13}CO2|auto=yes}}→ 13CO2{{chem2|\h{5}(C5H5)2TiCl2}}→ η5-(C5H5)2TiCl2- (bad)
{{chem2|\h{5}\s(C5H5)2TiCl2}}→ η5-−(C5H5)2TiCl2 {{chem2|CH2\dCH2\sCH2\sC\tCH\qMn}}→ CH2=CH2−CH2−C≡CH≣Mn
{{chem2|RC(OR')3}}→ RC(OR')3{{chem2|C\\C}}→ C\C{{chem2|C2*NH3}}→ C2·NH3{{chem2|C2*2NH3}}→ C2·2NH3{{chem2|C1.2H3.5}}→ C1.2H3.5
{{chem2|\b\bAbC\e\e}}→ AbC{{chem2|C2(μ\-C)}}→ C2(μ-C)
{{chem2|SO4(2-)}}→ SO2−4{{chem2|2Mn2(2+)}}→ 2Mn2+2{{chem2|CH3-CH2-OH}}→ CH−3CH−2OH{{chem2|[ZnCl4]-}}→ [ZnCl4]−{{chem2|[ZnCl4](2-)}}→ [ZnCl4]2−{{chem2|((H2O)5{CoCl2})2|auto=yes}}→ ((H2O)5{CoCl2})2{{chem2|Si(OH)4}}→ Si(OH)4
{{chem2|Cu2C2*H2O|auto=yes}}→ Cu2C2·H2O{{chem2|Cu2C2*2H2O}}→ Cu2C2·2H2O{{chem2|CuSO*2H2O}}→ CuSO·2H2O{{chem2|CuSO4*15H2O}}→ CuSO4·15H2O{{chem2|CuSO4(H2O)5}}→ CuSO4(H2O)5{{chem2|H+ + OH- → H2O}}→ H+ + OH− → H2O{{chem2|H → O}}→ H → O
{{chem2|ZxPo4}}→ ZxPo4 Unknown element.{{chem2|((Na)Cl}}→ ((Na)Cl Too many "(".{{chem2|Si(OH))4}}→ Si(OH))4 Too many ")".{{chem2|Si&[[☃]]Si}}→ Si&☃Si{{chem2|1=CH2=CH2}}→ CH2=CH2
More
[edit]{{chem2|Cl2O6|link=dichlorine hexoxide}}→ Cl2O6{{chem2|[Fe(Phen)(Phen)3](2+)}}→ [Fe(Phen)(Phen)3]2+{{chem2|[Fe(Phen)(Phen)3](2+)|auto=yes}}→ [Fe(Phen)(Phen)3]2+{{chem2|[C2O2](2+)}}→ [C2O2]2+{{chem2|SI4|link=Tomato}}→ SI4{{chem2|H2SO4+}}→ H2SO+4{{chem2|Mn-}}→ Mn−{{chem2|Mn22+}}→ Mn+22,{{chem2|Mn22-}}→ Mn−22{{chem2|Mn(2+)}}→ Mn2+{{chem2|Mn2(+)}}→ Mn+2{{chem2|Mn(22-)}}→ Mn22−{{chem2|Mn3(22-)}}→ Mn22−3{{chem2|Mn(22+)}}→ Mn22+{{chem2|Mn2(22+)}}→ Mn22+2{{chem2|Mn2(2+)}}→ Mn2+2{{chem2|Mn22(2+)}}→ Mn2+22
Chem vs. chem2
[edit]{{chem|(CH|3|)|2|CO}}→ (CH
3)
2CO{{chem2|(CH3)2CO}}→ (CH3)2CO{{chem|H|2|+}}→ H+
2{{chem2|H2+}}→ H+2
Predefined codes (groups etc.)
[edit]| Predefined codes | ||||
|---|---|---|---|---|
| code | target article | {{chem2|code}}
|
type | note |
| A. Groups etc with element-like names | ||||
| Bz | Benzoyl group | Bz | A: wl |auto=yes
|
|
| Et | Ethyl group | Et | A: wl |auto=yes
|
|
| Ln | Lanthanide | Ln | A: wl |auto=yes
|
|
| Nu | Nucleophile | Nu | A: wl |auto=yes
|
|
| Ph | Phenyl group | Ph | A: wl |auto=yes
|
|
| R | Substituent | R | A: wl |auto=yes
|
|
| T | Tritium | T | A: wl |auto=yes
|
|
| Tf | Trifluoromethylsulfonyl group | Tf | A: wl |auto=yes
|
|
| X | Halogen | X | A: wl |auto=yes
|
|
| B. Groups which are redirected from their normal target if wikilinked; never autolinked. | ||||
| CH3 | Methyl group | CH3 | B: wl |..[[code]]..
|
|
| CO3 | Carbonate | CO3 | B: wl |..[[code]]..
|
|
| COOH | Carboxyl group | COOH | B: wl |..[[code]]..
|
|
| ClO | Hypochlorite | ClO | B: wl |..[[code]]..
|
|
| ClO2 | Chlorite | ClO2 | B: wl |..[[code]]..
|
|
| ClO3 | Chlorate | ClO3 | B: wl |..[[code]]..
|
|
| ClO4 | Perchlorate | ClO4 | B: wl |..[[code]]..
|
|
| H2O | Water of crystallization | H2O | B: wl |..[[code]]..
|
|
| H3O | Hydronium | H3O | B: wl |..[[code]]..
|
|
| NH2 | Amine group | NH2 | B: wl |..[[code]]..
|
|
| NH4 | Ammonium | NH4 | B: wl |..[[code]]..
|
|
| NO3 | Nitrate | NO3 | B: wl |..[[code]]..
|
|
| PO3 | Phosphite | PO3 | B: wl |..[[code]]..
|
|
| PO4 | Phosphate | PO4 | B: wl |..[[code]]..
|
|
| SH | Thiol group | SH | B: wl |..[[code]]..
|
|
| SO3 | Sulfite | SO3 | B: wl |..[[code]]..
|
|
| SO4 | Sulfate | SO4 | B: wl |..[[code]]..
|
|
| SeH | Selenol group | SeH | B: wl |..[[code]]..
|
|
TemplateData
[edit]TemplateData for Chem2
Formats a chemical formula or equation using mhchem code. See template documentation for details on how it works.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Formula | 1 | The chemical formula or equation in mhchem, which can also be hyperlinked manually. See template documentation for how this works.
| String | suggested |
| Autolinked? | auto | Hyperlink every first instance of chemical elements, functional groups, and other generic element codes.
| Boolean | optional |
| Whole formula link | link | Hyperlink the entire formula or equation to a given article page. | Page name | optional |
Tracking
[edit]See also
[edit]- {{Chem}}
- <chem>: WP:MATHCHEM — by TeX