文字格式¶
連結¶
Redmine 連結¶
Redmine 文字格式允許您在任何使用它的地方建立資源之間的連結(例如,議題、變更集、Wiki 頁面...)。
- 議題連結:#124(顯示 #124 號議題,如果議題已關閉,則會顯示刪除線)
- 議題備註連結:#124-6 或 #124!#note-6
- 變更集連結:r758(顯示 r758 變更集)
- 非數字雜湊的變更集連結:commit:c6f4d0fd(顯示 c6f4d0fd 變更集)。
Wiki 連結
- [[指南]] 建立一個指向名為「指南」頁面的連結:指南
- [[指南|使用者手冊]] 建立一個指向相同頁面但使用不同名稱的連結:使用者手冊
- [[指南#使用者指南|使用者指南]] 建立一個指向相同頁面中特定標題的連結,並使用不同的名稱:使用者指南
您也可以建立指向其他專案中 Wiki 頁面的連結(使用專案識別碼)
- [[sandbox:某個頁面]] 建立一個指向 Sandbox 專案中「某個頁面」的連結
- [[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" -- 如果 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 會自動轉換為可點選的連結- 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 -- 建立寄送電子郵件給網站管理員並將管理員 CC 的連結:寄送電子郵件給網站管理員和管理員
- "寄送電子郵件給某人尋求協助":mailto:someone@foo.bar?subject=網站%20協助 -- 建立主旨為「網站協助」的電子郵件連結:寄送電子郵件給某人尋求協助
- "寄送電子郵件給某人尋求協助":mailto:someone@foo.bar?subject=網站%20協助&body=我的%20問題%20是%20 -- 建立主旨為「網站協助」且包含預設內文的電子郵件連結:寄送電子郵件給某人尋求協助
文字格式¶
Redmine 支援「Textile」文字解譯函式庫,可用於標題、粗體文字、表格、清單等。 http://en.wikipedia.org/wiki/Textile_%28markup_language%29。如需關於這些功能的詳細資訊,請造訪 http://redcloth.org/hobix.com/textile/。以下是一些範例,但您可以使用該函式庫執行更多操作。
縮寫¶
JPL(Jean-Philippe Lang)
外觀
JPL
字體樣式¶
* *kalın*
* _italik_
* *_kalın italik_*
* +altı çizili+
* -üstü-çizili-
* Düz ^üstyazı^
* Düz ~altyazı~
* @inline monospace@
* normal *kalın* _italik_ normal;E=mc ^2^
* normal<notextile></notextile>*kalın*<notextile></notextile>_italik_<notextile></notextile>normal;E=mc<notextile></notextile>^2^
* Engelleme: <notextile>*kalın* _italik_ @inlinemono@</notextile> HTML alternatif: *kalın* _italik_ @inlinemono@
* <pre>*some lines* some "link":https://redmine.dev.org.tw</pre>
* <pre><notextile></notextile>*some lines* some "link":https://redmine.dev.org.tw</pre>
外觀
- 粗體
- 斜體
- 粗斜體
- 底線
刪除線- 純文字 上標
- 純文字 下標
等寬字體
- 正常 粗體 斜體 正常;E=mc 2
- 正常粗體斜體正常;E=mc2
- 跳脫字元: *粗體* _斜體_ @等寬字體@ 使用 HTML 代碼的替代方案: *粗體* _斜體_ @等寬字體@
*some lines* some "link":https://redmine.dev.org.tw
some lines some link
顏色¶
* %{color:red}kırmızı% %{color:green}yeşil% %{color:yellow}sarı% %{color:#82B6E1}mavimsi%
* %{color:red}kırmızı%<notextile></notextile>%{color:green}yeşil%<notextile></notextile>%{color:yellow}sarı%<notextile></notextile>%{color:#82B6E1}mavimsi%
* %{background:lightgreen}Açık yeşil arkaplan% %{background:yellow}Sarı arkaplan%
* %{background:lightgreen}Açık yeşil arkaplan%<notextile></notextile>%{background:yellow}Sarı arkaplan%
外觀
- 紅色 綠色 黃色 藍色
- 紅色綠色黃色藍色
- 淺綠色背景 黃色背景
- 淺綠色背景黃色背景
行內圖片¶
- !圖片網址! 位於圖片網址的圖片 (textile 語法)
- !>圖片網址! 右對齊圖片
- !圖片網址(圖片標題)! 具有 alt/title 屬性的圖片
- !圖片網址!:網址 位於圖片網址,連結至網址的圖片
如果您的 Wiki 頁面中有圖片附件,則可以使用檔案名稱顯示: !已附加圖片.png!
與 SPAN 元素類似,CSS 樣式也可以套用至圖片。程式碼片段 !{width: 100%}已附加圖片.png! 將會調整圖片大小以符合其父元素的寬度。
標題¶
h1. Başlık
h2. AltBaşlık
h3. AltBaşlık
Redmine 會建立連結,讓您隨時可以返回標題,例如「#標題」、「#子標題」。
段落¶
p. sola yaslanmış
p(. soldan 1em içeride
p((. soldan 2em içeride
ve aşağıdaki satırlar
p>. sağa yaslanmış
p)))>. sağdan 3em içeride
p=. Ortalanmış paragraf.
水平線¶
----
外觀
預先格式化的文字¶
若要停用 Wiki 格式
<pre> *Yazınız kalın olmayacak* </pre>
外觀
*Yazınız kalın olmayacak*
區塊引言¶
以 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
- 項目 2.1
- 項目 2.2
- 項目 3
有序清單¶
# Item 1 # Item 2 # Item 3 ## Item 3.1 ## Item 3.2
外觀
- 項目 1
- 項目 2
- 項目 3
- 項目 3.1
- 項目 3.2
表格¶
|_.UserID |_.Name |_.Group |_. attribute list | |Basit | bir | satırla |başlayalım | |\3=.IT |<. sola yasla | |1 |Artur Pirozhkov |/2.Users |>. sağa yasla | |2 |Vasya Rogov |=. ortala | |3 |John Smith |Admin (root) |^. yukarı yasla | |4 |- |Nobody (anonymous) |~. aşağı yasla |
外觀(多個空格將會縮減為一個)
使用者 ID | 姓名 | 群組 | 屬性清單 |
---|---|---|---|
簡單 | 從 | 一行 | 開始 |
IT | 左對齊 | ||
1 | Artur Pirozhkov | 使用者 | 右對齊 |
2 | Vasya Rogov | 置中 | |
3 | John Smith | 管理員 (root) |
靠上對齊 |
4 | - | 沒有人 (匿名使用者) |
靠下對齊 |
如果要在表格中使用 | 字元(例如用於 Wiki 連結),則必須停用 textile 解譯
輸入 | 輸出 |
---|---|
<notextile>|</notextile> | | |
目錄¶
{{toc}} => sola yaslanmış içindekiler
{{>toc}} => sağa yaslanmış içindekiler
請注意,「toc」的前後必須是空行,而且旁邊不能有任何其他文字。
例如:
h1. headLineOne
h2. something
{{toc}}
h2. something more
巨集¶
Redmine 擁有一個巨集系統,可讓您在格式化的文字中動態插入內容。欲深入了解如何編寫自己的巨集,請參閱 RedmineMacros。Redmine 中也有一些預先定義的巨集
hello_world
Sample macro.
macro_list
Displays a list of all available macros, including description if available.
子頁面
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
程式碼著色¶
程式碼著色是透過一個完全以 Ruby 編寫的名為 CodeRay 的程式庫來完成的。目前支援的語言包括: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">
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
Textile 格式¶
Redmine 支援 textile 格式程式庫。如需詳細資訊,請參閱 Textile 語法
其他支援的 textile 標記標籤- %{background:lightgreen}綠色背景% 顯示為 綠色背景
翻譯¶
請注意,翻譯可能並非最新版本。如有必要,請參閱英文文件。
本文件由 Mustafa Ergin 翻譯成土耳其文。
由 Mustafa Ergin 於 大約 10 年前 更新 · 3 個版本