项目

常规

个人资料

操作
历史

文本格式化

对于诸如标题、文本突出显示、表格、列表等，Redmine支持1 Textile 解析器（Textile）。

行元素

外部链接

http(s)、ftp和mail地址会自动转换为可点击链接

https://redmine.ruby-lang.org.cn: https://redmine.ruby-lang.org.cn

[email protected]: .

要放置链接中的任意文本，请使用以下标记

"Redmine项目首页":https://redmine.ruby-lang.org.cn: Redmine项目首页.

缩写

可以通过以下方式在文本中无痕地解释缩写2

JPL(Jean-Philippe Lang): JPL.

字体样式

_italic_: 斜体

*_bold italic_*: 粗体斜体

+underline+: 下划线

-strike-through-: 删除线

Plain ^superscript^: 上标指数

Plain ~subscript~: 下标指数

inline @monospace@: 等宽字体

??cite??: 引用

%span%: 范围

图像

外部

!image_url! -- 在文本中插入位于外部地址 image_url 的图像。

!>image_url! -- 图像右对齐，文本从图像左侧环绕。

附加的

!attached_image.png! -- 在文本中插入附加到页面上的图像 attached_image.png（见警告）。

示例
  • !i0003.gif! 图像，并且文本将在图像之后继续 indian 如此
  • !>i0003.gif! 图像显示在文本右侧 indian
    图像示例，右侧对齐文本
    再次右侧对齐文本
    再次右侧对齐文本
    这里图像在右侧
    这里文本在图像左侧

块元素

为了正确处理textile标记，建议将块级元素（p、h、bq、fn）放置在行首，并使用空行与文本内容分隔。

标题

hn. n级标题，其中n的取值范围为1到6。

段落

p. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

p(. 左侧缩进为1em。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

p((. 左侧缩进为2em。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
缩进会保留到下一行没有空格的文本。

p>. 右对齐。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

p<. 左对齐（默认）。

p)))>. 右对齐并右缩进3em。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
对齐和缩进也会保留到下一行通过
标签换行的文本。
。

通过在居中对齐的块级元素和其余文本之间插入空行，可以重置对齐。

p=. 居中对齐。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

p<>. 左右对齐。Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

预格式化

在指定的 标签 块内的文本不会被 解析器 转换。

为了避免将 textile 标记转换为 html 代码，请使用标签 <pre></pre>。

<pre>Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].</pre>

引用

> "Ruby on Rails" — 用 Ruby 语言编写的软件框架。Ruby on Rails 为 Web 应用程序提供了 Model-View-Controller (模型-视图-控制器) 架构示例，并确保了与 Web 服务器和数据库服务器的集成。

或者

bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails "Ruby on Rails" — 用 Ruby 语言编写的软件框架。Ruby on Rails 为 Web 应用程序提供了 Model-View-Controller (模型-视图-控制器) 架构示例，并确保了与 Web 服务器和数据库服务器的集成。

>> Textile 链接的语法 :http://ru.wikipedia.org/wiki/Ruby_on_Rails 转换为属性 cite="http://ru.wikipedia.org/wiki/Ruby_on_Rails"。

也许对某人有用。

列表

请注意，在元素之间插入空行时元素嵌套的工作方式。
当后续列表元素有缩进时，嵌套会保持；如果没有缩进，则会被重置。

无序列表标记
* Item 1
* Item 2
** Item 2.1

 ** Item 2.1.1
*** Item 2.1.2
** Item 2.2
* Item 3

** Item 0

显示为
  • Item 1
  • Item 2
    • Item 2.1
      • Item 2.1.2
    • Item 2.2
  • Item 3
  • Item 2.1.1
  • Item 0
有序列表标记
# Item 1
# Item 2

 ## Item 2.1

  ## Item 2.1.1
## Item 2.2
# Item 3

# Item 0

显示为
  1. Item 1
  2. Item 2
    1. Item 2.2
  3. Item 3
  1. Item 2.1
    1. Item 2.1.1
  1. Item 0

表格

任何数量的空格都将被替换为一个空格，因此为了方便排版，可以使用文本编辑器和制表符。

|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT               |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov        |=. center |
|3|John Smith |Admin
               (root)|^. valign top |
|4|-          |Nobody
               (anonymous)|~. valign bottom|
显示为
UserID Name Group attribute list
IT align left
1 Artur Pirozhkov Users align right
2 Vasya Rogov center
3 John Smith Admin3
(root)		 valign top
4 - Nobody
(anonymous)		 valign bottom

脚注

脚注

21 fn21. 解释性文本。

脚注的链接4

被解释的文本[21]: 被解释的文本21

分隔符

三个短横线 ---，在文本行外，会被转换为 html 标签 <hr>。

属性

标识符

