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> 或者使用 HTML 代码:*粗体* _斜体_ @inlinemono(等宽字体)@</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> 或者用 HTML 代码替代: *粗体* _斜体_ @inlinemono(等宽字体)@ |
||
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 | * *!image_url!* 显示位于“image_url”路径的图片 |
||
190 | * *!>image_url!* 使图片在页面右侧显示 |
||
191 | * *!image_url(图片名称)!* 改变图片显示的名称为“图片名称” |
||
192 | * *!image_url!: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> |