文字格式¶
- 目錄
- 文字格式
對於標題、文字強調、表格、清單等,Redmine 支援1 Textile 解析器。
行內元素¶
外部連結¶
http(s)、ftp 和 mail 地址會自動轉換為「可點擊」的連結
https://redmine.dev.org.tw: https://redmine.dev.org.tw
someone@foo.bar: someone@foo.bar。
若要在連結中放置任意文字,請使用以下標記
"Redmine 專案首頁":https://redmine.dev.org.tw: Redmine 專案首頁。
縮寫¶
可以使用以下方式在文字中簡潔地解釋縮寫2
JPL(Jean-Philippe Lang): JPL。
字體樣式¶
_斜體_: 斜體
*_粗斜體_*: 粗斜體
+底線+: 底線
-刪除線-: 刪除線
Plain ^上標^: 上標
Plain ~下標~: 下標
inline @等寬字體@: 等寬字體
??引用??: 引用
%span%: 區間
圖片¶
外部圖片
!image_url! -- 在文字中嵌入位於外部地址 image_url 的圖片。
!>image_url! -- 圖片靠右對齊,文字環繞圖片左側。
附件圖片
!attached_image.png! -- 在文字中嵌入附加到頁面的圖片 attached_image.png(請參閱警告)。
範例- !i0003.gif! 圖片,文字將在圖片後繼續
像這樣
- !>i0003.gif! 圖片顯示在文字右側
圖片在文字右側的範例
再次在文字右側
還是在文字右側
這裡圖片也在文字右側
這裡文字在圖片左側
區塊元素¶
為了正確處理 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。
對齊和縮排也會保留給所有後續透過換行(<br>
)
的文字。
在對齊的區塊元素與其他文字之間輸入空行會取消對齊。
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。
Pre 格式¶
在使用 標籤 標記的區塊內,文字不會被 剖析器 轉換。
若要避免 textile 標記被轉換為 html 程式碼,請使用 <pre></pre>
標籤。
<pre>Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].</pre>
引用¶
或> 「Ruby on Rails」是一個使用 Ruby 程式語言編寫的軟體框架。Ruby on Rails 為網頁應用程式提供了模型 - 視圖 - 控制器(Model-View-Controller)的架構模式,並且確保它們與網路伺服器和資料庫伺服器的整合。
bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails 「Ruby on Rails」是一個使用 Ruby 程式語言編寫的軟體框架。Ruby on Rails 為網頁應用程式提供了模型 - 視圖 - 控制器(Model-View-Controller)的架構模式,並且確保它們與網路伺服器和資料庫伺服器的整合。
>> 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
會顯示為
- 項目 1
- 項目 2
- 項目 2.1
- 項目 2.1.2
- 項目 2.2
- 項目 2.1
- 項目 3
- 項目 2.1.1
- 項目 0
# Item 1 # Item 2 ## Item 2.1 ## Item 2.1.1 ## Item 2.2 # Item 3 # Item 0
會顯示為
- 項目 1
- 項目 2
- 項目 2.2
- 項目 3
- 項目 2.1
- 項目 2.1.1
- 項目 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|會顯示為
使用者 ID | 姓名 | 群組 | 屬性清單 |
---|---|---|---|
IT | 靠左對齊 | ||
1 | Artur Pirozhkov | 使用者 | 靠右對齊 |
2 | Vasya Rogov | 置中 | |
3 | John Smith | 管理員3 (root) |
頂端對齊 |
4 | - | 沒有人 (匿名) |
底部對齊 |
註腳¶
註腳
21 fn21. 說明文字。
註腳連結4
說明文字[21]:說明文字21
分隔線¶
三個連字號 ---,與其他文字之間以換行符號分隔,會被轉換為 html 標籤 <hr>。
屬性¶
識別碼¶
p(#id). -- 為段落指定識別碼 id。
範例
此段落具有識別碼 id,例如,可以用於建立指向它的連結。
CSS 類別¶
p(class). -- 為段落指定類別 class。
範例
此段落包含以 Ruby 函式 樣式格式化的片語。
物件連結¶
若要避免 Redmine 標記被轉換為連結,請在其前面加上驚嘆號。
任務¶
#124:#124 -- 如果任務已關閉,則連結會加上刪除線。
版本¶
r758:r758
提交¶
commit:c6f4d0fd:commit:c6f4d0fd
Wiki 頁面¶
如果頁面不存在,則連結會顯示為紅色:不存在的頁面。
[[指南]]:指南
[[指南|使用者手冊]]:使用者手冊 -- 使用自訂文字的連結。
[[指南#使用者指南|使用者指南]]:使用者指南 -- 指向頁面特定標題的連結。
標題名稱中 # 符號之後的空格會以連字號取代。
[[someproject:some-page]] -- 指向另一個專案中 Wiki 頁面的連結。
[[someproject:]] -- 指向另一個專案 Wiki 首頁的連結。
文件¶
document#17 -- 透過 ID 連結到文件。
document:somedocument -- 透過名稱連結到文件。
document:"Some document" -- 如果名稱包含空格,請使用雙引號括起來。
document:some_project:"Some document" -- 透過名稱連結到另一個專案中的文件。
版本¶
version#3 -- 透過 ID 連結到版本。
version:1.0.0 -- 透過名稱連結到版本。
version:"1.0 beta 2" -- 如果名稱包含空格,請使用雙引號括起來。
專案¶
project#4 或 project:someid -- 透過數字或字元 ID 連結到專案。
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:webmaster@foo.bar?cc=admin@foo.bar: Email webmaster and admin -- 指定寄送副本的地址。
"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help: Email someone for help -- 指定郵件主旨。
"Email someone for help":mailto:someone@foo.bar?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 的內容,不含任何特殊符號。
範例
如果要包含的頁面不存在或使用者沒有存取權限,就會顯示錯誤訊息。
程式碼醒目提示¶
程式碼的語法高亮功能由 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 個版本