p(#id). -- 为段落分配 id。

示例

该段落有一个 id，这可以用来创建 链接。

CSS 类

p(class). -- 为段落分配类。

示例

该段落包含一个用 ruby 函数 风格装饰的短语。

对象链接

为了防止 redmine 标记转换为链接，在它前面放置一个感叹号。

任务

#124: #124 -- 如果任务已关闭，则链接会被划掉。

修订版

r758: r758

提交

commit:c6f4d0fd: commit:c6f4d0fd

Wiki 页面

如果页面不存在，链接将显示为红色： Nonexistent page。

[[Guide]]: Guide

[[Guide|User manual]]: User manual -- 带有自定义文本的链接。

[[指南#用户指南|用户指南]]: 用户指南 -- 链接到页面的特定标题。
在标题名称中的 # 符号之后放置破折号而不是空格。

[[someproject:some-page]] -- 从另一个项目链接到 wiki 页面。

[[someproject:]] -- 链接到另一个项目的 Wiki 主页。

文档

document#17 -- 按标识符链接到文档。

document:somedocument -- 按名称链接到文档。

document:"Some document" -- 如果名称中包含空格，则将其括在双引号中。

document:some_project:"Some document" -- 按名称链接到另一个项目中的文档。

版本

version#3 -- 按标识符链接到版本。

version:1.0.0 -- 按名称链接到版本。

version:"1.0 beta 2" -- 如果名称中包含空格，则将其括在双引号中。

项目

project#4 或 project:someid -- 按数字或符号标识符链接到项目。

project:someproject - 按名称链接到项目。

project:"Some project" - 如果名称中包含空格，则将其括在双引号中。

附件

attachment:i0003.gif: i0003.gif -- 链接到附加到该页面的文件。

重要: 附加文件链接仅在其附加的页面上有效。

仓库

source:some/file -- 链接到仓库文件。

source:some/file@52 -- 链接到仓库文件的版本。

source:some/file#L120 -- 链接到仓库文件的特定行。

source:some/file@52#L120 -- 标记的组合。

source:"some file@52#L120" -- 如果 URL 中包含空格，则使用双引号。

export:some/file -- 链接到文件的下载。

电子邮件链接

在电子邮件地址链接中，可以指定主题、邮件正文和发送副本的地址。

"Email webmaster and admin":mailto:[email protected][email protected]: Email webmaster and admin -- 指定发送副本的地址。

"Email someone for help":mailto:[email protected]?subject=Website%20Help: Email someone for help -- 指定邮件的主题。

"Email someone for help":mailto:[email protected]?subject=Website%20Help&body=My%20problem%20is%20: Email someone for help -- 指定邮件的正文。

重要: 在链接中，应使用代码 %20 替换空格。

宏

可用宏及其描述（英文）由宏 {{macro_list}} 调用。

内容

{{TOC}} -- 显示基于标题自动生成的页面内容。
{{>TOC}} -- 将内容块右对齐。

子页面

{{child_pages}} -- 显示指向该页面的所有子页面的链接。
{{child_pages(Foo)}} -- 显示指向括号中指定 wiki 页面的链接 Foo。
{{child_pages(Foo, parent=1)}} -- 从指向父页面的链接开始列表。

示例 最后一个宏的该页面

包含文本

{{include(Foo)}} -- 在此处包含页面 Foo 的文本，不包含任何特殊标记。

示例

执行 include 宏时出错（页面未找到）

如果包含的页面不存在或用户没有访问权限，将会显示错误消息。

代码高亮

代码高亮由 CodeRay 实现，这是一个用 Ruby 编写的快速库。它支持 C、C++、CSS、Delphi、Diff、Groovy、HTML、Java、Javascript、JSON、Nitro-XHTML、PHP、Python、RHTML、Ruby、Scheme、SQL、XML 和 YAML 的语法。

要高亮代码，请使用以下标记

<pre><code class="ruby">
  Place your code here.
</code></pre>

示例

# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!" 
  end
end

结论

简单的格式化功能可以通过输入字段上方的按钮访问，但是所有格式化选项都适用于 Redmine 中的任何文本：任务、新闻、评论等。
要查看 wiki 页面的更改历史，请点击右上方的“历史”链接。
以下列出的所有格式化选项的示例，可以查看本文的源代码。

1 Redmine 中不完全支持 Textile 语法。特别是，特殊字符（如（c）转换为 ©，-- 转换为 — 等）不会转换，也不支持 {color:red} 属性和 bq..、bc. 和 pre 块的格式。

2 很遗憾，不支持西里尔文：ИС（信息系统）

3 文本中的换行符会被解析器转换为 <br>。

4 如果链接与解释性短语分开，则不会处理链接：例如 [4] 或 "另一个例子"[4]。

由 Lucy Yevseyeva 更新 近 13 年前 · 9 修订版本