Project

General

Profile

SimplifiedChineseWikiFormatting » History » Version 4

chigeon null, 2015-06-09 03:51

1 1 justim chan
h1. 文本格式
2
3
{{>TOC}}
4
5
h2. 链接
6
7
h3. Redmine 链接
8
9
在任何使用文本格式的地方,Redmine都允许在资源(问题、变更、wiki页面...)间建立超链接。
10
11
* 链接至一个问题: *!#124* (显示 #124,若该问题已结束则会用删除线来表示)
12
* 链接至一个问题的说明: *!#124-6*, or *!#124!#note-6*
13
* 链接至一个一个变更集: *!r758* (显示r758)
14
* 链接至一个使用非数字哈希码的变更集: *commit:c6f4d0fd* (显示 c6f4d0fd)
15
16
Wiki链接
17
18
* *[[Guide]]* 显示一个页面名为'Guide'的链接: [[Guide]]
19
* *[[Guide|User manual]]* 使用不同的文字显示同一个页面的链接: [[Guide|User manual]]
20
* *[[Guide#User-guide|User guide]]* 使用不同的文字显示相同页面中某个标题的链接: [[Guide#User-guide|User guide]]
21
22
您也可以链接到其他项目的Wiki页面(使用项目标识):
23
24
* *[[sandbox:some page]]* 显示Sandbox项目wiki页面的一个名为'Some page'的链接
25
* *[[sandbox:]]* 显示Sandbox项目wiki首页的链接
26
27
当页面不存在的时候,Wiki链接会以红色来显示,例如: [[Nonexistent page]]
28
29
链接至其他资源:
30
31
* 文档:
32
33
* *!document#17* (链接到id为17的文档)
34
* *!document:Greetings* (链接到标题为“Greeting”的文档)
35
* *!document:"Some document"* (文档标题包含空格时使用双引号来表示)
36
* *!sandbox:document:"Some document"* (链接至sandbox项目中标题为“Some document”的文档)
37
38
* 版本:
39
40
* *!version#3* (链接至id为3的版本)
41
* *!version:1.0.0* (链接到名称为“1.0.0”的版本)
42
* *!version:"1.0 beta 2"* (版本名称包含空格时使用双引号来表示)(double quotes can be used when version name contains spaces)
43
* *!sandbox:version:1.0.0* (连接至sandbox项目中的“1.0.0”版本)
44 2 justim chan
45 3 justim chan
* 附件:
46
47
* *!attachment:file.zip* (链接至当前页面下名为file.zip的附件)
48
* *!attachment:"file.zip"* (文件名包含空格时使用双引号来表示)
49
* 目前,只有当前页面下的附件能够被引用(如果您在一个问题中,则仅可以引用此问题下的附件)
50
51
* 变更集:
52
53
* *!r758* (链接至一个变更集)
54
* *!commit:c6f4d0fd* (链接至一个非数字哈希的变更集)
55
* *!svn1|r758* (链接至指定配置库中的变更集,用于使用多个配置库的项目)
56
* *!commit:hg|c6f4d0fd* (链接至指定配置库中,使用非数字哈希的变更集,此例子中是"hg"配置库下的哈希变更集)
57
* *!sandbox:r758* (链接至其他项目的变更集)
58
* *!sandbox:commit:c6f4d0fd* (链接至其他项目中,使用非数字哈希的变更集)
59
60
* 配置库文件:
61
62
* *!source:some/file* (链接至项目配置库中的位于/some/file的文件)
63
* *!source:some/file@52* (链接至此文件的版本52)
64
* *!source:some/file#L120* (链接至此文件的第120行)
65
* *!source:some/file@52#L120* (链接至此文件52版本的第120行)
66
* *!source:"some file@52#L120"* (URL包含空格时使用双引号来表示) 
67
* *!source:repo_identifier|some/file* (链接至其他配置库中的文件)
68
* *!source:"repo_identifier|some file"* (连接至其他配置库中的文件,URL包含空格时用双引号表示)
69
* *!export:some/file* (强制下载此文件,而不是在页面上查看)
70
71
* 论坛:
72
73
* *!forum#2* (链接至id为2的论坛)
74
* *!forum:Discussion* (链接至名称为"Discussion"的论坛)
75
* *!forum:"Help and more"* (论坛名称包含空格时使用双引号表示)
76
77
* 论坛消息:
78
79
* *!message#1218* (链接至id为1218的论坛消息)
80
81
* 新闻
82
83
* *!news#1* (链接至id为1的新闻)
84
* *!news:Greetings* (链接至名称为"Greetings"的新闻)
85
* *!news:"eCookbook first release !"* (新闻名称包含空格时,使用双引号来表示)
86
87
* 项目
88
89
* *!project#3* (链接至id为3的项目)
90
* *!project:someproject* (链接至名称为"someproject"的项目)
91
* *!project:"Multiple words project"* (项目名称包含空格时,使用双引号来表示)
92
93
转义字符:
94
95
* 您可以在文本的前面加上感叹号(!)来避免该文本被解析成Redmine链接
96
97
h3. 外部链接
98
99
HTTP链接和Email地址可以被自动转换成可点击的链接: 
100
* *http://www.redmine.org* -- 外部链接至redmine官网: http://www.redmine.org
101
* *someone@foo.bar* -- 链接至一个Email地址: someone@foo.bar
102
103
HTTP链接也可以使用不同的文本来显示:
104
* *"Redmine官网":http://www.redmine.org* -- 以不同的文本显示Redmine官网的外部链接:http://www.redmine.org
105
* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- 用带标题的外部图片来表示一个外部链接:
106
107
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org
108
109
h3. Email地址
110
111
Email地址能够被自动转换成可点击的链接:
112
113
* *"Email someone":mailto:someone@foo.bar* -- 用不同的文本显示Email链接: "Email someone":mailto:someone@foo.bar
114
115
还可以将更加复杂的指令添加到Email链接中。可以设置默认的主题、正文和抄送地址。但请注意,这些字段里的空格都要编码成%20(详细可参考URL编码)。
116
* *"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar* -- Email给webmaster,抄送给admin: "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar
117
* *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help* -- 主题为"Website Help"的Email链接: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help
118
* *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20* -- 主题为"Website Help",正文为"Website Help"的Email链接: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20
119
120
h2. 文本格式
121
122
For things such as headlines, bold, tables, lists, Redmine supports "Textile syntax":http://en.wikipedia.org/wiki/Textile_%28markup_language%29. See http://redcloth.org/hobix.com/textile/ for information on using any of these features. A few samples are included below, but the engine is capable of much more of that.
123
124
*持续更新中……*
125 4 chigeon null
h2. 文字格式
126
127
对于像标题、粗体、表格、列表这些文字格式, Redmine 支持 "Textile syntax":http://en.wikipedia.org/wiki/Textile_%28markup_language%29 格式引擎。 可以到 http://redcloth.org/hobix.com/textile/ 查找关于使用这些特性的信息。 下面的内容包括一些简单的示例,不过这个引擎带有的功能会更多。
128
129
h3. 首字母缩写
130
131
<pre>
132
JPL(Jean-Philippe Lang)
133
</pre>
134
135
显示为:
136
137
JPL(Jean-Philippe Lang)
138
139
h3. 字体风格
140
141
<pre><code>* *粗体*
142
* _斜体_
143
* *_粗体 斜体_*
144
* +下划线+
145
* -中划线-
146
* 文字 ^上标^
147
* 文字 ~下标~
148
* @inline monospace@
149
* <notextile>正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^</notextile>
150
* <notextile>正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^</notextile>
151
* <notextile>抑制转义: <notextile>*粗体* _斜体_ @inlinemono(等宽字体)@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;  或者使用 HTML 代码:&#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono(等宽字体)&#64;</notextile>
152
* <notextile><pre>*一些文字*      "一个外部链接":http://www.redmine.org</pre></notextile>
153
* <notextile><pre><notextile></notextile>*一些文字*      "一个外部链接":http://www.redmine.org</pre></notextile>
154
</code></pre>
155
156
显示为:
157
158
 * *粗体*
159
 * _斜体_
160
 * *_粗体 斜体_*
161
 * +下划线+
162
 * -中划线-
163
 * 文字 ^上标^
164
 * 文字 ~下标~
165
 * @inline monospace(等宽字体)@
166
 * 正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^
167
 * 正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^
168
 * 转义: <notextile>*粗体* _斜体_ @inlinemono(等宽字体)@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 或者用 HTML 代码替代: &#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono(等宽字体)&#64;
169
 * <pre>*一些文字*      "一个外部链接":http://www.redmine.org</pre>
170
 * <pre><notextile></notextile>*一些文字*      "一个外部链接":http://www.redmine.org</pre>
171
172
h3. Color
173
174
<pre><code><notextile>* %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%
175
* %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%
176
* %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%
177
* %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%
178
</notextile></code></pre>
179
180
显示为:
181
182
 * %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%
183
 * %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%
184
 * %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%
185
 * %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%
186
187
h3. 内嵌图片
188
189
* *&#33;image_url&#33;* 显示位于“image_url”路径的图片
190
* *&#33;>image_url&#33;* 使图片在页面右侧显示
191
* *&#33;image_url(图片名称)&#33;* 改变图片显示的名称为“图片名称”
192
* *&#33;image_url&#33;:URL* 显示位于“image_url”路径的图片, 并给图片加上超链接“URL”
193
194
你可以上传图片附件到 wiki 页面,然后使用它的文件名作为路径: *!已上传的图片.png!*
195
196
h3. 标题
197
198
<pre><code>h1. 一级标题
199
200
h2. 二级标题
201
202
h3. 三级标题
203
</code></pre>
204
205
你可以使用“#一级标题”、“#二级标题”等等来链接到这些标题
206
207
h3. 段落
208
209
<pre><code>p. 向左对齐
210
211
  p(. 向右缩进一个字母的距离
212
213
    p((. 向右缩进两个字母的距离
214
    (也会对这一行以及接下来的每一行起到作用)
215
216
                                                                                   p>. 向右对齐
217
218
                                                                        p)))>. 向右缩进三个字母的距离
219
220
                           p=. 这一行位于中央
221
</code></pre>
222
223
h3. 水平线
224
225
@----@
226
显示为:
227
228
----
229
230
h3. 抑制保留字符
231
232
<pre> <pre> *这里的文字不会被加粗* </pre> </pre>
233
显示为:
234
235
<pre> *这里的文字不会被加粗* </pre>
236
237
h3. 块引用
238
239
在段落前加上 *bq.*:
240
241
<pre><code>bq. Rails 是应用了 MVC 设计模式的功能完善的框架,用于开发拥有后台数据库的网页应用程序
242
要使用 Rails,你需要增加的只是一个数据库还有一个网页服务器。
243
</code></pre>
244
245
显示为:
246
247
bq. Rails 是应用了 MVC 设计模式的功能完善的框架,用于开发拥有后台数据库的网页应用程序
248
要使用 Rails,你需要增加的只是一个数据库还有一个网页服务器。
249
250
你也可以在每一行开头加上 > 来实现引用,并且可以继续叠加 > 作为二级引用
251
252
<pre>
253
>> Rails 是应用了 MVC 设计模式的功能完善的框架,用于开发拥有后台数据库的网页应用程序
254
>> 要使用 Rails,你需要增加的只是一个数据库还有一个网页服务器。
255
> 很好!
256
</pre>
257
258
显示为:
259
260
>> Rails 是应用了 MVC 设计模式的功能完善的框架,用于开发拥有后台数据库的网页应用程序
261
>> 要使用 Rails,你需要增加的只是一个数据库还有一个网页服务器。
262
> 很好!
263
264
h3. 无序列表
265
266
<pre>
267
* 条目 1
268
* 条目 2
269
** 条目 21
270
** 条目 22
271
* 条目 3
272
</pre>
273
274
显示为:
275
276
* 条目 1
277
* 条目 2
278
** 条目 21
279
** 条目 22
280
* 条目 3
281
282
h3. 有序列表
283
284
<pre>
285
# 条目 1
286
# 条目 2
287
# 条目 3
288
## 条目 3.1
289
## 条目 3.2
290
</pre>
291
292
显示为:
293
294
# 条目 1
295
# 条目 2
296
# 条目 3
297
## 条目 3.1
298
## 条目 3.2
299
300
h3. 表格
301
302
<pre>
303
|_.UserID      |_.Name          |_.Group     |_. attribute list   |
304
|Starting with | a              |   simple   |row                 |
305
|\3=.IT                                      |<. align left       |
306
|1             |Artur Pirozhkov |/2.Users    |>. align right      |
307
|2             |Vasya Rogov     |=. center   |
308
|3             |John Smith      |Admin
309
                                 (root)      |^. valign top       |
310
|4             |-               |Nobody
311
                                 (anonymous) |~. valign bottom    |
312
</pre>
313
314
显示为:
315
(多个空格会被 Textile 识别为单个空格)
316
317
|_.UserID      |_.Name          |_.Group     |_. attribute list   |
318
|Starting with | a              |   simple   |row                 |
319
|\3=.IT                                      |<. align left       |
320
|1             |Artur Pirozhkov |/2.Users    |>. align right      |
321
|2             |Vasya Rogov     |=. center   |
322
|3             |John Smith      |Admin
323
                                 (root)      |^. valign top       |
324
|4             |-               |Nobody
325
                                 (anonymous) |~. valign bottom    |
326
327
要在表格中使用“|”字符(比如 Wiki 链接),你需要使用 <notextile></notextile> 的格式,以防止“|”被 Textile 识别为列分割符。
328
329
|_.输入 |_. 输出|
330
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
331
332
h2. 代码高亮显示
333
334
Redmine 应用的代码高亮显示依赖于"CodeRay":http://coderay.rubychan.de/ 。CodeRay 是完全用 Ruby 语言写的快速代码高亮库,现在支持的语言包括 C、C++、CSS、Delphi、Diff、Groovy、HTML、Java、Javascript、JSON、Nitro-XHTML、PHP、Python、RHTML、Ruby、Scheme、SQL、XML 和 YAML。
335
336
使用下面的格式来实现代码高亮显示:
337
338
<pre><code><pre><code class="ruby">
339
  这里写 Ruby 代码
340
</code></pre>
341
</code></pre>
342
343
示例:
344
345
<pre><code class="ruby">
346
# The Greeter class
347
class Greeter
348
  def initialize(name)
349
    @name = name.capitalize
350
  end
351
 
352
  def salute
353
    puts "Hello #{@name}!"
354
  end
355
end
356
</code></pre>