文字格式¶
以下為 Textile 文字格式,如需 Markdown 格式,請參閱 #15520
連結¶
Redmine 連結¶
Redmine 允許使用任何格式在資源之間建立超連結(任務、版本、Wiki 頁面...)。
- 連結到任務:#124(顯示 #124,如果任務已關閉,連結會顯示為刪除線)
- 連結到任務註記:#124-6 或 #124!#note-6
- 連結到版本:r758(顯示 r758)
- 連結到具有非數字雜湊的版本:commit:c6f4d0fd(顯示 c6f4d0fd)。
Wiki 連結
- [[指南]] 顯示指向名為「指南」頁面的連結:指南
- [[指南|使用者手冊]] 顯示指向該頁面的連結,但使用不同的文字:使用者手冊
- [[指南#使用者指南|使用者指南]] 顯示指向該頁面標題的連結,但使用不同的文字:使用者指南
您也可以連結到其他專案的 Wiki 頁面(使用專案識別碼)
- [[sandbox:某個頁面]] 顯示指向 Sandbox 專案中名為「某個頁面」的 Wiki 頁面的連結
- [[sandbox:]] 顯示指向 Sandbox 專案 Wiki 首頁的連結
如果頁面不存在,Wiki 連結會顯示為紅色,例如:不存在的頁面。
連結到其他資源
- 文件
- document#17(連結到 ID 為 17 的文件)
- document:問候語(連結到標題為「問候語」的文件)
- document:"某個文件"(如果文件標題包含空格,則必須使用雙引號)
- sandbox:document:"一些文件" (鏈接到項目「sandbox」中標題為「一些文件」的文件)
- 版本
- version#3 (鏈接到 ID 為 3 的版本)
- version:1.0.0 (鏈接到名為「1.0.0」的版本)
- version:"1.0 beta 2" (如果版本名稱包含空格,則應使用雙引號)
- sandbox:version:1.0.0 (鏈接到項目「sandbox」的「1.0.0」版本)
- 附件
- attachment:file.zip (鏈接到名為 file.zip 的附件)
- attachment:"file.zip" (如果文件名包含特殊字符,則應使用雙引號)
- 目前,您只能參考當前資源的附件(如果您在一個任務中,則只能參考該任務的附件)
- 修訂
- r758 (鏈接到修訂)
- commit:c6f4d0fd (鏈接到具有非數字哈希值的修訂)
- svn1|r758 (鏈接到特定倉庫的修訂,適用於具有多個倉庫的項目)
- commit:hg|c6f4d0fd (鏈接到特定倉庫中具有非數字哈希值的修訂)
- sandbox:r758 (鏈接到另一個項目的修訂)
- sandbox: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" -- 如果網址包含空格,則應使用雙引號
- source:repo_identifier|some/file -- 鏈接到項目默認倉庫以外的其他倉庫中的文件。
- source:"repo_identifier|some file" -- 鏈接到項目默認倉庫以外的其他倉庫中的文件,文件名包含空格。
- export:some/file -- 強制下載文件
- 論壇
- forum#2 (鏈接到 ID 為 2 的論壇)
- forum:討論區 (鏈接到名為「討論區」的論壇)
- forum:"幫助和更多" (如果論壇名稱包含空格,則應使用雙引號)
- 論壇訊息
- message#1218 (鏈接到 ID 為 1218 的訊息)
- 新聞
- news#1 (鏈接到 ID 為 1 的新聞)
- news:問候 (鏈接到名為「問候」的新聞)
- news:"eCookbook 首次發布!" (如果新聞標題包含空格,則應使用雙引號)
- 項目
- project#3 (鏈接到 ID 為 3 的項目)
- project:某個項目 (鏈接到名為「某個項目」的項目)
- project:"多詞項目" (如果項目名稱包含空格,則應使用雙引號)
跳脫字符
- 您可以透過在其前面加上驚嘆號來防止處理 Redmine 鏈接:!
外部連結¶
HTTP 網址會自動轉換為超連結- https://redmine.dev.org.tw -- Redmine 網站的外部連結:https://redmine.dev.org.tw
- someone@foo.bar -- 電子郵件地址的鏈接:someone@foo.bar
- "Redmine 網站":https://redmine.dev.org.tw -- 具有自定義文字的外部連結:Redmine 網站
- !https://redmine.dev.org.tw/attachments/7069/Redmine_logo.png(Redmine 網站)!:https://redmine.dev.org.tw -- 具有鏈接到網址的標題的外部圖片
電子郵件地址¶
電子郵件地址會自動轉換為超連結
- "發送電子郵件給某人":mailto:someone@foo.bar -- 具有自定義文字的電子郵件鏈接:發送電子郵件給某人
- "寄送電子郵件給站長和管理員":mailto:webmaster@foo.bar?cc=admin@foo.bar -- 寄送電子郵件給站長,並將管理員加入副本:寄送電子郵件給站長和管理員
- "寄送電子郵件給某人尋求協助":mailto:someone@foo.bar?subject=網站%20協助 -- 主旨為「網站協助」的電子郵件連結:寄送電子郵件給某人尋求協助
- "寄送電子郵件給某人尋求協助":mailto:someone@foo.bar?subject=網站%20協助&body=我的%20問題%20是%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> Alternativa usando códigos HTML: *negrito* _itálico_ @monoespaçado@
* <pre>*algumas linhas* algum "link":https://redmine.dev.org.tw</pre>
* <pre><notextile></notextile>*algumas linhas* algum "link":https://redmine.dev.org.tw</pre>
顯示
- 粗體
- 斜體
- 粗斜體
- 底線
刪除線- 上標文字
- 下標文字
等寬字體
- 正常 粗體 斜體 正常;E=mc 2
- 正常粗體斜體正常;E=mc2
- 跳脫字元:*粗體* _斜體_ @等寬字體@ 使用 HTML 代碼的替代方案:*粗體* _斜體_ @等寬字體@
*algumas linhas* algum "link":https://redmine.dev.org.tw
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(圖片標題)! 顯示具有 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 會為每個標題指派一個錨點,因此您可以使用「#標題」、「#子標題」等方式連結到它們。
段落¶
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 是一個全端框架,用於根據模型-視圖-控制器模式開發資料庫驅動的網路應用程式。
若要上線,您只需新增資料庫和網路伺服器即可。
您也可以在每行的開頭使用 >,並將其堆疊起來以建立巢狀引言
>> 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 是一個全端框架,用於根據模型-視圖-控制器模式開發資料庫驅動的網路應用程式。
若要上線,您只需新增資料庫和網路伺服器即可。太棒了!
非排序清單¶
* 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
- 項目 2
- 項目 3
- 項目 3.1
- 項目 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 個版本