Template:Element-symbol-to-oxidation-state-data/doc

Data for the oxidation state entry in each element's infobox and for the List_of_oxidation_states_of_the_elements. Data entries here affect at least two pages.

Editing oxidation state data

The oxidation state data appears in three sections:

1. common values from a singles standard reference (TODO). These values should not be changed without consensus on the Talk page.
2. notable values from experiments, with reliable sources
3. predicted values from theory, with reliable sources.

Each section has one entry for each element in the period table.

Each entry has strict limits to allow text processing.

• Each element result in a string
• Each string oxidation-state-number values
  • an oxidation-state-number eg "+3," starts with
    • a space or a newline, followed by
    • a math minus sign (not a dash) OR
    • a plus OR
    • nothing
    • followed by number,
    • followed by comma (every entry including the last one),
  • a referenced-oxidation-state-number is an oxidation-state-number followed by
    • a <ref>...</ref> tag, or
    • a ^? tag

The common entries are oxidation-state-number values. Do not include 0 (zero) in the common set.

The notable and predicted entries are referenced-oxidation-state-number values. Do not include formatting.

How to add references

Find the element

Most of the time you want the second place the element is listed, for example for Titanium is the second place you see e"Ti=...".

If the ref has not been used before

Add it as normal.

If the reference already used in the element page or in Oxidation state

Make an exact character for character copy of the ref and include it with the new oxidiation state data.

OR

• Note the value of the name= parameter. If there is none, add one using "Author-year".

• In this template add a self-closing "reference reference" with an name like "Author-date",eg

6,<ref name="Smith-2006"/>

• Add the reference definition in two places

In the element page and in Oxidation state add the "reference definition" as a List-defined_reference:

==References==
{{Reflist|refs=
<ref name="Smith-2006">content1</ref>
<ref name="Joe-1936">content2</ref>
}}

Check

Open the element page and Oxidation state references for red Cite Errors.

Template usage

This data template is designed for two use cases,

1. Template:Infobox element
2. Template:List of oxidation states of the elements

Parameters

• os-formatter: a template that accepts symbol, common, notable, and predicted parameters and produces formatted wikitext.
• symbol: element to be selected from the data.

The main-space pages that use these templates should include a definition of the reference named "cn" which might look like

<ref name="cn">Oxidation state{{citation needed}}</ref>

Formatters

See the doc pages of these templates for examples.

1. {{Element-symbol-to-oxidation-state-echo}}: debug output, used by default
2. {{Element-symbol-to-oxidation-state-entry}}: formats for {{Infobox element}}
3. {{Element-symbol-to-oxidation-state-row}}: formats for one row of {{List of oxidation states of the elements}}

Example debug output

The examples use the "echo" formatter and the calls look like {{Element-symbol-to-oxidation-state-data|symbol=C}}

C

• common:−4, −3, −2, −1, 0, +1, +2, +3, +4
  
• notable:
  
• predicted:
  

Fe

• common:+2, +3
  
• notable:−4,^? −2, −1, 0, +1, +4, +5, +6, +7
  
• predicted:
  

He

• common:
  
• notable:0
  
• predicted:
  

Sg

• common:
  
• notable:
  
• predicted:(+3), (+4), (+5), (+6)
  

See also

• Oxidation state
• List of oxidation states of the elements, {{List of oxidation states of the elements}}

Templates used:TODO