| 3 | | Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into flexible and powerful whole. |
| 4 | | |
| 5 | | Trac has a built in small and powerful wiki rendering engine. This wiki engine implements an ever growing subset of the commands from other popular Wikis especially [http://moin.sf.net/ MoinWiki]. |
| 6 | | |
| 7 | | This page demonstrates the formatting syntax available anywhere WikiFormatting is allowed. |
| 8 | | |
| 9 | | == Font styles == |
| 10 | | |
| 11 | | The Trac wiki support the following font styles: '''bold''', ''italic'', |
| 12 | | __underline__ and ~~strike-through~~. |
| 13 | | |
| 14 | | {{{ |
| 15 | | The Trac wiki support the following font styles: '''bold''', ''italic'', |
| 16 | | __underline__ and ~~strike-through~~. |
| 17 | | }}} |
| 18 | | |
| 19 | | |
| 20 | | == Heading == |
| 21 | | |
| 22 | | You can create heading by starting a line with one up to five ''equal\\ '=' characters |
| 23 | | followed by a single space and the headline text. The line should end with a space |
| 24 | | followed by the same number of ''equal'' characters. |
| 25 | | |
| 26 | | ''Note: As of writing, headings cannot contain TracLinks.'' |
| 27 | | |
| 28 | | === Example: === |
| 29 | | {{{ |
| 30 | | = Heading = |
| 31 | | == Subheading == |
| 32 | | }}} |
| 33 | | |
| 34 | | |
| 35 | | == Paragraphs == |
| 36 | | |
| 37 | | A new text paragraph is created whenever two blocks of text are separated |
| 38 | | by one or more empty lines. |
| 39 | | |
| 40 | | A forced line break can also be inserted, using: |
| 41 | | {{{ |
| 42 | | Line 1[[BR]]Line 2 |
| 43 | | }}} |
| 44 | | Display: |
| 45 | | |
| 46 | | Line 1[[BR]]Line 2 |
| 47 | | |
| 48 | | Text paragraphs can be indented by starting the lines with two or more spaces. |
| 49 | | |
| 50 | | == Lists == |
| 51 | | The wiki supports both ordered/numbered and unordered lists. |
| 52 | | |
| 53 | | Example: |
| 54 | | {{{ |
| 55 | | * Item 1 |
| 56 | | * Item 1.1 |
| 57 | | * Item 2 |
| 58 | | |
| 59 | | 1. Item 1 |
| 60 | | 1. Item 1.1 |
| 61 | | 1. Item 2 |
| 62 | | }}} |
| 63 | | Display: |
| 64 | | * Item 1 |
| 65 | | * Item 1.1 |
| 66 | | * Item 2 |
| 67 | | |
| 68 | | 1. Item 1 |
| 69 | | 1. Item 1.1 |
| 70 | | 1. Item 2 |
| 71 | | |
| 72 | | == Preformatted text == |
| 73 | | Block quotes, preformatted text, are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote: |
| 74 | | |
| 75 | | Example: |
| 76 | | {{{ |
| 77 | | {{{ |
| 78 | | def HelloWorld() |
| 79 | | print "Hello World" |
| 80 | | }}} |
| 81 | | }}} |
| 82 | | |
| 83 | | Display: |
| 84 | | {{{ |
| 85 | | def HelloWorld() |
| 86 | | print "Hello World" |
| 87 | | }}} |
| 88 | | |
| 89 | | == Tables == |
| 90 | | |
| 91 | | Simple tables can be created like this: |
| 92 | | {{{ |
| 93 | | ||Cell 1||Cell 2||Cell 3|| |
| 94 | | ||Cell 4||Cell 5||Cell 6|| |
| 95 | | }}} |
| 96 | | Display: |
| 97 | | ||Cell 1||Cell 2||Cell 3|| |
| 98 | | ||Cell 4||Cell 5||Cell 6|| |
| 99 | | |
| 100 | | == Links == |
| 101 | | |
| 102 | | !Hyperlinks are automatically created for WikiPageNames and urls. !WikiPageLinks can be disabled by |
| 103 | | prepending an exclamation mark (!) character, such as {{{!WikiPageLink}}}. |
| 104 | | |
| 105 | | Examples: |
| 106 | | |
| 107 | | TitleIndex, http://www.edgewall.com/. |
| 108 | | |
| 109 | | Links can be given a more descriptive title by writing the link followed by |
| 110 | | a space and a title and all this inside two square brackets. Like this: |
| 111 | | {{{ |
| 112 | | * [http://www.edgewall.com/ Edgewall Software] |
| 113 | | * [wiki:TitleIndex Title Index] |
| 114 | | }}} |
| 115 | | Display: |
| 116 | | |
| 117 | | * [http://www.edgewall.com/ Edgewall Software] |
| 118 | | * [wiki:TitleIndex Title Index] |
| 119 | | |
| 120 | | === Trac Links === |
| 121 | | |
| 122 | | Wiki pages can link directly to other parts of the Trac system. |
| 123 | | Pages can refer to tickets, reports, changesets, milestones, source files and |
| 124 | | other Wiki pages using the following notation: |
| 125 | | * Tickets: '''!#1''' or '''!ticket:1''' |
| 126 | | * Reports: '''!{1}''' or '''!report:1''' |
| 127 | | * Changesets: '''![1]''' or '''!changeset:1''' |
| 128 | | * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase''' |
| 129 | | * Milestones: '''!milestone:1.0''' |
| 130 | | * Files: '''!source:trunk/COPYING''' |
| 131 | | * A specific file revision: '''!source:/trunk/COPYING#200''' |
| 132 | | Display: |
| 133 | | * Tickets: #1 or ticket:1 |
| 134 | | * Reports: {1} or report:1 |
| 135 | | * Changesets: [1] or changeset:1 |
| 136 | | * Wiki pages: CamelCase or wiki:CamelCase |
| 137 | | * Milestones: milestone:1.0 |
| 138 | | * Files: source:trunk/COPYING |
| 139 | | * A specific file revision: source:/trunk/COPYING#200 |
| 140 | | |
| 141 | | See TracLinks for more in-depth information. |
| 142 | | |
| 143 | | == Escaping Links and WikiNames == |
| 144 | | You may avoid making hyperlinks out of TracLinks by preceding an expression with a single '!' (exclamation mark). |
| 145 | | |
| 146 | | {{{ |
| 147 | | !NoHyperLink |
| 148 | | !#42 is not a link |
| 149 | | }}} |
| 150 | | |
| 151 | | Display: |
| 152 | | !NoHyperLink |
| 153 | | !#42 is not a link |
| 154 | | |
| 155 | | == Images == |
| 156 | | |
| 157 | | Urls ending with .png, .gif or .jpg are automatically interpreted as image links, and converted to IMG tags. |
| 158 | | |
| 159 | | Example: |
| 160 | | {{{ |
| 161 | | http://www.edgewall.com/gfx/trac_example_image.png |
| 162 | | }}} |
| 163 | | Display: |
| 164 | | |
| 165 | | http://www.edgewall.com/gfx/trac_example_image.png |
| 166 | | |
| 167 | | == Macros == |
| 168 | | Macros are ''custom functions'' to insert dynamic content in a page. See WikiMacros for usage. |
| 169 | | |
| 170 | | Example: |
| 171 | | {{{ |
| 172 | | [[Timestamp]] |
| 173 | | }}} |
| 174 | | Display: |
| 175 | | [[Timestamp]] |
| 176 | | |
| 177 | | == Processors == |
| 178 | | Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. |
| 179 | | |
| 180 | | See WikiProcessors for more information. |
| 181 | | |
| 182 | | '''Example 1:''' |
| 183 | | {{{ |
| 184 | | #!html |
| 185 | | <pre class="wiki">{{{ |
| 186 | | #!html |
| 187 | | <h1 style="text-align: right; color: blue">HTML Test</h1> |
| 188 | | }}}</pre> |
| 189 | | }}} |
| 190 | | Display: |
| 191 | | {{{ |
| 192 | | #!html |
| 193 | | <h1 style="text-align: right; color: blue">HTML Test</h1> |
| 194 | | }}} |
| 195 | | |
| 196 | | '''Example 2:''' |
| 197 | | {{{ |
| 198 | | #!html |
| 199 | | <pre class="wiki">{{{ |
| 200 | | #!python |
| 201 | | class Test: |
| 202 | | def __init__(self): |
| 203 | | print "Hello World" |
| 204 | | if __name__ == '__main__': |
| 205 | | Test() |
| 206 | | }}}</pre> |
| 207 | | }}} |
| 208 | | Display: |
| 209 | | {{{ |
| 210 | | #!python |
| 211 | | class Test: |
| 212 | | def __init__(self): |
| 213 | | print "Hello World" |
| 214 | | if __name__ == '__main__': |
| 215 | | Test() |
| 216 | | }}} |
| 217 | | |
| 218 | | == Miscellaneous == |
| 219 | | |
| 220 | | Four or more dashes will be replaced by a horizontal line (<HR>) |
| 221 | | |
| 222 | | {{{ |
| 223 | | ---- |
| 224 | | }}} |
| 225 | | |
| 226 | | Display: |
| 227 | | ---- |
| 228 | | |
| 229 | | |
| 230 | | ---- |
| 231 | | See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring. |
| 232 | | |
| | 3 | ruby on rails 4 life and django |