CZ:Chemistry style guide

From Citizendium
Revision as of 13:30, 19 March 2008 by imported>David E. Volk (→‎Naming (IUPAC) of articles for chemical compounds)
Jump to navigation Jump to search

The {{subpages}} template is designed to be used within article clusters and their related pages.
It will not function on CZ pages.

This page is the first draft of style guide for chemistry articles, with sections detailing how to write equations, make arrows, which subsections to include for chemistry and for drug articles, the use of color and other topics. This page is a work-in-progress, so chemistry editors, authors and other Citizens should feel free to add addtional comments and make corrections.

Chemical Elements and their isotopes

Pages for chemical elements should include the element infobox. See Phosphorus, Hydrogen or Nitrogen for examples of use. The box should be filled in completely. Because many elements have dozens of isotopes, these should be displayed on a subpage. The only exception to this is to list a few of the widely used isotopes on the main page. Examples of this would be deuterium, tritium and carbon-14, which are widely used in the sciences. Be sure to fill in the hazards in the element infobox, particularly for radioactive elements.

Naming (IUPAC) of articles for chemical compounds

When widely used, common names should be used for the article titles of chemical compounds.
Thus, use methanol and ethanol rather than hydroxymethane or hydroxyethane. Also create articles called hydroxymethane and hydroxyethane and use a redirects to the existing article. The official chemical name according to the IUPAC[1] should be included somewhere in the article, but not necessarily at the top.

references

Chemical drawings: color, fonts and image sizes

(CC) Image: David E. Volk
Ciprofloxacin.

When drawing chemical structures in which color is used, color oxygen atoms red and nitrogen atoms blue. Sulfur should be colored green. Shades of magenta, orange, tan and brown may be used for other atoms. Chemical structures are not required to use color other than black.

Within the article, unless the compound is very large, set the pixilation size in the range of 100-350, preferably 200-250. Use a font size of 18 for most structures, and sizes smaller than 14 should be avoided to enable easy reading by all users.

Molecular weight and formula

The molecular weight and chemical formula of the compound should be found in the article.

Cheminfobox

A box used to contain MW, formula, KEGG, CAS, etc is still under development.

Stereochemistry

Whenever possible, use solid wedges (up) and dashed wedges (down) to include stereochemistry of the compound whenever such information is available. Some compounds, like steroids and cholesterol, also use alpha and beta to denote stereochemistry. When applicable, say for a particular drug that is a steroid-mimic, this information should be included in the article for completeness, particularly in the IUPAC name of the chemical.

Typical subsections to use

  • Introductory paragraph (not labeled as subsection, similar to all CZ intros)
  • Physical Properties
  • Synthesis & Typical Reactions
  • History - including discovery
  • Warnings
  • Industrial manufacture

See the #Articles about drugs subsection below for extra subsections typically included for articles about drugs.

Chemical equations

A few examples of widely used chemical reactions for the compound should be displayed. Chemical reactions should be explained both in the text and with the use of equations. Examples of wikitext and the resulting equations created are illustrated below. Just copy & paste the relevant text.

How to make arrows

Some arrows can be inserted by clicking on the appropriate arrow located on the bottom of edit pages. They can also be typed as shown by the examples below. Note that the math begin (<math>) and math end (</math>) tags do not need to immediately surround the arrow functions, they only need to be at the beginning and end of equations.

is made from <math>\rightarrow</math> or <math>\rarr</math> or &rarr;

is made from this <math>\leftarrow</math> or <math>\larr</math> or &larr;

is made from this <math>\leftrightarrow</math> or <math>\harr</math> or &harr;

is made from <math>\stackrel{\textstyle \leftarrow}{\rightarrow} </math>

is made from this <math>\uparrow</math>
is made from this <math>\downarrow</math>

Equation example 1 (Roman lettering)

Note that buttons for superscripts and subscripts are located immediately above and below the edit text box when editing a page. To subscript something, just hi-light the text and click the subscript button.

This text

: 4NaPO<sub>3</sub> + 2SiO<sub>2</sub> + 10C → 2Na<sub>2</sub>SiO<sub>3</sub> + 10CO + P<sub>4</sub>

OR THIS TEXT

:<math> 4 \mathrm{NaPO}_3 + 2 \mathrm{SiO}_2 + 10\mathrm{C} \rarr 2 \mathrm{Na}_2\mathrm{SiO}_3 + 10\mathrm{CO} + \mathrm{P}_4 </math>

provides the following equation (note that colons indent the equation)

4NaPO3 + 2SiO2 + 10C → 2Na2SiO3 + 10CO + P4



Equation example 2 (italic variables for math equations)

This text

[[van der Waals equation]] :<math>\left(p + \frac{n^2 a}{V^2}\right)\left(V-nb\right) = nRT</math>

provides this mathematic formula

van der Waals equation :

Greek symbols

Greek symbols can be inserted by clicking on the appropriate symbol located at the bottom of every "edit" page.

Alternatively, they be coded in directly using LaTex like so:

<math>\alpha</math>-[[amino acid]]s gets converted to: -amino acids.

Greek letters can also be made in HTML, see for a list here.

Articles about drugs

Articles about drugs should include the following extra data, when available. The article ketoconazole is an example a drug article with complete information (except dosing)

Sections to include:

  • Image of the structure , following rules listed above.
  • Chemistry
This section can be used for the MW, chemical formula, IUPAC name and other data
  • Mechanism of action
- This section might also include metabolism, especially for prodrugs
  • Drug interactions
- In particular, dangerous drug combinations need to be listed in either paragraph or list form.
  • Synomyms
- combine with Brand names if both lists are fairly short
  • Brand names
- Be sure to append the ® symbol on the right side of each name.
  • Dosing???
At present, dosing information has not been generally included. This may change after discussion.
  • External links
The following three templates should be included for all drug pages- Include links to
  • {{DailyMed}}
  • {{MedMaster}}
  • {{Drug Bank}}.


See Ketoconazole or Atazanavir for an example article. Unlike other articles, we put these links on the main page because they will contain the most up-to-date data available.

Presently, this data is all located on the main page, but might be moved to subpages in the future. For newer drugs with only one brand name or synonym, these data should be in the introductory paragraph. The "drug class", such as statins, antivirals, or protease inhibitors, and very related drugs or natural compounds, should be mentioned.

Explosives

Articles dealing with explosive compounds, unstable chemicals, and dangerous reactions must point out the danger inherent to the subject.

Constables: Do we want to make a rule to show no explosive reactions?