Changes between Version 3 and Version 4 of WikiFormatting
- Timestamp:
- Dec 31, 2005, 5:43:42 PM (18 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v3 v4 1 = Wiki Formatting=1 = Wiki 文法 = 2 2 [[TracGuideToc]] 3 3 4 Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and powerful whole.5 6 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,7 especially [http://moinmoin.wikiwikiweb.de/ MoinMoin]. 8 9 10 This page demonstrates the formatting syntax available anywhere WikiFormatting is allowed. 11 12 13 == Font Styles==14 15 T he Trac wiki supports the following font styles:16 {{{ 17 * ''' bold'''18 * '' italic''19 * ''''' bold italic'''''20 * __ underline__21 * {{{ monospace}}} or `monospace`22 * ~~ strike-through~~23 * ^ superscript^24 * ,, subscript,,25 }}} 26 27 Display:28 * ''' bold'''29 * '' italic''30 * ''''' bold italic'''''31 * __ underline__32 * {{{ monospace}}} or `monospace`33 * ~~ strike-through~~34 * ^ superscript^35 * ,, subscript,,36 37 Note that the `{{{...}}}` and {{{`...`}}} commands not only select a monospace font, but also treat their content as verbatim text, meaning that no further wiki processing is done on this text.38 39 == Headings==40 41 You can create heading by starting a line with one up to five ''equal'' characters ("=") 42 followed by a single space and the headline text. The line should end with a space 43 followed by the same number of ''='' characters. 44 45 Example:46 {{{ 47 = Heading=48 == Subheading==49 === About ''this''===50 }}} 51 52 Display:53 = Heading=54 == Subheading==55 === About ''this''===56 57 58 == Paragraphs==59 60 A new text paragraph is created whenever two blocks of text are separated by one or more empty lines. 61 62 A forced line break can also be inserted, using:63 {{{ 64 Line 1[[BR]]Line 2 65 }}} 66 Display:67 68 Line 1[[BR]]Line 2 69 70 71 == Lists==72 73 The wiki supports both ordered/numbered and unordered lists. 74 75 Example:4 Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、Trac をフレキシブルかつ強力にしています。 5 6 Trac は小さく強力な Wiki レンダリングエンジンをビルトインしています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。 7 (特に [http://moinmoin.wikiwikiweb.de/ MoinMoin]) 8 9 10 このページは、 WikiFormatting でフォーマットできる文法の文例集です。 11 12 13 == フォントスタイル == 14 15 Trac の Wiki は以下のフォントスタイルをサポートしています: 16 {{{ 17 * '''ボールド''' 18 * ''イタリック'' 19 * '''''ボールドイタリック''''' 20 * __アンダーライン__ 21 * {{{モノスペース}}} or `モノスペース` 22 * ~~取り消し線~~ 23 * ^上付き文字^ 24 * ,,下付き文字,, 25 }}} 26 27 表示内容: 28 * '''ボールド''' 29 * ''イタリック'' 30 * '''''ボールドイタリック''''' 31 * __アンダーライン__ 32 * {{{モノスペース}}} or `モノスペース` 33 * ~~取り消し線~~ 34 * ^上付き文字^ 35 * ,,下付き文字,, 36 37 Note: `{{{...}}}` と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。 38 39 == 見出し == 40 41 1文字から5文字の「イコール '='」を行頭に置き、1文字のスペースに続けてタイトルを置くと、 42 見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)''を 43 置きます。 44 45 例: 46 {{{ 47 = 見出し(第1レベル) = 48 == 見出し(第2レベル) == 49 === 見出し(第3レベル) === 50 }}} 51 52 表示内容: 53 = 見出し(第1レベル) = 54 == 見出し(第2レベル) == 55 === 見出し(第3レベル) === 56 57 58 == 改行 == 59 60 2つのテキストブロックの間に1行以上の空行がある場合、新しい段落として改行を行います。 61 62 強制的に改行だけを行いたい場合、このように書いてください: 63 {{{ 64 1行目[[BR]]2行目 65 }}} 66 以下のように表示されます: 67 68 1行目[[BR]]2行目 69 70 71 == リスト == 72 73 番号付きリストと番号無しリストの両方をサポートします。 74 75 例: 76 76 {{{ 77 77 * Item 1 … … 84 84 }}} 85 85 86 Display:86 表示内容: 87 87 * Item 1 88 88 * Item 1.1 … … 93 93 1. Item 2 94 94 95 Note that there must be one or more spaces preceding the list item markers, otherwise the list will be treated as a normal paragraph. 96 97 98 == Definition Lists==99 100 The wiki also supports definition lists. 101 102 Example:95 リストマーカーの前にスペースを一つ以上置かなければなりません。スペースがない場合、通常のパラグラフとして扱われます。 96 97 98 == 用語定義リスト == 99 100 Wikiは用語定義リストもサポートします。 101 102 例: 103 103 {{{ 104 104 llama:: 105 some kind of mammal, with hair105 毛の生えた哺乳類の一種。 106 106 ppython:: 107 some kind of reptile, without hair108 ( can you spot the typo?)109 }}} 110 111 Display:107 毛がない爬虫類の一種。 108 (typoを見つけたかい?) 109 }}} 110 111 表示内容: 112 112 llama:: 113 some kind of mammal, with hair113 毛の生えた哺乳類の一種。 114 114 ppython:: 115 some kind of reptile, without hair116 ( can you spot the typo?)117 118 Note that you need a space in front of the defined term. 119 120 121 == Preformatted Text==122 123 Block containing preformatted text are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote. The curly braces need to be on a separate line. 115 毛がない爬虫類の一種。 116 (typoを見つけたかい?) 117 118 定義する用語の前にスペースが一つ必要なことを忘れないで下さい。 119 120 121 == 整形済みテキスト == 122 123 整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、3つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。 124 124 125 Example:125 例: 126 126 {{{ 127 127 {{{ … … 131 131 }}} 132 132 133 Display:133 表示内容: 134 134 {{{ 135 135 def HelloWorld(): … … 138 138 139 139 140 == Blockquotes==141 142 In order to mark a paragraph as blockquote, indent that paragraph with two spaces. 143 144 Example:140 == 引用ブロック == 141 142 段落を引用ブロックとしてマークするには、段落を2個のスペースでインデントします。 143 144 例: 145 145 {{{ 146 146 This text is a quote from someone else. 147 147 }}} 148 148 149 Display:149 表示内容: 150 150 This text is a quote from someone else. 151 151 152 == Tables==153 154 Simple tables can be created like this:152 == 表 == 153 154 簡単なテーブルはこのように記述します: 155 155 {{{ 156 156 ||Cell 1||Cell 2||Cell 3|| … … 158 158 }}} 159 159 160 Display:160 表示内容: 161 161 ||Cell 1||Cell 2||Cell 3|| 162 162 ||Cell 4||Cell 5||Cell 6|| 163 163 164 Note that more complex tables can be created using 165 [wiki:WikiRestructuredText#BiggerReSTExample reStructuredText]. 166 167 168 == Links==169 170 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}. 171 172 Example:164 より複雑なテーブルは[wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText] 165 を使用して書くことができます。 166 167 168 == リンク == 169 170 WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。 171 172 例: 173 173 {{{ 174 174 TitleIndex, http://www.edgewall.com/, !NotAlink 175 175 }}} 176 176 177 Display:177 表示内容: 178 178 TitleIndex, http://www.edgewall.com/, !NotAlink 179 179 180 Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets. If the descriptive title is omitted, then the explicit prefix is disguarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention. 181 182 Example:180 リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて1文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wikiページを使いたい場合に役に立ちます。 181 182 例: 183 183 {{{ 184 184 * [http://www.edgewall.com/ Edgewall Software] … … 187 187 }}} 188 188 189 Display:189 表示内容: 190 190 * [http://www.edgewall.com/ Edgewall Software] 191 191 * [wiki:TitleIndex Title Index] … … 193 193 194 194 195 === Trac Links===196 197 Wiki pages can link directly to other parts of the Trac system. Pages can refer to tickets, reports, changesets, milestones, source files and other Wiki pages using the following notations:198 {{{ 199 * Tickets: #1 orticket:1200 * Reports: {1} orreport:1201 * Changesets: r1, [1] orchangeset:1202 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3203 * Wiki pages: CamelCase orwiki:CamelCase204 * Milestones: milestone:1.0 ormilestone:"End-of-days Release"205 * Files: source:trunk/COPYING206 * Attachments: attachment:"file name.doc"207 * A specific file revision: source:/trunk/COPYING#200208 * A filename with embedded space: source:"/trunk/README FIRST"209 }}} 210 211 Display:212 * Tickets: #1 orticket:1213 * Reports: {1} orreport:1214 * Changesets: r1, [1] orchangeset:1215 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3216 * Wiki pages: CamelCase orwiki:CamelCase217 * Milestones: milestone:1.0 ormilestone:"End-of-days Release"218 * Files: source:trunk/COPYING219 * Attachments: attachment:"file name.doc"220 * A specific file revision: source:/trunk/COPYING#200221 * A filename with embedded space: source:"/trunk/README FIRST"222 223 See TracLinks for more in-depth information. 224 225 226 == Escaping Links and WikiPageNames==227 228 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark). 195 === Trac リンク === 196 197 Wiki ページでは Trac の他のコンポーネントに直接リンクできます。チケット、レポート、チェンジセット、マイルストーン、ソースファイル、他の Wiki ページへは以下のようにリンクを記述します: 198 {{{ 199 * チケット: #1 もしくは ticket:1 200 * レポート: {1} もしくは report:1 201 * チェンジセット: [1] もしくは changeset:1 202 * コミットログ: r1:3, [1:3] or log:branches/0.8-stable#1:3 203 * Wiki ページ: CamelCase もしくは wiki:CamelCase 204 * マイルストーン: milestone:1.0 もしくは milestone:"End-of-days Release" 205 * ファイル: source:trunk/COPYING 206 * 添付ファイル: attachment:"file name.doc" 207 * 特定リビジョンのファイル: source:/trunk/COPYING#200 208 * スペースが含まれたファイル名: source:"/trunk/README FIRST" 209 }}} 210 211 表示内容: 212 * チケット: #1 もしくは ticket:1 213 * レポート: {1} もしくは report:1 214 * チェンジセット: [1] もしくは changeset:1 215 * コミットログ: r1:3, [1:3] or log:branches/0.8-stable#1:3 216 * Wiki ページ: CamelCase もしくは wiki:CamelCase 217 * マイルストーン: milestone:1.0 もしくは milestone:"End-of-days Release" 218 * ファイル: source:trunk/COPYING 219 * 添付ファイル: attachment:"file name.doc" 220 * 特定リビジョンのファイル: source:/trunk/COPYING#200 221 * スペースが含まれたファイル名: source:"/trunk/README FIRST" 222 223 より深い情報は TracLinks に記述されています。 224 225 226 == リンクの無効化 == 227 228 エクスクラメーションマーク(!)を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。 229 229 230 230 Example: 231 231 {{{ 232 232 !NoHyperLink 233 !#42 is not a link234 }}} 235 236 Display:233 !#42 はリンクではありません。 234 }}} 235 236 表示内容: 237 237 !NoHyperLink 238 !#42 is not a link239 240 241 == Images==242 243 U rls ending with `.png`, `.gif` or `.jpg` are automatically interpreted as image links, and converted to `<img>` tags.244 245 Example:238 !#42 はリンクではありません。 239 240 241 == 画像 == 242 243 URL が `.png`, `.gif`, `.jpg` で終わっている場合、自動的にイメージへのリンクとみなされ、 img タグに変換されます。 244 245 例: 246 246 {{{ 247 247 http://www.edgewall.com/gfx/trac_example_image.png 248 248 }}} 249 249 250 Display:250 表示内容: 251 251 252 252 http://www.edgewall.com/gfx/trac_example_image.png 253 253 254 However, this doesn't give much control over the display mode. This way of inserting images is deprecated in favor of the more powerful `Image` macro (see WikiMacros). 255 256 257 == Macros==258 259 Macros are ''custom functions'' to insert dynamic content in a page. 260 261 Example:254 この方法では表示形式の細かな制御が出来ません。画像を挿入するには、より強力な `Image` マクロ (See WikiMacros) を使用してください。 255 256 257 == マクロ == 258 259 マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。 260 261 例: 262 262 {{{ 263 263 [[Timestamp]] 264 264 }}} 265 265 266 Display:266 表示内容: 267 267 [[Timestamp]] 268 268 269 See WikiMacros for more information, and a list of installed macros. 270 271 272 == Processors==273 274 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in275 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].276 277 Example1:269 使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。 270 271 272 == プロセッサ == 273 274 Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップもサポートしています。例えば、プロセッサとしてページの描画に 275 [wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。 276 277 例1: 278 278 {{{ 279 279 #!html 280 280 <pre class="wiki">{{{ 281 281 #!html 282 <h1 style="text-align: right; color: blue">HTML Test</h1>282 <h1 style="text-align: right; color: blue">HTMLテキスト</h1> 283 283 }}}</pre> 284 284 }}} 285 285 286 Display:286 表示内容: 287 287 {{{ 288 288 #!html 289 <h1 style="text-align: right; color: blue">HTML Test</h1>290 }}} 291 292 Example:289 <h1 style="text-align: right; color: blue">HTMLテキスト</h1> 290 }}} 291 292 例: 293 293 {{{ 294 294 #!html … … 303 303 }}} 304 304 305 Display:305 表示内容: 306 306 {{{ 307 307 #!python … … 322 322 }}} 323 323 324 See WikiProcessors for more information. 325 326 327 == Miscellaneous==328 329 Four or more dashes will be replaced by a horizontal line (<HR>) 330 331 Example:324 より詳細な情報は WikiProcessors に記載されています。 325 326 327 == その他 == 328 329 4文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。 330 331 例: 332 332 {{{ 333 333 ---- 334 334 }}} 335 335 336 Display:336 表示内容: 337 337 ---- 338 338