Changes between Version 3 and Version 4 of WikiFormatting


Ignore:
Timestamp:
Dec 31, 2005, 5:43:42 PM (18 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiFormatting

    v3 v4  
    1 = WikiFormatting =
     1= Wiki 文法 =
    22[[TracGuideToc]]
    33
    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 The 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:
     4Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、Trac をフレキシブルかつ強力にしています。
     5
     6Trac は小さく強力な Wiki レンダリングエンジンをビルトインしています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。
     7(特に [http://moinmoin.wikiwikiweb.de/ MoinMoin])
     8
     9
     10このページは、 WikiFormatting でフォーマットできる文法の文例集です。
     11
     12
     13== フォントスタイル ==
     14
     15Trac の Wiki は以下のフォントスタイルをサポートしています:
     16{{{
     17 * '''ボールド'''
     18 * ''イタリック''
     19 * '''''ボールドイタリック'''''
     20 * __アンダーライン__
     21 * {{{モノスペース}}} or `モノスペース`
     22 * ~~取り消し線~~
     23 * ^上付き文字^
     24 * ,,下付き文字,,
     25}}}
     26
     27表示内容:
     28 * '''ボールド'''
     29 * ''イタリック''
     30 * '''''ボールドイタリック'''''
     31 * __アンダーライン__
     32 * {{{モノスペース}}} or `モノスペース`
     33 * ~~取り消し線~~
     34 * ^上付き文字^
     35 * ,,下付き文字,,
     36
     37Note: `{{{...}}}` と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。
     38
     39== 見出し ==
     40
     411文字から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
     602つのテキストブロックの間に1行以上の空行がある場合、新しい段落として改行を行います。
     61
     62強制的に改行だけを行いたい場合、このように書いてください:
     63{{{
     641行目[[BR]]2行目
     65}}}
     66以下のように表示されます:
     67
     681行目[[BR]]2行目
     69
     70
     71== リスト ==
     72
     73番号付きリストと番号無しリストの両方をサポートします。
     74
     75:
    7676{{{
    7777 * Item 1
     
    8484}}}
    8585
    86 Display:
     86表示内容:
    8787 * Item 1
    8888   * Item 1.1
     
    9393 1. Item 2
    9494
    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
     100Wikiは用語定義リストもサポートします。
     101
     102:
    103103{{{
    104104 llama::
    105    some kind of mammal, with hair
     105   毛の生えた哺乳類の一種。
    106106 ppython::
    107    some kind of reptile, without hair
    108    (can you spot the typo?)
    109 }}}
    110 
    111 Display:
     107   毛がない爬虫類の一種。
     108   (typoを見つけたかい?)
     109}}}
     110
     111表示内容:
    112112 llama::
    113    some kind of mammal, with hair
     113   毛の生えた哺乳類の一種。
    114114 ppython::
    115    some kind of reptile, without hair
    116    (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)'' で括ってください。ブレースは独立した行に置かなければいけません。
    124124 
    125 Example:
     125:
    126126{{{
    127127 {{{
     
    131131}}}
    132132
    133 Display:
     133表示内容:
    134134{{{
    135135 def HelloWorld():
     
    138138
    139139
    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:
    145145{{{
    146146  This text is a quote from someone else.
    147147}}}
    148148
    149 Display:
     149表示内容:
    150150  This text is a quote from someone else.
    151151
    152 == Tables ==
    153 
    154 Simple tables can be created like this:
     152== ==
     153
     154簡単なテーブルはこのように記述します:
    155155{{{
    156156||Cell 1||Cell 2||Cell 3||
     
    158158}}}
    159159
    160 Display:
     160表示内容:
    161161||Cell 1||Cell 2||Cell 3||
    162162||Cell 4||Cell 5||Cell 6||
    163163
    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
     170WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。
     171
     172:
    173173{{{
    174174 TitleIndex, http://www.edgewall.com/, !NotAlink
    175175}}}
    176176
    177 Display:
     177表示内容:
    178178 TitleIndex, http://www.edgewall.com/, !NotAlink
    179179
    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:
    183183{{{
    184184 * [http://www.edgewall.com/ Edgewall Software]
     
    187187}}}
    188188
    189 Display:
     189表示内容:
    190190 * [http://www.edgewall.com/ Edgewall Software]
    191191 * [wiki:TitleIndex Title Index]
     
    193193
    194194
    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 or ticket:1
    200  * Reports: {1} or report:1
    201  * Changesets: r1, [1] or changeset:1
    202  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3
    203  * Wiki pages: CamelCase or wiki:CamelCase
    204  * Milestones: milestone:1.0 or milestone:"End-of-days Release"
    205  * Files: source:trunk/COPYING
    206  * Attachments: attachment:"file name.doc"
    207  * A specific file revision: source:/trunk/COPYING#200
    208  * A filename with embedded space: source:"/trunk/README FIRST"
    209 }}}
    210 
    211 Display:
    212  * Tickets: #1 or ticket:1
    213  * Reports: {1} or report:1
    214  * Changesets: r1, [1] or changeset:1
    215  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3
    216  * Wiki pages: CamelCase or wiki:CamelCase
    217  * Milestones: milestone:1.0 or milestone:"End-of-days Release"
    218  * Files: source:trunk/COPYING
    219  * Attachments: attachment:"file name.doc"
    220  * A specific file revision: source:/trunk/COPYING#200
    221  * 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
     197Wiki ページでは 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 が出力するハイパーリンクを無効化できます。
    229229
    230230Example:
    231231{{{
    232232 !NoHyperLink
    233  !#42 is not a link
    234 }}}
    235 
    236 Display:
     233 !#42 はリンクではありません。
     234}}}
     235
     236表示内容:
    237237 !NoHyperLink
    238  !#42 is not a link
    239 
    240 
    241 == Images ==
    242 
    243 Urls 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
     243URL が `.png`, `.gif`, `.jpg` で終わっている場合、自動的にイメージへのリンクとみなされ、 img タグに変換されます。
     244
     245:
    246246{{{
    247247http://www.edgewall.com/gfx/trac_example_image.png
    248248}}}
    249249
    250 Display:
     250表示内容:
    251251
    252252http://www.edgewall.com/gfx/trac_example_image.png
    253253
    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:
    262262{{{
    263263 [[Timestamp]]
    264264}}}
    265265
    266 Display:
     266表示内容:
    267267 [[Timestamp]]
    268268
    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 in
    275 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].
    276 
    277 Example 1:
     269使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。
     270
     271
     272== プロセッサ ==
     273
     274Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップもサポートしています。例えば、プロセッサとしてページの描画に
     275[wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。
     276
     2771:
    278278{{{
    279279#!html
    280280<pre class="wiki">{{{
    281281#!html
    282 &lt;h1 style="text-align: right; color: blue"&gt;HTML Test&lt;/h1&gt;
     282&lt;h1 style="text-align: right; color: blue"&gt;HTMLテキスト&lt;/h1&gt;
    283283}}}</pre>
    284284}}}
    285285
    286 Display:
     286表示内容:
    287287{{{
    288288#!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:
    293293{{{
    294294#!html
     
    303303}}}
    304304
    305 Display:
     305表示内容:
    306306{{{
    307307#!python
     
    322322}}}
    323323
    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
     3294文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。
     330
     331:
    332332{{{
    333333 ----
    334334}}}
    335335
    336 Display:
     336表示内容:
    337337----
    338338