public/help/zh/wiki_syntax_detailed_textile.html

<!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页面...）间建立超链接。</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>Link to an issue including tracker name and subject: <strong>##124</strong> (displays <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>Link to an issue note within the same issue: <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> 链接到页面内的"further-reading"标签. 每个标题都会自动绑定一个标签，方便您进行链接: <a href="#" class="wiki-page">Guide</a></li>
            <li><strong>[[#further-reading]]</strong> link to the anchor "further-reading" of the current page: <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> 显示Sandbox项目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> (链接到标题为“Greeting”的文档)</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>         (链接至指定版本库中，使用非数字哈希的变更集，此例子中是"hg"版本库下的哈希变更集)</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>   (强制下载"sandbox"项目的版本库中位于/some/file的文件，而不是在页面上查看)</li>
                </ul></li>
        </ul>

        <ul>
            <li>论坛：
                <ul>
                    <li><strong>forum#1</strong> (链接至id为2的论坛)</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为1的新闻)</li>
                    <li><strong>news:Greetings</strong> (链接至名称为"Greetings"的新闻)</li>
                    <li><strong>news:"First Release"</strong> (新闻名称包含空格时，使用双引号来表示)</li>
                </ul></li>
        </ul>

        <ul>
            <li>Users:
                <ul>
                    <li><strong>user#2</strong> (link to user with id 2)</li>
                    <li><strong>user:jsmith</strong> (Link to user with login jsmith)</li>
                    <li><strong>@jsmith</strong> (Link to user with login jsmith)</li>
                </ul>
            </li>
        </ul>

        <p>转义字符：</p>

        <ul>
            <li>您可以在文本的前面加上感叹号(!)来避免该文本被解析成Redmine链接</li>
        </ul>


        <h3><a name="4" class="wiki-page"></a>外部链接</h3>

        <p>URLs (starting with: www, http, https, ftp, ftps, sftp and sftps) and email addresses are automatically turned into clickable links:</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>如果您想要显示指定的文本而不是链接,您可以通过下列标准的 textile 语法:</p>

<pre>
"Redmine 官网":http://www.redmine.org
</pre>

        <p>显示为： <a href="http://www.redmine.org" class="external">Redmine 官网</a></p>


    <h2><a name="5" class="wiki-page"></a>字体格式</h2>


    <p>对于像是标题、粗体、表格、列表等文字格式， Redmine 支持使用 <a class="external" href="http://en.wikipedia.org/wiki/Textile_%28markup_language%29">http://en.wikipedia.org/wiki/Textile_(markup_language)</a> 查找关于使用这些特性的信息。下面将展示其中的一些常用的语法。</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> displays an image located at image_url (textile syntax)</li>
            <li><strong>!&gt;image_url!</strong> right floating image</li>
            <li>你可以上传图片附件到 wiki 页面，然后使用它的文件名作为路径： <strong>!已上传的图片.png!</strong></li>
            <li>Images in your computer's clipboard can be pasted directly using Ctrl-v or Command-v.</li>
            <li>Image files can be dragged onto the text area in order to be uploaded and embedded.</li>
        </ul>

        <h3><a name="8" class="wiki-page"></a>标题</h3>

<pre>
h1. 一级标题

h2. 二级标题

h3. 三级标题
</pre>

        <p>你可以使用“#一级标题”、“#二级标题”等等来链接到这些标题</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)}} -- 显示两级子页面</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(View details...)
这是一个默认折叠的文本块。
点击链接后将会展开此文本块.
}}</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>Inserts a link to an issue with flexible text. Examples:</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>Default code highlightment relies on <a href="http://rouge.jneen.net/" class="external">Rouge</a>, a syntax highlighting library written in pure Ruby. It supports many commonly used languages such as <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> and <strong>yaml</strong> (yml) languages, where the names inside parentheses are aliases. Please refer to <a href="https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages" class="external">https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages</a> for the full list of supported languages.</p>

    <p>You can highlight code at any place that supports wiki formatting using this syntax (note that the language name or alias is case-insensitive):</p>

<pre>
&lt;pre&gt;&lt;code class="ruby"&gt;
  这里写 Ruby 代码
&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>