差分

このページの2つのバージョン間の差分を表示します。

--- wiki:syntax [2011/01/07 13:57] – sahara.satoshi
+++ wiki:syntax [2011/12/13 19:56] (現在) – 外部編集 127.0.0.1
@@ 行 1: / 行 1: @@
-====== Formatting Syntax | 整形記法 ======
+====== Formatting Syntax ======
-[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing the //Edit this page// button at the top or bottom of the page. If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
+<fs 120%>整形記法</fs> … ソースがどのようにHTMLでマークアップされるのか
 文章の整形を行うには、シンプルなマークアップ記法を用います。
@@ 行 10: / 行 10: @@
 主な記法は、[[doku>toolbar|クイックボタン]] からも利用できます。
+  * [[doku>ja:syntax|公式サイトにある整形ルール解説ページ（日本語）]]
+  * [[http://www.dwug-jp.org/lib/exe/fetch.php?media=wiki:dokuwiki_syntax_cheat_sheet_ja_.pdf|DokuWiki日本語Forumにあるチートシート]]
-===== 段落 =====
+===== セクション見出し =====
-**段落**と段落の区切るためには、編集ボックス内では 空行（改行だけの行）を入れます。複数の連続空行があっても、段落と段落の間が大きくならず、言い換えると「見栄えに影響しません」。これを逆手にとって、ソースがわかりやすくなるように、適宜、空行をいれてください。
+最大 5 つのレベルまでの見出しを使って、文章の構造化を行えます。
+つ以上の見出しを記述すると、目次が自動的に生成されます（画面の右上）。
+==== 第 3 見出し ====
+=== 第 4 見出し ===
+== 第 5 見出し ==
+  ==== 第 3 見出し ====
+  === 第 4 見出し ===
+  == 第 5 見出し ==
-===== Basic Text Formatting | 基本的なテキスト整形 =====
-DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
+===== 段落 （普通の段落） =====
-文字飾りとして **太字**、 //斜体//、 __下線__ 、''等幅'' を利用できます。もちろん **__//''組み合わせる''//__** こともできます。
+**段落** (Paragraphs) と段落を区切るためには、ソースでは** 空行（改行だけの行）**を入れます。
+複数の連続空行があっても、段落と段落の間が大きくならず、言い換えると「見栄えに影響しません」。
-  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
+見かけ上は１段落であっても、ソースは複数行で記述されていることがあります。
-  Of course you can **__//''combine''//__** all these.
+これを逆手にとって、ソースがわかりやすくなるように、適宜、空行をいれるほうが良いでしょう。
-You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
+段落内で**強制的に改行したい**場合には、バックスラッシュ（日本語環境では円記号￥）
+を 2 つ連ねた後に空白文字（半角スペース）を置くか改行します。
-さらに <sub>下付き</sub> と <sup>上付き</sup> も使えます。
+この段落は改行\\ を含んでいます。2 連バックスラッシュが
+改行として処理されるのは、空白文字が続く\\ か行の最後\\
+にある場合だけで、\\それ以外はそのまま表示されます。
-  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
+  この段落は改行\\ を含んでいます。2 連バックスラッシュが
+  改行として処理されるのは、空白文字が続く\\ か行の最後\\
+  にある場合だけで、\\それ以外はそのまま表示されます。
-You can mark something as <del>deleted</del> as well.
-<del>取り消し線</del> も利用できます。
-  You can mark something as <del>deleted</del> as well.
+===== リスト （箇条書き段落）=====
+Also take a look at the [[doku>faq:lists|FAQ on list items]].
-**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
+リスト（番号付き・番号無し）を利用できます。行頭にスペースを 2 つ連ねた後に、''*'' （番号無し）または ''-'' （番号付き）を記述します。
-空行をおくと、**段落** となります。
+  * リストです
-段落内で **強制的に改行** するには、バックスラッシュ（日本語環境では円記号￥）
+  * 2番目の要素です
-を 2 つ連ねた後に空白文字を置くか改行します。
+    * 入れ子にもできます
+  * 次の要素です
+  - 番号付きリストです
+  - 次の要素です
+    - 入れ子にするにはインデントを深くします
+  - 以上です
-This is some text with some linebreaks\\ Note that the
+<code>
-two backslashes are only recognized at the end of a line\\
+  * リストです
-or followed by\\ a whitespace \\this happens without it.
+  * 2番目の要素です
+    * 入れ子にもできます
+  * 次の要素です
-この文は改行\\ を含んでいます。2 連バックスラッシュが
+  - 番号付きリストです
-改行として処理されるのは、空白文字が続く\\ か行の最後\\
+  - 次の要素です
-にある場合だけで、\\それ以外はそのまま表示されます。
+    - 入れ子にするにはインデントを深くします
+  - 以上です
+</code>
-  This is some text with some linebreaks\\ Note that the
+===== 文字装飾 =====
-  two backslashes are only recognized at the end of a line\\
-  or followed by\\ a whitespace \\this happens without it.
+  - **太字** , **bold**
+  - //斜体// ,　//italic//  （日本語の文字は、フォントにより斜体になりません。）
+  - __下線__ , __underlined__
+  - 等幅文字 , ''monospaced'' （普通の文では、ほとんど使いません。）
+  - これらの **__//''組み合わせ''//__**
+  - <sub>下付き</sub> , <sub>subscript</sub>
+  - <sup>上付き</sup> , <sup>superscript</sup>
+  - <del>取り消し線</del> , <del>deleted</del>
+<code>
+  - **太字** , **bold**
+  - //斜体// ,　//italic//  （日本語の文字は、フォントにより斜体になりません。）
+  - __下線__ , __underlined__
+  - 等幅文字 , ''monospaced'' （普通の文では、ほとんど使いません。）
+  - これらの **__//''組み合わせ''//__**
+  - <sub>下付き</sub> , <sub>subscript</sub>
+  - <sup>上付き</sup> , <sup>superscript</sup>
+  - <del>取り消し線</del> , <del>deleted</del>
+</code>
+===== 脚注 (Footnotes) =====
+脚注 ((これが脚注です)) には、2連の丸カッコを用います。2連の丸カッコの前後に、半角スペースが必要です。
+  脚注 ((これが脚注です)) には、2 連の丸カッコを用います。
-You should use forced newlines only if really needed.
-強制改行は、どうしても必要な場合だけ使ってください。
@@ 行 134: / 行 179: @@
 The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
-===== Footnotes =====
-You can add footnotes ((This is a footnote)) by using double parentheses.
-  You can add footnotes ((This is a footnote)) by using double parentheses.
-===== Sectioning =====
-You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.
-==== Headline Level 3 ====
-=== Headline Level 4 ===
-== Headline Level 5 ==
-  ==== Headline Level 3 ====
-  === Headline Level 4 ===
-  == Headline Level 5 ==
-By using four or more dashes, you can make a horizontal line:
-----
 ===== Images and Other Files =====
@@ 行 196: / 行 220: @@
 For linking an image to another page see [[#Image Links]] above.
-===== Lists =====
-Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
-  * This is a list
-  * The second item
-    * You may have different levels
-  * Another item
-  - The same list but ordered
-  - Another item
-    - Just use indention for deeper levels
-  - That's it
-<code>
-  * This is a list
-  * The second item
-    * You may have different levels
-  * Another item
-  - The same list but ordered
-  - Another item
-    - Just use indention for deeper levels
-  - That's it
-</code>
-Also take a look at the [[doku>faq:lists|FAQ on list items]].
 ===== Text Conversions =====