バージョン 1 から バージョン 2 における更新: WikiFormatting

更新日時:

2006/10/21 20:29:01 (19 年 前)

更新者:

trac (IP アドレス: 127.0.0.1)

コメント:

--

WikiFormatting

@@ -2 +2 @@
 [[TracGuideToc]]
 
-Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、Trac をフレキシブルかつ強力にしています。
-
-Trac は小さく強力な Wiki レンダリングエンジンをビルトインしています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。
+Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。
+
+Trac は小さく強力な Wiki レンダリングエンジンを内蔵しています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。
 (特に [http://moinmoin.wikiwikiweb.de/ MoinMoin])
 
@@ -11 +11 @@
 
 
-== フォントスタイル ==
-
-Trac の Wiki は以下のフォントスタイルをサポートしています:
-{{{
- * '''ボールド'''
+== フォント書式 ==
+
+Trac の Wiki は以下のフォント書式に対応しています:
+{{{
+ * '''ボールド''', '''!''' ボールドにできます''' そして '''! '''
  * ''イタリック''
  * '''''ボールドイタリック'''''
@@ -26 +26 @@
 
 表示内容:
- * '''ボールド'''
+ * '''ボールド''', '''!''' ボールドにできます''' そして '''! '''
  * ''イタリック''
  * '''''ボールドイタリック'''''
@@ -35 +35 @@
  * ,,下付き文字,,
 
-Note: `{{{...}}}` と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。
+Notes:
+ * `{{{...}}}`と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。
+ * {{{ ! }}} は wiki パーサに wiki フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです。
 
 == 見出し ==
 
-1文字から5文字の「イコール '='」を行頭に置き、1文字のスペースに続けてタイトルを置くと、
-見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)''を
+1 文字から 5 文字の「イコール '='」を行頭に置き、 1 文字のスペースに続けてタイトルを置くと、
+見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)'' を
 置きます。
-
-例:
-{{{
-= 見出し(第1レベル) =
-== 見出し(第2レベル) ==
-=== 見出し(第3レベル) ===
-}}}
-
-表示内容:
-= 見出し(第1レベル) =
-== 見出し(第2レベル) ==
-=== 見出し(第3レベル) ===
-
+見出しに続いて id 属性を明示的に付与することが出来ます。付与しない場合、暗黙の読み取り可能な id 属性が生成されます。
+'''(訳注: 明示的に付与する id 属性では日本語は使用できないようです。)'''
+
+例:
+{{{
+= 見出し (第1レベル) =
+== 見出し (第2レベル) ==
+=== 見出し (第3レベル) ===
+=== 明示的な id === #using-explicit-id-in-heading
+}}}
+
+表示内容:
+= 見出し (第1レベル) =
+== 見出し (第2レベル) ==
+=== 見出し (第3レベル) ===
+=== 明示的な id === #using-explicit-id-in-heading
 
 == 改行 ==
 
-2つのテキストブロックの間に1行以上の空行がある場合、新しい段落として改行を行います。
+2 つのテキストブロックの間に 1 行以上の空行がある場合、新しい段落として改行を行います。
 
 強制的に改行だけを行いたい場合、このように書いてください:
@@ -71 +76 @@
 == リスト ==
 
-番号付きリストと番号無しリストの両方をサポートします。
+番号付きリストと番号無しリストの両方があります。
 
 例:
@@ -80 +85 @@
 
  1. Item 1
-   1. Item 1.1
+   a. Item 1.a
+   a. Item 1.b
+      i. Item 1.b.i
+      i. Item 1.b.ii
  1. Item 2
+番号付きリストでは、番号を指定することもできます:
+ 3. Item 3
 }}}
 
@@ -90 +100 @@
 
  1. Item 1
-   1. Item 1.1
+   a. Item 1.a
+   a. Item 1.b
+      i. Item 1.b.i
+      i. Item 1.b.ii
  1. Item 2
+番号付きリストでは、番号を指定することもできます:
+ 3. Item 3
 
 リストマーカーの前にスペースを一つ以上置かなければなりません。スペースがない場合、通常のパラグラフとして扱われます。
@@ -98 +113 @@
 == 用語定義リスト ==
 
-Wikiは用語定義リストもサポートします。
+
+Wikiは用語定義リストも作成できます。
 
 例:
@@ -121 +137 @@
 == 整形済みテキスト ==
 
-整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、3つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。
+整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。
   
 例:
@@ -140 +156 @@
 == 引用ブロック ==
 
-段落を引用ブロックとしてマークするには、段落を2個のスペースでインデントします。
+段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。
 
 例:
@@ -149 +165 @@
 表示内容:
   This text is a quote from someone else.
+
+== 引用 ==
+
+進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。
+
+例:
+{{{
+>> Someone's original text
+> Someone else's reply text
+My reply text
+}}}
+
+表示内容:
+>> Someone's original text
+> Someone else's reply text
+My reply text
+
+''Note: いくつかの WikiFormatting の要素、 表やあらかじめ整形されたテキストは引用エリアでは整形が崩れてしまいます。きれいな引用を作るには再整形が必要になるでしょう。''
 
 == 表 ==
@@ -162 +196 @@
 ||Cell 4||Cell 5||Cell 6||
 
-より複雑なテーブルは[wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText]
+より複雑なテーブルは [wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText] 
 を使用して書くことができます。
 
@@ -178 +212 @@
  TitleIndex, http://www.edgewall.com/, !NotAlink
 
-リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて1文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wikiページを使いたい場合に役に立ちます。
+リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて 1 文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wiki ページを使いたい場合に役に立ちます。
 
 例:
@@ -200 +234 @@
  * レポート: {1} もしくは report:1
  * チェンジセット: [1] もしくは changeset:1
- * コミットログ: r1:3, [1:3] or log:branches/0.8-stable#1:3
- * Wiki ページ: CamelCase もしくは wiki:CamelCase
- * マイルストーン: milestone:1.0 もしくは milestone:"End-of-days Release"
- * ファイル: source:trunk/COPYING
- * 添付ファイル: attachment:"file name.doc"
- * 特定リビジョンのファイル: source:/trunk/COPYING#200
- * スペースが含まれたファイル名: source:"/trunk/README FIRST"
+ * ...
 }}}
 
