Changes between Version 8 and Version 9 of User Guide/Wiki Style Guide
- Timestamp:
- May 8, 2020, 11:04:39 PM (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
User Guide/Wiki Style Guide
v8 v9 2 2 [[TOC(noheading)]] 3 3 4 = Contributing to the Wiki4 == Contributing to the Wiki 5 5 6 6 For consistent wiki formatting, please adhere to the following style guidelines. 7 7 8 == General Guidelines8 === General Guidelines 9 9 * '''Page Naming''' 10 10 * Use a short and descriptive name using CamelCase (eg. `MyPageName`) … … 16 16 * When linking to pages that are children of the current page, use relative links `[wiki:./page/to/link/to text to display]` 17 17 18 == Page Specific Formatting18 === Page Specific Formatting 19 19 20 === Section Pages20 ==== Section Pages 21 21 Pages 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: 22 22 … … 37 37 The default TOC depth should be left at 1, unless it makes sense otherwise. 38 38 39 === Individual Pages39 ==== Individual Pages 40 40 Individual wiki pages should use the following as a starting point: 41 41 {{{ … … 50 50 }}} 51 51 52 === Tutorial Pages52 ==== Tutorial Pages 53 53 54 54 Please us the following document skeleton when writing a tutorial. … … 83 83 84 84 85 == Syntax Highlighting and code blocks85 === Syntax Highlighting and code blocks 86 86 87 87 Trac uses [https://pygments.org/docs/lexers/ pygments] to do syntax highlighting in code blocks … … 109 109 }}} 110 110 111 === Common formats111 ==== Common formats 112 112 113 113 || language || shortname for codeblock || … … 123 123 || docker || docker, dockerfile || 124 124 125 == Using Markdown or !RestructuredText125 === Using Markdown or !RestructuredText 126 126 127 127 Using code blocks like before, Trac can render other markup formats