Skip to content

R
redmine
Switch branch/tag
Find file
Normal viewHistoryPermalink
wiki_syntax_detailed_textile.html 18.7 KB
Newer Older
Initial commit from redmine-4.1.1.tar.gz
5b64556d
 
François C. committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>RedmineWikiFormatting</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="../wiki_syntax_detailed.css" />
</head>

<body>
<h1><a name="1" class="wiki-page"></a>Wiki記法</h1>

    <ul class='toc'>
        <li><a href='#2'>リンク</a></li>
        <ul>
            <li><a href='#3'>Redmine内のリンク</a></li>
            <li><a href='#4'>外部リンク</a></li>
        </ul>
        <li><a href='#5'>テキストの書式</a></li>
        <ul>
            <li><a href='#6'>文字の書式</a></li>
            <li><a href='#7'>画像</a></li>
            <li><a href='#8'>見出し</a></li>
            <li><a href='#9'>段落</a></li>
            <li><a href='#10'>引用</a></li>
            <li><a href='#11'>目次</a></li>
            <li><a href='#14'>区切り線</a></li>
        </ul>
        <li><a href='#12'>マクロ</a></li>
        <li><a href='#13'>コードハイライト</a></li>
    </ul>

    <h2><a name="2" class="wiki-page"></a>リンク</h2>

        <h3><a name="3" class="wiki-page"></a>Redmine内のリンク</h3>

        <p>RedmineはWiki記法が使える箇所のどこからでも、チケット・チェンジセット・Wikiページなどのリソースへのリンクができます。</p>
        <ul>
            <li>チケットへのリンク: <strong>#124</strong> (終了したチケットは <del><a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (Closed)">#124</a></del> のように取り消し線付きで表示されます)</li>
            <li>チケットへのリンク (トラッカー名と題名も表示): <strong>##124</strong> (表示例: <a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (New)">Bug #124</a>: bulk edit doesn't change the category or fixed version properties)</li>
            <li>チケットのコメントへのリンク: <strong>#124-6</strong> または <strong>#124#note-6</strong></li>
            <li>同じチケット内のコメントへのリンク: <strong>#note-6</strong></li>
        </ul>

        <p>Wikiへのリンク:</p>

        <ul>
            <li><strong>[[Guide]]</strong> "Guide"という名称のページへのリンク: <a href="#" class="wiki-page">Guide</a></li>
            <li><strong>[[Guide#further-reading]]</strong> "Guide"というページ内の"further-reading"というアンカーに飛びます。見出しには自動的にアンカーが設定されるのでこのようにリンク先とすることができます: <a href="#" class="wiki-page">Guide</a></li>
            <li><strong>[[#further-reading]]</strong> 同じページ内のアンカー"further-reading"へのリンク: <a href="#" class="wiki-page">#further-reading</a></li>
            <li><strong>[[Guide|User manual]]</strong> "Guide"というページへのリンクを異なるテキストで表示: <a href="#" class="wiki-page">User manual</a></li>
        </ul>

        <p>別のプロジェクトのwikiへのリンクも可能です:</p>

        <ul>
          <li><strong>[[sandbox:some page]]</strong> sandboxというプロジェクトのwikiの"some page"という名称のページへのリンク</li>
            <li><strong>[[sandbox:]]</strong> sanbdoxというプロジェクトのwikiのメインページへのリンク</li>
        </ul>

        <p>存在しないwikiページへのリンクは赤で表示されます。 例: <a href="#" class="wiki-page new">Nonexistent page</a>.</p>

        <p>そのほかのリソースへのリンク:</p>

        <ul>
            <li>文書:
                <ul>
                    <li><strong>document#17</strong> (id 17の文書へのリンク)</li>
                    <li><strong>document:Greetings</strong> ("Greetings" というタイトルの文書へのリンク)</li>
                    <li><strong>document:"Some document"</strong> (文書のタイトルに空白が含まれる場合はダブルクォーテーションで囲んでください)</li>
                    <li><strong>sandbox:document:"Some document"</strong> ("sandbox" というプロジェクトの "Some document" というタイトルの文書へのリンク)</li>
                </ul></li>
        </ul>

        <ul>
            <li>バージョン:
                <ul>
                    <li><strong>version#3</strong> (id 3のバージョンへのリンク)</li>
                    <li><strong>version:1.0.0</strong> ("1.0.0"という名称のバージョンへのリンク)</li>
                    <li><strong>version:"1.0 beta 2"</strong></li>
                    <li><strong>sandbox:version:1.0.0</strong> ("sandbox"というプロジェクトの "1.0.0" という名称のバージョンへのリンク)</li>
                </ul></li>
        </ul>

        <ul>
            <li>添付ファイル:
                <ul>
                    <li><strong>attachment:file.zip</strong> (現在のオブジェクトに添付された file.zip というファイルへのリンク)</li>
                    <li>現在のオブジェクト上の添付ファイルのみリンク先として指定できます (例えばあるチケットからは、そのチケットに添付されたファイルのみリンク先にできます)</li>
                </ul></li>
        </ul>

        <ul>
            <li>チェンジセット:
                <ul>
                    <li><strong>r758</strong>                       (チェンジセットへのリンク)</li>
                    <li><strong>commit:c6f4d0fd</strong>            (ハッシュ値によるチェンジセットへのリンク)</li>
                    <li><strong>svn1|r758</strong>                  (複数のリポジトリが設定されたプロジェクトで、特定のリポジトリのチェンジセットへのリンク)</li>
                    <li><strong>commit:hg|c6f4d0fd</strong>         (ハッシュ値による、特定のリポジトリのチェンジセットへのリンク)</li>
                    <li><strong>sandbox:r758</strong>               (他のプロジェクトのチェンジセットへのリンク)</li>
                    <li><strong>sandbox:commit:c6f4d0fd</strong>    (ハッシュ値による、他のプロジェクトのチェンジセットへのリンク)</li>
                </ul></li>
        </ul>

        <ul>
             <li>リポジトリ内のファイル:
                <ul>
                    <li><strong>source:some/file</strong>           (プロジェクトのリポジトリ内の /some/file というファイルへのリンク)</li>
                    <li><strong>source:some/file@52</strong>        (ファイルのリビジョン52へのリンク)</li>
                    <li><strong>source:some/file#L120</strong>      (ファイルの120行目へのリンク)</li>
                    <li><strong>source:some/file@52#L120</strong>   (リビジョン52のファイルの120行目へのリンク)</li>
                    <li><strong>source:"some file@52#L120"</strong> (URLにスペースが含まれる場合はダブルクォーテーションで囲んでください)</li>
                    <li><strong>export:some/file</strong>           (ファイルのダウンロードを強制)</li>
                    <li><strong>source:svn1|some/file</strong>      (複数のリポジトリが設定されたプロジェクトで、特定のリポジトリのファイルへのリンク)</li>
                    <li><strong>sandbox:source:some/file</strong>   ("sandbox" というプロジェクトのリポジトリ上の /some/file というファイルへのリンク)</li>
                    <li><strong>sandbox:export:some/file</strong>   (ファイルのダウンロードを強制)</li>
                </ul></li>
        </ul>

        <ul>
            <li>フォーラム:
                <ul>
                    <li><strong>forum#1</strong> (id 1のフォーラムへのリンク)</li>
                    <li><strong>forum:Support</strong> ("Support"という名称のフォーラムへのリンク)</li>
                    <li><strong>forum:"Technical Support"</strong> (フォーラム名に空白が含まれる場合はダブルクォーテーションで囲んでください)</li>
                </ul></li>
        </ul>

        <ul>
            <li>フォーラムのメッセージ:
                <ul>
                    <li><strong>message#1218</strong> (id 1218のメッセージへのリンク)</li>
                </ul></li>
        </ul>

        <ul>
            <li>プロジェクト:
                <ul>
                    <li><strong>project#3</strong> (id 3のプロジェクトへのリンク)</li>
                    <li><strong>project:someproject</strong> ("someproject"という名称のプロジェクトへのリンク)</li>
                    <li><strong>project:"some project"</strong> (プロジェクト名に空白が含まれる場合はダブルクォーテーションで囲んでください)</li>
                </ul></li>
        </ul>

        <ul>
            <li>ニュース:
                <ul>
                    <li><strong>news#2</strong> (id 2のニュースへのリンク)</li>
                    <li><strong>news:Greetings</strong> ("Greetings"というタイトルのニュースへのリンク)</li>
                    <li><strong>news:"First Release"</strong> (タイトルに空白が含まれる場合はダブルクォーテーションで囲んでください)</li>
                </ul></li>
        </ul>

        <ul>
            <li>ユーザー:
                <ul>
                    <li><strong>user#2</strong> (id 2のユーザーへのリンク)</li>
                    <li><strong>user:jsmith</strong> (jsmith というログインIDのユーザーへのリンク)</li>
                    <li><strong>@jsmith</strong> (jsmith というログインIDのユーザーへのリンク)</li>
                </ul>
            </li>
        </ul>

        <p>エスケープ:</p>

        <ul>
            <li>テキストをRedmineのリンクとして解釈させたくない場合は感嘆符 ! を前につけてください。</li>
        </ul>


        <h3><a name="4" class="wiki-page"></a>外部リンク</h3>

        <p>URL(starting with: www, http, https, ftp, ftps, sftp and sftps)とメールアドレスは自動的にリンクになります:</p>

<pre>
http://www.redmine.org, someone@foo.bar
</pre>

        <p>上記記述の表示例です: <a class="external" href="http://www.redmine.org">http://www.redmine.org</a>, <a href="mailto:someone@foo.bar" class="email">someone@foo.bar</a></p>

        <p>URLのかわりに別のテキストを表示させたい場合は、標準的なtextile記法が利用できます:</p>

<pre>
"Redmine web site":http://www.redmine.org
</pre>

        <p>上記記述の表示例です: <a href="http://www.redmine.org" class="external">Redmine web site</a></p>


    <h2><a name="5" class="wiki-page"></a>テキストの書式</h2>


    <p>見出し、太字、テーブル、リスト等は、RedmineはTextile記法での記述に対応しています。Textile記法の詳細は <a class="external" href="http://en.wikipedia.org/wiki/Textile_%28markup_language%29">http://en.wikipedia.org/wiki/Textile_(markup_language)</a> を参照してください。Textileの一例を以下に示しますが、実際にはここで取り上げた以外の記法にも対応しています。</p>

        <h3><a name="6" class="wiki-page"></a>文字の書式</h3>

<pre>
* *太字*
* _斜体_
* _*太字で斜体*_
* +下線+
* -取り消し線-
</pre>

        <p>表示例:</p>

        <ul>
            <li><strong>太字</strong></li>
            <li><em>斜体</em></li>
            <li><em><strong>太字で斜体</strong></em></li>
            <li><ins>下線</ins></li>
            <li><del>取り消し線</del></li>
        </ul>

        <h3><a name="7" class="wiki-page"></a>画像</h3>

        <ul>
            <li><strong>!image_url!</strong> image_urlで指定されたURLの画像を表示 (Textile記法)</li>
            <li><strong>!&gt;image_url!</strong> 画像を右寄せ・テキスト回り込みありで表示</li>
            <li>Wikiページに添付された画像があれば、ファイル名を指定して画像を表示させることができます: <strong>!attached_image.png!</strong></li>
            <li>PCのクリップボード内の画像は Ctrl-v または Command-v で直接貼り付けることができます (Internet Explorerには対応していません)。</li>
            <li>画像ファイルをテキストエリアにドロップするとアップロードと画像の埋め込みが行われます。</li>
        </ul>

        <h3><a name="8" class="wiki-page"></a>見出し</h3>

<pre>
h1. Heading

h2. Subheading

h3. Subsubheading
</pre>

        <p>Redmineは見出しにアンカーを設定するので、"#Heading", "#Subheading"のように記述して見出しへのリンクが行えます。</p>


        <h3><a name="9" class="wiki-page"></a>段落</h3>

<pre>
p&gt;. 右寄せ
p=. センタリング
</pre>

        <p style="text-align:center;">センタリングされた段落</p>


        <h3><a name="10" class="wiki-page"></a>引用</h3>

        <p>段落を <strong>bq.</strong> で開始してください。</p>

<pre>
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.
</pre>

        <p>表示例:</p>

        <blockquote>
                <p>Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.<br />To go live, all you need to add is a database and a web server.</p>
        </blockquote>


        <h3><a name="11" class="wiki-page"></a>目次</h3>

<pre>
{{toc}} =&gt; 目次(左寄せ)
{{&gt;toc}} =&gt; 目次(右寄せ)
</pre>

        <h3><a name="14" class="wiki-page"></a>区切り線</h3>

<pre>
---
</pre>

    <h2><a name="12" class="wiki-page"></a>マクロ</h2>

    <p>Redmineには以下の組み込みマクロが用意されています:</p>

    <p>
    <dl>
      <dt><code>hello_world</code></dt>
      <dd><p>サンプルのマクロです。</p></dd>

      <dt><code>macro_list</code></dt>
      <dd><p>利用可能なマクロの一覧を表示します。マクロの説明があればそれも表示します。</p></dd>

      <dt><code>child_pages</code></dt>
      <dd><p>子ページの一覧を表示します。引数の指定が無ければ現在のwikiページの子ページを表示します。以下は使用例です:</p>
      <pre><code>{{child_pages}} -- wikiページでのみ使用可能です
{{child_pages(depth=2)}} -- 2階層分のみ表示します</code></pre></dd>

      <dt><code>include</code></dt>
      <dd><p>別のWikiページの内容を挿入します。 以下は使用例です:</p>
      <pre><code>{{include(Foo)}}</code></pre>
      <p>別プロジェクトのWikiページを挿入することもできます:</p>
      <pre><code>{{include(projectname:Foo)}}</code></pre></dd>

      <dt><code>collapse</code></dt>
      <dd><p>折り畳まれた状態のテキストを挿入します。以下は使用例です:</p>
      <pre><code>{{collapse(詳細を表示...)
この部分はデフォルトでは折り畳まれた状態で表示されます。
リンクをクリックすると展開されます。
}}</code></pre></dd>

      <dt><code>thumbnail</code></dt>
      <dd><p>添付ファイルのクリック可能なサムネイル画像を表示します。以下は使用例です:</p>
      <pre>{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}}</pre></dd>

      <dt><code>issue</code></dt>
      <dd><p>チケットへのリンクをカスタマイズ可能なテキストとともに挿入します。以下は使用例です:</p>
      <pre>{{issue(123)}}                              -- Issue #123: Enhance macro capabilities
{{issue(123, project=true)}}                -- Andromeda - Issue #123:Enhance macro capabilities
{{issue(123, tracker=false)}}               -- #123: Enhance macro capabilities
{{issue(123, subject=false, project=true)}} -- Andromeda - Issue #123</pre></dd>
    </dl>
    </p>

    <h2><a name="13" class="wiki-page"></a>コードハイライト</h2>

    <p>RedmineはRubyで記述されたシンタックスハイライト用ライブラリ <a href="http://rouge.jneen.net/" class="external">Rouge</a> を使用しています。Rougeは <strong>c</strong>, <strong>cpp</strong> (c++), <strong>csharp</strong> (c#, cs), <strong>css</strong>, <strong>diff</strong> (patch, udiff), <strong>go</strong> (golang), <strong>groovy</strong>, <strong>html</strong>, <strong>java</strong>, <strong>javascript</strong> (js), <strong>kotlin</strong>, <strong>objective_c</strong> (objc), <strong>perl</strong> (pl), <strong>php</strong>, <strong>python</strong> (py), <strong>r</strong>, <strong>ruby</strong> (rb), <strong>sass</strong>, <strong>scala</strong>, <strong>shell</strong> (bash, zsh, ksh, sh), <strong>sql</strong>, <strong>swift</strong>, <strong>xml</strong>, <strong>yaml</strong> (yml) など一般的に使われている多数の言語に対応しています（括弧内の名前はコードハイライトの指定に利用できる別名です）。全対応言語の一覧は <a href="https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages" class="external">https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages</a> を参照してください。</p>

    <p>Wiki記法に対応している箇所であればどこでも以下の記述によりコードハイライトが利用できます (言語名・別名では大文字・小文字は区別されません):</p>

<pre>
&lt;pre&gt;&lt;code class="ruby"&gt;
  Place your code here.
&lt;/code&gt;&lt;/pre&gt;
</pre>

    <p>表示例:</p>

<pre><code class="ruby syntaxhl"><span class="c1"># The Greeter class</span>
<span class="k">class</span> <span class="nc">Greeter</span>
  <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="nb">name</span><span class="p">)</span>
    <span class="vi">@name</span> <span class="o">=</span> <span class="nb">name</span><span class="p">.</span><span class="nf">capitalize</span>
  <span class="k">end</span>

  <span class="k">def</span> <span class="nf">salute</span>
    <span class="nb">puts</span> <span class="s2">"Hello </span><span class="si">#{</span><span class="vi">@name</span><span class="si">}</span><span class="s2">!"</span>
  <span class="k">end</span>
<span class="k">end</span>
</code></pre>
</body>
</html>