项目

常规

个人资料

操作
历史记录

指南 » 用户指南 » Redmine文本格式化 »

文本格式化

以下是Textile文本格式化的格式化，要使用Markdown格式化，请参阅#15520

链接

Redmine链接

Redmine允许从任何使用的格式创建到资源（任务、修订、维基页面等）的超链接。

  • 任务链接：#124（显示#124，如果任务已关闭，则链接会被删除线标注）
  • 任务笔记链接：#124-6，或 #124!#note-6
  • 修订链接：r758（显示r758）
  • 非数字哈希的修订链接：commit:c6f4d0fd（显示c6f4d0fd）。

维基链接

  • [[Guide]] 显示到命名页面 'Guide' 的链接：Guide
  • [[Guide|用户手册]] 显示到该页面的链接，但文本不同：用户手册
  • [[Guide#User-guide|用户指南]] 显示到该页面的标题链接，但文本不同：用户指南

您还可以链接到其他项目的维基页面（使用项目标识符）

  • [[sandbox:some page]] 显示到Sandbox项目名为 'Some page' 的维基页面的链接
  • [[sandbox:]] 显示到Sandbox项目维基主页的链接

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

其他资源链接

  • 文档
    • document#17（链接到ID为17的文档）
    • document:Greetings（链接到标题为 "Greetings" 的文档）
    • 文档："Some document"（当文档标题包含空格时，应使用双引号）
    • 沙盒：文档："Some document"（指向名为“Some document”的“sandbox”项目文档的链接）
  • 版本
    • version#3（指向id为3的版本链接）
    • version:1.0.0（指向名为“1.0.0”的版本链接）
    • version："1.0 beta 2"（如果版本名称包含空格，则必须使用双引号）
    • 沙盒：version:1.0.0（指向“sandbox”项目中的“1.0.0”版本链接）
  • 附件
    • attachment:file.zip（指向名为“file.zip”的附件链接）
    • attachment："file.zip"（如果文件名包含特殊字符，则必须使用双引号）
    • 目前，只能引用当前资源（如果在一个任务中，则只能引用此任务中的附件）
  • 修订
    • r758（指向修订的链接）
    • commit:c6f4d0fd（指向具有非数字哈希的修订的链接）
    • svn1|r758（指向具有多个存储库的项目中的特定存储库的修订的链接）
    • commit:hg|c6f4d0fd（指向具有非数字哈希的特定存储库的修订的链接）
    • 沙盒：r758（指向另一个项目的修订的链接）
    • 沙盒：commit:c6f4d0fd（指向另一个项目的具有非数字哈希的修订的链接）
  • 存储库文件
    • source:some/file -- 指向项目存储库中/some/file的本地文件链接
    • source:some/file@52 -- 指向文件的第52次修订的链接
    • source:some/file#L120 -- 指向文件的第120行的链接
    • source:some/file@52#L120 -- 指向文件第52次修订的第120行的链接
    • source："some file@52#L120" -- 如果URL包含空格，则必须使用双引号
    • source:repo_identifier|some/file -- 指向非项目默认存储库的文件的链接
    • source："repo_identifier|some file" -- 指向非项目默认存储库的文件的链接，文件名包含空格
    • export:some/file -- 强制下载文件
  • 论坛
    • forum#2（指向id为2的论坛链接）
    • forum:Discussion（指向名为“Discussion”的论坛链接）
    • forum："Help and more"（如果论坛名称包含空格，则必须使用双引号）
  • 论坛消息
    • message#1218（指向id为1218的消息链接）
  • 新闻
    • news#1（指向id为1的新闻链接）
    • news:Greetings（指向名为“Greetings”的新闻链接）
    • news："eCookbook first release !" （如果新闻名称包含空格，则必须使用双引号）
  • 项目
    • project#3（指向id为3的项目链接）
    • project:someproject（指向名为“someproject”的项目链接）
    • project："Multiple words project"（如果项目名称包含空格，则必须使用双引号）

转义

  • 您可以在前面加上感叹号来避免处理Redmine链接：！

外部链接

HTTP URL会自动转换为超链接HTTP URL也可以使用自定义文本而不是URL
  • "Redmine web site":https://redmine.ruby-lang.org.cn -- 自定义文本的超链接： Redmine web site
  • !https://redmine.ruby-lang.org.cn/attachments/7069/Redmine_logo.png(Redmine web site)!:https://redmine.ruby-lang.org.cn -- 带标题的图片链接到URL

Redmine web site

电子邮件地址

电子邮件地址会自动转换为超链接

可以添加附加说明到电子邮件链接。可以包含主题、正文和抄送（CC）的预设。注意，这些字段中的空格应替换为代码%20。

文本格式

对于标题、粗体、表格、列表等元素，Redmine 支持以下语法： Textile 语法。有关功能使用信息，请参阅 http://redcloth.org/hobix.com/textile/。以下是一些示例，但此功能的能力更强大。

缩写

JPL(Jean-Philippe Lang)

显示

JPL

字体样式

* *negrito*
* _itálico_
* *_negrito itálico_*
* +sublinhado+
* -riscado-
* Texto ^sobrescrito^
* Texto ~subscrito~
* @Monoespaçado em linha@
* normal *negrito* _itálico_ normal;E=mc ^2^
* normal<notextile></notextile>*negrito*<notextile></notextile>_itálico_<notextile></notextile>normal;E=mc<notextile></notextile>^2^
* Escapando: <notextile>*negrito* _itálico_ @monoespaçado@</notextile> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Alternativa usando códigos HTML: &#42;negrito&#42; &#95;itálico&#95; &#64;monoespaçado&#64;
* <pre>*algumas linhas*      algum "link":https://redmine.ruby-lang.org.cn</pre>
* <pre><notextile></notextile>*algumas linhas*      algum "link":https://redmine.ruby-lang.org.cn</pre>

显示

  • 粗体
  • 斜体
  • 粗体斜体
  • 下划线
  • 删除线
  • 上标文本sobrescrito
  • 下标文本subscrito
  • 单倍间距
  • 普通 粗体 斜体 普通;E=mc 2
  • 普通粗体斜体普通;E=mc2
  • 转义： *粗体* _斜体_ @单倍间距@       使用 HTML 代码的替代方案： *粗体* _斜体_ @单倍间距@
  • *algumas linhas*      algum "link":https://redmine.ruby-lang.org.cn
  • algumas linhas      algum link

颜色

* %{color:red}vermelho% %{color:green}verde% %{color:yellow}amarelo% %{color:#82B6E1}azul%
* %{color:red}vermelho%<notextile></notextile>%{color:green}verde%<notextile></notextile>%{color:yellow}amarelo%<notextile></notextile>%{color:#82B6E1}azul%
* %{background:lightgreen}Fundo verde-claro% %{background:yellow}Fundo amarelo%
* %{background:lightgreen}Fundo verde-claro%<notextile></notextile>%{background:yellow}Fundo amarelo%

显示

  • 红色 绿色 黄色 蓝色
  • 红色绿色黄色蓝色
  • 浅绿色背景 黄色背景
  • 浅绿色背景黄色背景

图片

  • !image_url! 显示位于 image_url 的图片（Textile 语法）
  • !>image_url! 右对齐图片
  • !image_url(Image title)! 显示带有 alt/title 属性的图片
  • !image_url!:URL 显示位于 image_url 的图片并带有嵌入链接

如果您在页面 wiki 中附加了图片，可以提供文件名来插入： !attached_image.png!

您也可以像样式 SPAN 一样应用 CSS 样式到图片。代码 !{width: 100%}attached_image.png! 会根据父元素宽度调整图片大小。

标题

h1. Título

h2. Subtítulo

h3. Subtítulo

Redmine 为每个标题分配一个锚点，因此您可以使用 “#Heading”、“#Subheading” 等链接到它们。

段落

p. alinhado à esquerda

  p(. identado à esquerda em 1em

    p((. identado à esquerda em  2em
    bem como as seguintes linhas

                                                                                   p>. alinhado à direita

                                                                        p)))>. identado à direita em 3em

                           p=. Parágrafo centralizado.

水平线

----
显示

预设

要转义 wiki 语法

 <pre> *Seu texto não será negrito* </pre>

显示

 *Seu texto não será negrito*

引用

在段落开头使用 bq.

bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.

显示

Rails 是一个全栈框架，用于根据 MVC 模式开发数据库支持的 Web 应用程序。
要上线，您只需添加数据库和 Web 服务器即可。

您还可以在每个行首使用 > 并堆叠它们来嵌套引用

>> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
>> To go live, all you need to add is a database and a web server.
> Great!

显示

Rails 是一个全栈框架，用于根据 MVC 模式开发数据库支持的 Web 应用程序。
要上线，您只需添加数据库和 Web 服务器即可。

太好了！

无序列表

* Item 1
* Item 2
** Item 21
** Item 22
* Item 3

显示

  • 项目 1
  • 项目 2
    • 项目 21
    • 项目 22
  • 项目 3

有序列表

# Item 1
# Item 2
# Item 3
## Item 3.1
## Item 3.2

显示

  1. 项目 1
  2. 项目 2
  3. 项目 3
    1. 项目 3.1
    2. 项目 3.2

表格

|_.UserID      |_.Nome          |_.Grupo     |_. lista atributos  |
|Iniciando com | uma            |   simples  |linha               |
|\3=.TI                                      |<. alinha esquerda  |
|1             |Artur Pirozhkov |/2.Users    |>. alinha direita   |
|2             |Vasya Rogov     |=. centraliza |
|3             |John Smith      |Admin
                                 (root)      |^. alinha topo      |
|4             |-               |Ninguém
                                 (anônimo)   |~. alinha base      |

显示（所有多个空格均替换为1个空格）

用户ID 名字 组 属性列表
从 一个 简单的 行
TI 左对齐
1 Artur Pirozhkov 用户 右对齐
2 Vasya Rogov 居中
3 John Smith 管理员
(root)		 顶部对齐
4 - 无人
(匿名)		 底部对齐

如果您想在表格中插入|（竖线）字符（例如：Wiki链接），则需要防止textile将其解释

输入 输出
<notextile>|</notextile> |

内容表（TOC）

{{toc}} => toc alinhado à esquerda
{{>toc}} => toc alinhado à direita

请注意，TOC的标签需要在其前后各有一行空行。

示例


h1. TítuloUm

h2. subtítulo

{{toc}}

h2. outro subtítulo

宏

Redmine包含一个宏系统，允许在格式化文本中添加自定义函数以插入动态内容。您可以在RedmineMacros中学习如何编写自己的宏。Redmine还包含一些预定义的宏

hello_world
Sample macro.
macro_list
Displays a list of all available macros, including description if available.
child_pages
Displays a list of child pages. With no argument, it displays the child pages of the current wiki page. Examples:

{{child_pages}} -- can be used from a wiki page only
{{child_pages(depth=2)}} -- display 2 levels nesting only
{{child_pages(Foo)}} -- lists all children of page Foo
{{child_pages(Foo, parent=1)}} -- same as above with a link to page Foo
include
Includes a wiki page. Examples:

{{include(Foo)}}
{{include(projectname:Foo)}} -- to include a page of a specific project wiki
collapse
Inserts of collapsed block of text. Examples:

{{collapse
This is a block of text that is collapsed by default.
It can be expanded by clicking a link.
}}

{{collapse(View details...)
With custom link text.
}}
thumbnail
Displays a clickable thumbnail of an attached image.
Default size is 200 pixels. Examples:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}} -- with custom title and size
issue
Displays an issue link including additional information. Examples:

{{issue(123)}}                              -- Issue #123: Enhance macro capabilities
{{issue(123, project=true)}}                -- Andromeda - Issue #123: Enhance macro capabilities
{{issue(123, tracker=false)}}               -- #123: Enhance macro capabilities
{{issue(123, subject=false, project=true)}} -- Andromeda - Issue #123
sample_macro
Sample macro

突出显示代码

Redmine使用CodeRay来突出显示代码，这是一个完全用Ruby编写的库。它支持C、C++、CSS、Delphi、Diff、Groovy、HTML、Java、Javascript、JSON、Nitro-XHTML、PHP、Python、RHTML、Ruby、Scheme、SQL、XML和YAML代码。

您可以使用以下语法在Wiki页面中突出显示代码

<pre><code class="ruby">
  Insira o código aqui.
</code></pre>

示例

# A classe Cumprimentar
class Cumprimentar
  def initialize(nome)
    @nome = nome.capitalize
  end

  def cumprimente
    puts "Olá #{@nome}!" 
  end
end

Textile格式化

Redmine支持Textile格式。有关详细信息，请参阅：Textile语法

支持的Textile附加格式化
  • %{background:lightgreen}背景绿色%显示背景绿色

由Isaac Batista更新 近3年前 · 2次修订