Project

General

Profile

SimplifiedChineseWikiFormatting » History » Version 8

Charles Sun, 2018-06-08 04:31

1 8 Charles Sun
h1. Textile 格式化
2 1 justim chan
3
4 8 Charles Sun
以下是 *Textile* 的格式化信息. 有关 *Markdown* 的格式化信息请参见 [[RedmineTextFormattingMarkdown]].
5
有关当前Textile支持的限制,请参见 #6269, #10078 (Definition Lists).
6
7
{{>TOC}}
8
9 3 justim chan
h2. 链接
10
11
h3. Redmine 链接
12
13 8 Charles Sun
{{include(RedmineTextFormattingRedmineLinksSimplifiedChinese)}}
14 3 justim chan
15
h3. 外部链接
16
17
HTTP链接和Email地址可以被自动转换成可点击的链接: 
18
* *http://www.redmine.org* -- 外部链接至redmine官网: http://www.redmine.org
19
* *someone@foo.bar* -- 链接至一个Email地址: someone@foo.bar
20
21
HTTP链接也可以使用不同的文本来显示:
22
* *"Redmine官网":http://www.redmine.org* -- 以不同的文本显示Redmine官网的外部链接:http://www.redmine.org
23
* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- 用带标题的外部图片来表示一个外部链接:
24
25
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org
26
27
h3. Email地址
28
29
Email地址能够被自动转换成可点击的链接:
30
31
* *"Email someone":mailto:someone@foo.bar* -- 用不同的文本显示Email链接: "Email someone":mailto:someone@foo.bar
32
33
还可以将更加复杂的指令添加到Email链接中。可以设置默认的主题、正文和抄送地址。但请注意,这些字段里的空格都要编码成%20(详细可参考URL编码)。
34
* *"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
35
* *"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
36
* *"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
37
38 4 chigeon null
h2. 文本格式
39 6 chigeon null
40
对于像是标题、粗体、表格、列表等文字格式, Redmine 支持使用 "Textile":http://en.wikipedia.org/wiki/Textile_%28markup_language%29 语法。 可以到 http://redcloth.org/hobix.com/textile/ 查找关于使用这些特性的信息。下面将展示其中的一些常用的语法。
41
42
h3. 字体风格
43
44
<pre><code>* *粗体*
45
* _斜体_
46
* *_粗体 斜体_*
47
* +下划线+
48
* -中划线-
49
* 文字 ^上标^
50
* 文字 ~下标~
51
* @inline monospace@
52
* <notextile>正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^</notextile>
53
* <notextile>正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^</notextile>
54
* <notextile>转义: <notextile>*粗体* _斜体_ @inlinemono(等宽字体)@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;  或者使用 HTML 代码:&#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono(等宽字体)&#64;</notextile>
55
* <notextile><pre>*一些文字*      "一个链接":http://www.redmine.org</pre></notextile>
56
* <notextile><pre><notextile></notextile>*一些文字*      "一个链接":http://www.redmine.org</pre></notextile>
57
</code></pre>
58
59
显示为:
60
61
 * *粗体*
62
 * _斜体_
63
 * *_粗体 斜体_*
64
 * +下划线+
65
 * -中划线-
66
 * 文字 ^上标^
67
 * 文字 ~下标~
68
 * @inline monospace(等宽字体)@
69
 * 正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^
70
 * 正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^
71
 * 转义: <notextile>*粗体* _斜体_ @inlinemono(等宽字体)@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 或者用 HTML 代码替代: &#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono(等宽字体)&#64;
72
 * <pre>*一些文字*      "一个链接":http://www.redmine.org</pre>
73
 * <pre><notextile></notextile>*一些文字*      "一个链接":http://www.redmine.org</pre>
74
75
h3. 加入色彩
76
77
<pre><code><notextile>* %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%
78
* %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%
79
* %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%
80
* %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%
81
</notextile></code></pre>
82
83
显示为:
84
85
 * %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%
86
 * %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%
87
 * %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%
88
 * %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%
89
90
h3. 内嵌图片
91
92
* *!;image_url!;* 显示位于“image_url”路径的图片
93
* *!;>image_url!;* 使图片在页面右侧显示
94
* *!;image_url(图片名称)!;* 改变图片显示的名称为“图片名称”
95
* *!;image_url!;:URL* 显示位于“image_url”路径的图片, 并给图片加上超链接“URL”
96
97
你可以上传图片附件到 wiki 页面,然后使用它的文件名作为路径: *!;已上传的图片.png!;*
98
99
h3. 标题
100
101
<pre><code>h1. 一级标题
102
103
h2. 二级标题
104
105
h3. 三级标题
106
</code></pre>
107
108
你可以使用“#一级标题”、“#二级标题”等等来链接到这些标题
109
110
h3. 段落
111
112
<pre><code>p. 向左对齐
113
114
  p(. 向右缩进一个字母的距离
115
116
    p((. 向右缩进两个字母的距离
117
    (也会对这一行以及接下来的每一行起到作用)
118
119
                                                                                   p>. 向右对齐
120
121
                                                                        p)))>. 向右缩进三个字母的距离
