Skip to main content
\(\require{cancel}\)
Physics LibreTexts

Formatting Guidelines

A central theme in the construction of Modules in the ChemWiki (and other STEMWikis) is to integrate and write new content such that the formatting if shared with the rest of the STEMWikis.

Below is a list of aspects to address to ensure this:

  1. Equations
    1. All equations are written in MathJax. Hence remove equations as figures if needed and replace with MathJax.
  2. Make the "Article Type" option for Modules that have multiple sections "topics". This makes an automatic TOC in the upper right hand corner and adds arrows at the bottom
  3. Use the table formatting (via cutting and pasting) for designated components (e.g. ,examples, definition etc.).
  4. Figures
    1. It is best that figures be centrally justified (which you may have to put the mouse to the right or left of to select).
    2. Figures should be copied into the attachments section (you can "drag and drop" to do this) and linked in the main part of the Module (you can also "drag and drop" into the Modules to address this).
    3. If there is any concern about copyrighted figures, contact Delmar Larsen. Do not copy them into the STEMWikis.
  5. Text
    1. Do not use personal pronouns (or remove them).
    2. Full justify all text (except for Figure captions, which should be centrally justifiable)
    3. Catch and change all spelling mistakes as found
  6. Attribution
    1. Each Module needs an attribution (Contributors) sections, unless anonymously written.
  7. Hyperlinking
    1. Hyperlink as needed to the other Modules of the ChemWIki and other STEMWikis, but only hyperlink outside the Hyperlibrary project in the "Outside Links" section if existing.

General Information

Please observe these following suggestions as we want to try to make these chapters as consistent as possible.   

  • First notice the "Edit Page" button at the very top left corner of the page.  Pressing this will put you into edit mode where you can actually make changes to the page you are on.
  • When you are in edit mode, look for the Article Type indicator (on the right side of the page) and set that to Topic.
  • Use the Heading formats.  Combined with the Topic article type, this will generate a lovely little table of contents in the upper right corner of the page.  Note that the highest level of organization headers (e.g. General Information and Equations) should all be H1.  Sub-section headers (e.g. Help Sessions, that falls within General Information) should all be H2 and so on.
  • When copy/pasting text from the Blinder page please take care to read carefully through everything after you have pasted into ChemWiki.  You will need to remove extra carriage returns and there will undoubtedly be some characters that don't transfer well.
  • Equations and Figures will take extra care (see below).
  • Save the page regularly while working.
  • We will need to be sure there is some credit given at the bottom of each page to Professor Blinder and also to YOU!  We'll figure out exactly how we want to format that later.

Equations

Some information regarding equation formatting.  First, the equation formatting is done using the same syntax as a typesetting tool called LaTeX.  This is widely used so you can easily find lots of helpful equation editing information via Google.  Around the equation you need special characters to tell the wiki that it needs to properly format the equation.  There are two ways to do this, one that causes a standalone equation that is set off on its own and a second that puts the equation 'inline'.

The following standalone equation is formatted by placing \ [ (with no space between them) before the equation and \ ] after:

\[G=H-T \Delta S \tag{1}\]

Using the following \ ( and \ ) notation (again without spaces) creates an inline equation.

This is the famous Gibbs energy equation \(G=H-T \Delta S\) that is extremely important in chemistry.

Note that Greek letters (and other special symbols) are produced by using a backslash, \, and then typing the name of the letter.  Capitalizing the name gives a capital Greek letter and keeping the name lowercase gives the lowercase greek letter.  If you click the Edit Page button at the top of the screen you will be able to see the raw characters that I used to generate the equations above.