Difference between revisions of "TUFLOW Wiki Format Guide"
Jump to navigation
Jump to search
Chris Huxley (talk | contribs) |
Chris Huxley (talk | contribs) |
||
Line 52: | Line 52: | ||
: (For example, "As [[Tutorial_Module01#Reviewing_Model_Performance | discussed in Module 1]]" is incorrect and should be amended to "As discussed in <u>[[Tutorial_Module01#Reviewing_Model_Performance | Module 1]]</u>") | : (For example, "As [[Tutorial_Module01#Reviewing_Model_Performance | discussed in Module 1]]" is incorrect and should be amended to "As discussed in <u>[[Tutorial_Module01#Reviewing_Model_Performance | Module 1]]</u>") | ||
− | * Links should be underlined(eg. <u>[[Tutorial_Module01#Reviewing_Model_Performance | Module 1]])</u> | + | * Links should be underlined (eg. <u>[[Tutorial_Module01#Reviewing_Model_Performance | Module 1]])</u> |
Revision as of 11:30, 18 November 2016
Refer to Tutorial Module 09 as a worked example of these format requirements.
Bullet Point Lists
View this section in "preview" mode to see the appropriate Wiki syntax.
- Item A
- Item B
- etc
Numbered lists are indented
- Item A
- Item B
- etc
Manual indent syntax
- ":" example...
TUFLOW File References
- TUFLOW is always uppercase (i.e. TUFLOW, not tuflow)
- TUFLOW GIS input and simulation file names should be bold: model\gis\2d_code_M01_001.mif and M01_5m_002.tcf
- Define acronyms before using them in each page: TUFLOW Geometry Control File (TGC), TUFLOW Boundary Control File (TBC).
- Note: This also applies to section headings.
- Control file acronyms are upper case: TCF, TGC, TBC
- Use colour formats for syntax text:
- ! Comment bla bla
- Command == <something>
User Advice (Comments)
Advice is written in italics.
- Note: Running a multiple domain model without a valid multiple domain licence (i.e. in Tutorial Mode) can only be achieved using TUFLOW Build 2016-03-AD or newer.
- Tip 1: Bla bla bla.
Language
Use succinct language for action steps: For example:
- Firstly, lets begin by opening M01_5m_002.tgc in your preferred text editor. Please save the file as M09_2D2D_5m_001.tgc.
becomes.
- Open M01_5m_002.tgc in your text editor. Save the file as M09_2D2D_5m_001.tgc
More verbose language can be used for discussion paragraphs.
Section Headings
- Every word within a section heading MUST start with a capital letter.
- Make the section headings as succinct as possible.
- Do NOT use acronyms as a Section Heading (For example, use "TUFLOW Geometry Control File (TGC)" instead of "TCG")
Section Links
- Link to succinct Section Headings (i.e. not including words preceding the target link).
- (For example, "As discussed in Module 1" is incorrect and should be amended to "As discussed in Module 1")
- Links should be underlined (eg. Module 1)