To ensure that the content of the FEM Wiki manual is consistently styled, the editors (and in future, contributors) should abide by a set of style guidelines set out below.

Structure

A manual page should be a substantial and self-contained unit of content.  If a page spans many screens, consider decomposing it to its natural parts.  Conversely, if a page seems very light (i.e. it does not fill a screen) then consider merging it with one or more closely related pages.

An exception to this heuristic is the set of ‘stub’ pages which are tagged ‘stub’ and show up as red in the taxonomy browsers.  These were marked out in the original specification of the taxonomy and are intended to be filled out as the manual wiki matures. 

This is supported by forums which exist to discuss the content of the manual so that it can be continuously refined and expanded. To build confidence in the reliability of the content, a select group of users have the ability to mark versions of a page as approved to distinguish them from arbitrary changes.

Headings

The title of every page is automatically displayed at the top of the page. This title is displayed using the largest heading font (Heading 1). The names of sections within a page should be styled by the editors using Heading 2, sub-sections with Heading 3, and sub-sub-sections with Heading 4.

Paragraphs

Please do not add extra blank lines between paragraphs (or headings) - use only one.

Text Wrapping

The FEM Wiki will automatically wrap the text so there is no need to put carriage return / line feeds (i.e. press the enter key) at the end of each line. 

Test Emphasis

If you want to emphasise a section of paragraph text, use italics only. Please do not use bold / underline unless you really need to distinguish between emphasis and something else. This guideline doesn’t include headings - they are automatically styled with bold.

Equations

Please do not include equations that are formatted using ASCII (i.e. just text). As described here, equations should be uploaded as images. 

References

For references to material outside the FEM Wiki site (e.g. conference proceedings, journal articles, websites, etc), please include you references at the bottom of the page where the reference appears. Instructions on how to include external references can be found here.  This is unlike a conventional textbook that would have a references section at the end of the main matter. This approach would be cumbersome to users of the FEM Wiki since they would be forced to navigate away from they page they are reading just to check a reference. It would also require significant coordination to make sure references to not appear twice in the index. We follow the approach used in Wikipedia.

Linking to other FEM Wiki pages

If you want to include a link to another page in the FEM Wiki, follow the instructions on this help page.

Linking to a section in a page

If you want to link to section in the same page, you will have to define an anchor point for the target section and then link to it. Instructions can be found here.

You can also link to a section within another page. Again, the destination in the target document will require an anchor. When you create the link in the source document, you will have to copy the link of the destination page and the append #anchorid to it (e.g. http://www.femwiki.com/fem/w/dummy#section1). 

Word Import

The FEM Wiki word import utility supports only a limited subset of Word. I have found that it copes well enough with text (including ordered / unordered lists, headings, sub-headings) provided the source Word file is formatted using the default style. If you attempt to import from a Word document that has a custom style, the import utility will attempt to replicate these styles in the FEM – this produces in some undesirable results (e.g. you might not be able to change the style after you have saved the page, it might be difficult or impossible to modify some portions of the text). 

I have found that importing of tables words reasonably well, but is not 100% reliable when importing tables with colours. Again, custom table styles in the Word document are likely to create problems.

Importing of images from Word documents is not supported. If you want to include an image, please read the help page (here).

Importing of equations for Word is not supported. A set of instructions is provided (here) on how to export Microsoft Equations.