122
123
                           p=. 这一行位于中央
124
</code></pre>
125
126
h3. 水平分割线
127
128
@----@
129
显示为:
130
131
----
132
133
h3. 抑制保留字符
134
135
<pre> <pre> *这里的文字不会被加粗* </pre> </pre>
136
显示为:
137
138
<pre> *这里的文字不会被加粗* </pre>
139
140
h3. 块引用
141
142
在段落前加上 *bq.*:
143
144
<pre><code>bq. Rails 是应用了 MVC 设计模式的全栈型框架,用于开发数据库支持的 Web 应用程序。
145
基于 Rails 进行项目开发,需要你准备的只是一个数据库和一个 Web 服务器。
146
</code></pre>
147
148
显示为:
149
150
bq. Rails 是应用了 MVC 设计模式的全栈型框架,用于开发数据库支持的 Web 应用程序。
151
基于 Rails 进行项目开发,需要你准备的只是一个数据库和一个 Web 服务器。
152
153
你也可以在每一行开头加上“>”来实现引用,并且可以叠加“>”作为二级引用:
154
155
<pre>
156
>> Rails 是应用了 MVC 设计模式的全栈型框架,用于开发数据库支持的 Web 应用程序。
157
>> 基于 Rails 进行项目开发,需要你准备的只是一个数据库和一个 Web 服务器。
158
> 很不错!
159
</pre>
160
161
显示为:
162
163
>> Rails 是应用了 MVC 设计模式的全栈型框架,用于开发数据库支持的 Web 应用程序。
164
>> 基于 Rails 进行项目开发,需要你准备的只是一个数据库和一个 Web 服务器。
165
> 很不错!
166
167
h3. 无序列表
168
169
<pre>
170
* 条目 1
171
* 条目 2
172
** 条目 21
173
** 条目 22
174
* 条目 3
175
</pre>
176
177
显示为:
178
179
* 条目 1
180
* 条目 2
181
** 条目 21
182
** 条目 22
183
* 条目 3
184
185
h3. 有序列表
186
187
<pre>
188
# 条目 1
189
# 条目 2
190
# 条目 3
191
## 条目 3.1
192
## 条目 3.2
193
</pre>
194
195
显示为:
196
197
# 条目 1
198
# 条目 2
199
# 条目 3
200
## 条目 3.1
201
## 条目 3.2
202
203
h3. 表格
204
205
<pre>
206
|_.UserID      |_.Name          |_.Group     |_. attribute list   |
207
|Starting with | a              |   simple   |row                 |
208
|\3=.IT                                      |<. align left       |
209
|1             |Artur Pirozhkov |/2.Users    |>. align right      |
210
|2             |Vasya Rogov     |=. center   |
211
|3             |John Smith      |Admin
212
                                 (root)      |^. valign top       |
213
|4             |-               |Nobody
214
                                 (anonymous) |~. valign bottom    |
215
</pre>
216
217
显示为:
218
(多个空格会被 Textile 识别为一个空格)
219
220
|_.UserID      |_.Name          |_.Group     |_. attribute list   |
221
|Starting with | a              |   simple   |row                 |
222
|\3=.IT                                      |<. align left       |
223
|1             |Artur Pirozhkov |/2.Users    |>. align right      |
224
|2             |Vasya Rogov     |=. center   |
225
|3             |John Smith      |Admin
226
                                 (root)      |^. valign top       |
227
|4             |-               |Nobody
228
                                 (anonymous) |~. valign bottom    |
229
230 7 chigeon null
要在表格中使用“|”字符(比如 Wiki 链接),你需要使用下面示例中用到的格式,以防止“|”被 Textile 识别为列分割符。
231 6 chigeon null
232
|_.输入 |_. 输出|
233
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
234
235
h2. 代码高亮显示
236
237
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。
238
239
使用下面的格式来实现代码高亮显示:
240
241
<pre><code><pre><code class="ruby">
242
  这里写 Ruby 代码
243
</code></pre>
244
</code></pre>
245
246
示例:
247
248
<pre><code class="ruby">
249
# The Greeter class
250
class Greeter
251
  def initialize(name)
252
    @name = name.capitalize
253
  end
254
 
255
  def salute
256
    puts "Hello #{@name}!"
257
  end
258
end
259
</code></pre>