Project

General

Profile

Edit History

Guide » User Guide » RedmineTextFormatting »

SimplifiedChineseWikiFormatting » History » Version 9

Charles Sun, 2018-06-08 04:42

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
    9
    Charles Sun
    
URL地址（http, https, ftp 和 ftps）可以被自动转换成可点击的链接： 





    18
    
    
    
* *http://www.redmine.org* -- 外部链接至redmine官网： http://www.redmine.org





    19
    3
    justim chan
    





    20
    9
    Charles Sun
    
URL地址也可以使用不同的文本来显示：





    21
    
    
    
* *"Redmine官网"&58;http&58;//www.redmine.org* -- 以不同的文本显示Redmine官网的外部链接："Redmine官网":http://www.redmine.org





    22
    1
    justim chan
    
* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- 用带标题的外部图片来表示一个外部链接：





    23
    
    
    





    24
    
    
    
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org





    25
    9
    Charles Sun
    





    26
    
    
    
链接的 UNC 路径中可使用文件 URI :





    27
    
    
    
* *"\\server\share$":file://///server/share%24* -- 使用文件 URI 的 UNC 路径: "\\server\share$":file://///server/share%24





    28
    
    
    
你需要对特殊字符做 "URL 编码":http://www.w3schools.com/tags/ref_urlencode.asp，比如： 空格, $, á, é, í, ó, ú, 等等。





    29
    
    
    





    30
    3
    justim chan
    





    31
    
    
    
h3. Email地址





    32
    
    
    





    33
    
    
    
Email地址能够被自动转换成可点击的链接：





    34
    
    
    





    35
    
    
    
* *"Email someone":mailto:someone@foo.bar* -- 用不同的文本显示Email链接： "Email someone":mailto:someone@foo.bar





    36
    
    
    





    37
    
    
    
还可以将更加复杂的指令添加到Email链接中。可以设置默认的主题、正文和抄送地址。但请注意，这些字段里的空格都要编码成%20（详细可参考URL编码）。





    38
    
    
    
* *"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





    39
    
    
    
* *"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





    40
    
    
    
* *"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





    41
    
    
    





    42
    4
    chigeon null
    
h2. 文本格式





    43
    6
    chigeon null
    





    44
    
    
    
对于像是标题、粗体、表格、列表等文字格式， Redmine 支持使用 "Textile":http://en.wikipedia.org/wiki/Textile_%28markup_language%29 语法。 可以到 http://redcloth.org/hobix.com/textile/ 查找关于使用这些特性的信息。下面将展示其中的一些常用的语法。





    45
    
    
    





    46
    
    
    
h3. 字体风格





    47
    
    
    





    48
    
    
    
<pre><code>* *粗体*





    49
    
    
    
* _斜体_





    50
    
    
    
* *_粗体 斜体_*





    51
    
    
    
* +下划线+





    52
    
    
    
* -中划线-





    53
    
    
    
* 文字 ^上标^





    54
    
    
    
* 文字 ~下标~





    55
    
    
    
* @inline monospace@





    56
    
    
    
* <notextile>正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^</notextile>





    57
    
    
    
* <notextile>正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^</notextile>





    58
    
    
    
* <notextile>转义： <notextile>*粗体* _斜体_ @inlinemono（等宽字体）@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;  或者使用 HTML 代码：&#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono（等宽字体）&#64;</notextile>





    59
    
    
    
* <notextile><pre>*一些文字*      "一个链接":http://www.redmine.org</pre></notextile>





    60
    
    
    
* <notextile><pre><notextile></notextile>*一些文字*      "一个链接":http://www.redmine.org</pre></notextile>





    61
    
    
    
</code></pre>





    62
    
    
    





    63
    
    
    
显示为：





    64
    
    
    





    65
    
    
    
 * *粗体*





    66
    
    
    
 * _斜体_





    67
    
    
    
 * *_粗体 斜体_*





    68
    
    
    
 * +下划线+





    69
    
    
    
 * -中划线-





    70
    
    
    
 * 文字 ^上标^





    71
    
    
    
 * 文字 ~下标~





    72
    
    
    
 * @inline monospace（等宽字体）@





    73
    
    
    
 * 正常字体 *粗体* _斜体_ 正常字体;E=mc ^2^





    74
    
    
    
 * 正常字体<notextile></notextile>*粗体*<notextile></notextile>_斜体_<notextile></notextile>正常字体;E=mc<notextile></notextile>^2^





    75
    
    
    
 * 转义： <notextile>*粗体* _斜体_ @inlinemono（等宽字体）@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 或者用 HTML 代码替代： &#42;粗体&#42; &#95;斜体&#95; &#64;inlinemono（等宽字体）&#64;





    76
    
    
    
 * <pre>*一些文字*      "一个链接":http://www.redmine.org</pre>





    77
    
    
    
 * <pre><notextile></notextile>*一些文字*      "一个链接":http://www.redmine.org</pre>





    78
    
    
    





    79
    
    
    
