FS
Documentation

Style Guide

From Documentation

Revision as of 06:27, 29 September 2006; view current revision
←Older revision | Newer revision→
Jump to: navigation, search

This is the style guide for formatting text for the Functional Software online Documentation.

Contents

Product Links


How To

  1. To create a link to a main document level, simply use "[[product3G]]"
  2. To link to a sub-section of a document, use "[[product3G/subPage | product3G Subpage]]"
  3. To link to a specific part of a document, use "[[product3G/subPage#sectionName | Section Name]]"

Examples

  1. [[COSmanager]] = COSmanager
  2. [[COSmanager/User_Guide/Appendices | COSmanager User Guide Appendices]] = COSmanager User Guide Appendices
  3. [[COSmanager/User_Guide/Appendices#Appendix_A_.E2.80.94_the_COSmanager_User_Interface| Appendix A—the COSmanager User Interface]] = Appendix A—the COSmanager User Interface

Documentation Styles

Inserting Images

Most of the images in the hard documentation are labelled and referred to in the text, for illustration. MediaWiki provides a mechanism for the insertion of a caption alongside an image.

Images are added to the Wiki using the Special Actions > Upload File menu on the far left. Once uploaded to the server, images can be referenced in the page using:

[[Image:imageName.extension|options|Alt Text or Caption]]

Options may be added in any order. Any unknown option will be interpreted as Alternate Image text, and multiple unknown entries will favour the later ones. That is, if there are three unknown options in the declaration, the third one is the one that will be used as the Alt text for the image.

Available options are:

left|right|center|none
Each of these are exclusive of the others. The one appearing latest in the declaration is the one that will be used.
left
image is left aligned, and text is floated to the right
right
image is right aligned and text is floated to the left
center
image is center aligned, and text wraps at the bottom of the image
none
image is left aligned, and text appears underneath the image.

Cautions, Notes, Tips

Currently, cautions, notes and tips look like:


Note
This is a note, of some description

This look is achieved using the following code:

----
;Note: This is a note, of some description
----

Obviously, change the text to suit your needs.

The wiki code of four dashes in a rown (----) is translated to an html Horizontal Rule element.

The Semi-colon/colon notation is actually a definition list, with the semi-colon representing the Definition term (html element DT) and the text after the colon representing the Definition definition (html element DD).