<!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>
<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>链接至一个问题的说明： <strong>#124-6</strong>, 或者 <strong>#124#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>[[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>!>image_url!</strong> right floating image</li>
<li>你可以上传图片附件到 wiki 页面，然后使用它的文件名作为路径： <strong>!已上传的图片.png!</strong></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>. 向右对齐
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}} => 靠左对齐目录
{{>toc}} => 靠右对齐目录
</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>
</dl>
</p>
<h2><a name="13" class="wiki-page"></a>代码高亮</h2>
<p>Default code highlightment relies on <a href="http://coderay.rubychan.de/" class="external">CodeRay</a>, a fast syntax highlighting library written completely in Ruby. It currently supports c, clojure, cpp (c++, cplusplus), css, delphi (pascal), diff (patch), erb (eruby, rhtml), go, groovy, haml, html (xhtml), java, javascript (ecmascript, ecma_script, java_script, js), json, lua, php, python, ruby (irb), sass, sql, taskpaper, text (plain, plaintext), xml and yaml (yml) languages, where the names inside parentheses are aliases.</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>
<pre><code class="ruby">
这里写 Ruby 代码
</code></pre>
</pre>
<p>示例：</p>
<pre><code class="ruby syntaxhl"><span class="CodeRay"><span class="comment"># The Greeter class</span>
<span class="keyword">class</span> <span class="class">Greeter</span>
<span class="keyword">def</span> <span class="function">initialize</span>(name)
<span class="instance-variable">@name</span> = name.capitalize
<span class="keyword">end</span>
<span class="keyword">def</span> <span class="function">salute</span>
puts <span class="string"><span class="delimiter">"</span><span class="content">Hello </span><span class="inline"><span class="inline-delimiter">#{</span><span class="instance-variable">@name</span><span class="inline-delimiter">}</span></span><span class="content">!</span><span class="delimiter">"</span></span>
<span class="keyword">end</span>
<span class="keyword">end</span></span></code>
</pre>
</body>
</html>