h3. 加入色彩





    80
    
    
    





    81
    
    
    
<pre><code><notextile>* %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%





    82
    
    
    
* %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%





    83
    
    
    
* %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%





    84
    
    
    
* %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%





    85
    
    
    
</notextile></code></pre>





    86
    
    
    





    87
    
    
    
显示为：





    88
    
    
    





    89
    
    
    
 * %{color:red}红色% %{color:green}绿色% %{color:yellow}黄色% %{color:#82B6E1}蓝色%





    90
    
    
    
 * %{color:red}红色%<notextile></notextile>%{color:green}绿色%<notextile></notextile>%{color:yellow}黄色%<notextile></notextile>%{color:#82B6E1}蓝色%





    91
    
    
    
 * %{background:lightgreen}淡绿背景% %{background:yellow}黄色背景%





    92
    
    
    
 * %{background:lightgreen}淡绿背景%<notextile></notextile>%{background:yellow}黄色背景%





    93
    
    
    





    94
    
    
    
h3. 内嵌图片





    95
    
    
    





    96
    
    
    
* *!;image_url!;* 显示位于“image_url”路径的图片





    97
    
    
    
* *!;>image_url!;* 使图片在页面右侧显示





    98
    
    
    
* *!;image_url(图片名称)!;* 改变图片显示的名称为“图片名称”





    99
    
    
    
* *!;image_url!;:URL* 显示位于“image_url”路径的图片, 并给图片加上超链接“URL”





    100
    
    
    





    101
    
    
    
你可以上传图片附件到 wiki 页面，然后使用它的文件名作为路径： *!;已上传的图片.png!;*





    102
    
    
    





    103
    
    
    
h3. 标题





    104
    
    
    





    105
    
    
    
<pre><code>h1. 一级标题





    106
    
    
    





    107
    
    
    
h2. 二级标题





    108
    
    
    





    109
    
    
    
h3. 三级标题





    110
    
    
    
</code></pre>





    111
    
    
    





    112
    
    
    
你可以使用“#一级标题”、“#二级标题”等等来链接到这些标题





    113
    
    
    





    114
    
    
    
h3. 段落





    115
    
    
    





    116
    
    
    
<pre><code>p. 向左对齐





    117
    
    
    





    118
    
    
    
  p(. 向右缩进一个字母的距离





    119
    
    
    





    120
    
    
    
    p((. 向右缩进两个字母的距离





    121
    
    
    
    （也会对这一行以及接下来的每一行起到作用）





    122
    
    
    





    123
    
    
    
                                                                                   p>. 向右对齐





    124
    
    
    





    125
    
    
    
                                                                        p)))>. 向右缩进三个字母的距离





    126
    
    
    





    127
    
    
    
                           p=. 这一行位于中央





    128
    
    
    
</code></pre>





    129
    
    
    





    130
    
    
    
h3. 水平分割线





    131
    
    
    





    132
    
    
    
@----@





    133
    
    
    
显示为：





    134
    
    
    





    135
    
    
    
----





    136
    
    
    





    137
    
    
    
h3. 抑制保留字符





    138
    
    
    





    139
    
    
    
<pre> <pre> *这里的文字不会被加粗* </pre> </pre>





    140
    
    
    
显示为：





    141
    
    
    





    142
    
    
    
<pre> *这里的文字不会被加粗* </pre>





    143
    
    
    





    144
    
    
    
h3. 块引用





    145
    
    
    





    146
    
    
    
在段落前加上 *bq.*：





    147
    
    
    





    148
    
    
    
<pre><code>bq. Rails 是应用了 MVC 设计模式的全栈型框架，用于开发数据库支持的 Web 应用程序。





    149
    
    
    
基于 Rails 进行项目开发，需要你准备的只是一个数据库和一个 Web 服务器。





    150
    
    
    
</code></pre>





    151
    
    
    





    152
    
    
    
显示为：





    153
    
    
    





    154
    
    
    
bq. Rails 是应用了 MVC 设计模式的全栈型框架，用于开发数据库支持的 Web 应用程序。





    155
    
    
    
基于 Rails 进行项目开发，需要你准备的只是一个数据库和一个 Web 服务器。





    156
    
    
    





    157
    
    
    
你也可以在每一行开头加上“>”来实现引用，并且可以叠加“>”作为二级引用：





    158
    
    
    





    159
    
    
    
<pre>





    160
    
    
    
>> Rails 是应用了 MVC 设计模式的全栈型框架，用于开发数据库支持的 Web 应用程序。





    161
    
    
    
>> 基于 Rails 进行项目开发，需要你准备的只是一个数据库和一个 Web 服务器。





    162
    
    
    
> 很不错！





    163
    
    
    
</pre>





    164
    
    
    





    165
    
    
    
显示为：





    166
    
    
    





    167
    
    
    
>> Rails 是应用了 MVC 设计模式的全栈型框架，用于开发数据库支持的 Web 应用程序。





    168
    
    
    
>> 基于 Rails 进行项目开发，需要你准备的只是一个数据库和一个 Web 服务器。





    169
    
    
    
> 很不错！





    170
    
    
    





    171
    
    
    
h3. 无序列表





    172
    
    
    





    173
    
    
    
<pre>





    174
    
    
    
* 条目 1





    175
    
    
    
* 条目 2





    176
    
    
    
** 条目 21





    177
    
    
    
** 条目 22





    178
    
    
    
* 条目 3





    179
    
    
    
</pre>





    180
    
    
    





    181
    
    
    
显示为：





    182
    
    
    





    183
    
    
    
* 条目 1





    184
    
    
    
* 条目 2





    185
    
    
    
** 条目 21





    186
    
    
    
** 条目 22





    187
    
    
    
* 条目 3





    188
    
    
    





    189
    
    
    
h3. 有序列表





    190
    
    
    





    191
    
    
    
<pre>





    192
    
    
    
# 条目 1





    193
    
    
    
# 条目 2





    194
    
    
    
# 条目 3





    195
    
    
    
## 条目 3.1





    196
    
    
    
## 条目 3.2





    197
    
    
    
</pre>





    198
    
    
    





    199
    
    
    
显示为：





    200
    
    
    





    201
    
    
    
# 条目 1





    202
    
    
    
# 条目 2





    203
    
    
    
# 条目 3





    204
    
    
    
## 条目 3.1





    205
    
    
    
## 条目 3.2





    206
    
    
    





    207
    
    
    
h3. 表格





    208
    
    
    





    209
    
    
    
<pre>





    210
    
    
    
|_.UserID      |_.Name          |_.Group     |_. attribute list   |





    211
    
    
    
|Starting with | a              |   simple   |row                 |





    212
    
    
    
|\3=.IT                                      |<. align left       |





    213
    
    
    
|1             |Artur Pirozhkov |/2.Users    |>. align right      |





    214
    
    
    
|2             |Vasya Rogov     |=. center   |





    215
    
    
    
|3             |John Smith      |Admin





    216
    
    
    
                                 (root)      |^. valign top       |





    217
    
    
    
|4             |-               |Nobody





    218
    
    
    
                                 (anonymous) |~. valign bottom    |





    219
    
    
    
</pre>





    220
    
    
    





    221
    
    
    
显示为：





    222
    
    
    
（多个空格会被 Textile 识别为一个空格）





    223
    
    
    





    224
    
    
    
|_.UserID      |_.Name          |_.Group     |_. attribute list   |





    225
    
    
    
|Starting with | a              |   simple   |row                 |





    226
    
    
    
|\3=.IT                                      |<. align left       |





    227
    
    
    
|1             |Artur Pirozhkov |/2.Users    |>. align right      |





    228
    
    
    
|2             |Vasya Rogov     |=. center   |





    229
    
    
    
|3             |John Smith      |Admin





    230
    
    
    
                                 (root)      |^. valign top       |





    231
    
    
    
|4             |-               |Nobody





    232
    
    
    
                                 (anonymous) |~. valign bottom    |





    233
    
    
    





    234
    7
    chigeon null
    
要在表格中使用“|”字符（比如 Wiki 链接），你需要使用下面示例中用到的格式，以防止“|”被 Textile 识别为列分割符。





    235
    6
    chigeon null
    





    236
    
    
    
|_.输入 |_. 输出|





    237
    
    
    
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|





    238
    
    
    





    239
    
    
    
h2. 代码高亮显示





    240
    
    
    





    241
    
    
    
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。





    242
    
    
    





    243
    
    
    
使用下面的格式来实现代码高亮显示：





    244
    
    
    





    245
    
    
    
<pre><code><pre><code class="ruby">





    246
    
    
    
  这里写 Ruby 代码





    247
    
    
    
</code></pre>





    248
    
    
    
</code></pre>





    249
    
    
    





    250
    
    
    
示例：





    251
    
    
    





    252
    
    
    
<pre><code class="ruby">





    253
    
    
    
# The Greeter class





    254
    
    
    
class Greeter





    255
    
    
    
  def initialize(name)





    256
    
    
    
    @name = name.capitalize





    257
    
    
    
  end





    258
    
    
    
 





    259
    
    
    
  def salute





    260
    
    
    
    puts "Hello #{@name}!"





    261
    
    
    
  end





    262
    
    
    
end





    263
    
    
    
</code></pre>