Changes between Version 8 and Version 9 of User Guide/Wiki Style Guide


Ignore:
Timestamp:
May 8, 2020, 11:04:39 PM (5 years ago)
Author:
msherman
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • User Guide/Wiki Style Guide

    v8 v9  
    22[[TOC(noheading)]]
    33
    4 = Contributing to the Wiki
     4== Contributing to the Wiki
    55
    66For consistent wiki formatting, please adhere to the following style guidelines.
    77
    8 == General Guidelines
     8=== General Guidelines
    99* '''Page Naming'''
    1010  * Use a short and descriptive name using CamelCase (eg. `MyPageName`)
     
    1616  * When linking to pages that are children of the current page, use relative links `[wiki:./page/to/link/to text to display]`
    1717
    18 == Page Specific Formatting
     18=== Page Specific Formatting
    1919
    20 === Section Pages
     20==== Section Pages
    2121Pages that are introductory to larger sections that contain many sub pages (eg. the main [wiki:TestbedInformation Testbed Information] page or the [wiki:tutorials Tutorials] page) should use the following as a starting point:
    2222
     
    3737The default TOC depth should be left at 1, unless it makes sense otherwise.
    3838
    39 === Individual Pages
     39==== Individual Pages
    4040Individual wiki pages should use the following as a starting point:
    4141{{{
     
    5050}}}
    5151
    52 === Tutorial Pages
     52==== Tutorial Pages
    5353
    5454Please us the following document skeleton when writing a tutorial.
     
    8383
    8484
    85 == Syntax Highlighting and code blocks
     85=== Syntax Highlighting and code blocks
    8686
    8787Trac uses [https://pygments.org/docs/lexers/ pygments] to do syntax highlighting in code blocks
     
    109109}}}
    110110
    111 === Common formats
     111==== Common formats
    112112
    113113|| language || shortname for codeblock ||
     
    123123|| docker || docker, dockerfile ||
    124124
    125 == Using Markdown or !RestructuredText
     125=== Using Markdown or !RestructuredText
    126126
    127127Using code blocks like before, Trac can render other markup formats