@@ -213 +241 @@
  * レポート: {1} もしくは report:1
  * チェンジセット: [1] もしくは changeset:1
- * コミットログ: r1:3, [1:3] or log:branches/0.8-stable#1:3
- * Wiki ページ: CamelCase もしくは wiki:CamelCase
- * マイルストーン: milestone:1.0 もしくは milestone:"End-of-days Release"
- * ファイル: source:trunk/COPYING
- * 添付ファイル: attachment:"file name.doc"
- * 特定リビジョンのファイル: source:/trunk/COPYING#200
- * スペースが含まれたファイル名: source:"/trunk/README FIRST"
+ * ... 
 
 より深い情報は TracLinks に記述されています。
@@ -226 +248 @@
 == リンクの無効化 ==
 
-エクスクラメーションマーク(!)を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。
-
-Example:
+エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。
+
+例:
 {{{
  !NoHyperLink
@@ -241 +263 @@
 == 画像 ==
 
-URL が `.png`, `.gif`, `.jpg` で終わっている場合、自動的にイメージへのリンクとみなされ、 img タグに変換されます。
-
-例:
-{{{
-http://www.edgewall.com/gfx/trac_example_image.png
-}}}
-
-表示内容:
-
-http://www.edgewall.com/gfx/trac_example_image.png
-
-この方法では表示形式の細かな制御が出来ません。画像を挿入するには、より強力な `Image` マクロ (See WikiMacros) を使用してください。
+URL が `.png`, `.gif` or `.jpg` で終わっている場合、自動的にイメージへのリンクとはならずに `<img>` タグに変換されます。
+
+![[Image]] マクロを使用しなければなりません (以下参照) 。
 
 
@@ -272 +285 @@
 == プロセッサ ==
 
-Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップもサポートしています。例えば、プロセッサとしてページの描画に
+Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップにも対応しています。例えば、プロセッサとしてページの描画に 
 [wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。
 
@@ -280 +293 @@
 <pre class="wiki">{{{
 #!html
-&lt;h1 style="text-align: right; color: blue"&gt;HTMLテキスト&lt;/h1&gt;
+&lt;h1 style="text-align: right; color: blue"&gt;HTMLテスト&lt;/h1&gt;
 }}}</pre>
 }}}
@@ -287 +300 @@
 {{{
 #!html
-<h1 style="text-align: right; color: blue">HTMLテキスト</h1>
+<h1 style="text-align: right; color: blue">HTMLテスト</h1>
 }}}
 
@@ -294 +307 @@
 #!html
 <pre class="wiki">{{{
+#!python
+class Test:
+
+    def __init__(self):
+        print "Hello World"
+if __name__ == '__main__':
+   Test()
+}}}</pre>
+}}}
+
+表示内容:
+{{{
 #!python
 class Test:
@@ -300 +325 @@
 if __name__ == '__main__':
    Test()
-}}}</pre>
-}}}
-
-表示内容:
-{{{
-#!python
-class Test:
-    def __init__(self):
-        print "Hello World"
-if __name__ == '__main__':
-   Test()
 }}}
 
@@ -318 +332 @@
 my ($test) = 0;
 if ($test > 0) {
-echo "hello";
+    print "hello";
 }
 }}}
@@ -327 +341 @@
 == その他 ==
 
-4文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。
+4 文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。
 
 例: