文字格式設定 - Redmine

文章推薦指數: 80 %
投票人數:10人

HTTP 連結也可以使用不同的文字來顯示:. "Redmine web site":http://www.redmine.org -- 使用不同文字的外部連結(標準的textile 語法) ... Signin Register Home Projects Help Search: Redmine Overview Download Activity Roadmap Issues News Wiki Forums Repository Latestreleases¶ 5.0.2(2022-06-21)4.2.7(2022-06-21) Resources¶ User'sGuideDeveloper'sGuideChangelog,SecurityFAQ,HowTo'sPlugins,ThemesPrivacyPolicy Wiki Startpage Indexbytitle Indexbydate History Guide»UserGuide»RedmineTextFormatting» 文字格式設定¶ 文字格式設定連結Redmine連結外部連結電子郵件地址 文字格式設定首字母縮寫字字型樣式顏色Inline影像標題段落水平線預定義格式引用文字項目清單編號清單表格目錄 巨集程式碼高亮度顯示Textile格式化 連結¶ Redmine連結¶ 在任何可以使用文字格式設定的地方,Redmine都允許在資源(問題、變更集、Wiki頁面...)間建立超連結。

連結至一個問題:#1(顯示#1,若該問題已結束,則會使用刪除線來顯示連結) 連結至一個問題的筆記:#124-6,或#124#note-6 連結至一個變更集:r758(顯示r758) 連結至一個使用非數字雜湊碼的變更集:commit:c6f4d0fd(顯示c6f4d0fd). Wiki連結: [[Guide]]顯示一個頁面名稱為'Guide'的連結:Guide [[Guide|Usermanual]]使用不同的文字來顯示相同頁面的連結:Usermanual [[Guide#User-guide|Userguide]]使用不同的文字來顯示相同頁面中某個標題的連結:Userguide 您也可以連結至其他專案的Wiki頁面(使用專案的代碼): [[sandbox:somepage]]顯示Sanbox專案wiki頁面的一個名為'Somepage'的連結 [[sandbox:]]顯示Sandbox專案wiki首頁的連結 當頁面不存在的時候,Wiki連結會以紅色的方式顯示,例如:Nonexistentpage. 連結至其他資源: 文件: document#17(連結到編號為17的文件) document:Greetings(連結至標題為"Greetings"的文件) document:"Somedocument"(文件標題包含空白字元時,可以使用雙引號來標示) sandbox:document:"Somedocument"(連結至"sandbox"專案中,標題為"Somedocument"的文件) 版本: version#3(連結至編號為3的版本) version:1.0.0(連結至名稱為"1.0.0"的版本) version:"1.0beta2"(版本名稱包含空白字元時,可以使用雙引號來標示) sandbox:version:1.0.0(連結至"sandbox"專案中,名稱為"1.0.0"的版本) 附加檔案: attachment:file.zip(連結至目前物件中,名稱為file.zip的附加檔案) attachment:"somefile.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:"somefile@52#L120"(當URL包含空白字元時,可以使用雙引號來標示)(連結至指定儲存機制中的此檔案,用於專案使用多個儲存機制時之情況) source:repo_identifier|some/file(連結至其他儲存機制中的檔案,用於使用多個儲存機制的專案) source:"repo_identifier|somefile"(連結至其他儲存機制中的檔案,有空白字元的檔名) export:some/file(強制下載此檔案) 論壇: forum#2(連結至編號為2的論壇) forum:Discussion(連結至名稱為"Discussion"的論壇) forum:"Helpandmore"(當論壇名稱包含空白字元時,可以使用雙引號來標示) 論壇訊息: message#1218(連結至編號為1218的訊息) 新聞項目: news#1(連結至編號為1的新聞項目) news:Greetings(連結至名稱為"Greetings"的新聞項目) news:"eCookbookfirstrelease!"(當新聞項目名稱包含空白字元時,可以使用雙引號來標示) 專案: project#3(連結至編號為3的專案) project:someproject(連結至名稱為"someproject"的專案) project:"Multiplewordsproject"(當專案名稱包含空白字元時,可以使用雙引號來標示) 逸出字元: 您可以在文字的前面加上驚嘆號(!)來避免該文字被剖析成Remine連結 外部連結¶ HTTP連結與電子郵件地址會自動被轉換成可點擊的連結: http://www.redmine.org--外部連結到redmine網站:http://www.redmine.org [email protected]連結到電子郵件地址:[email protected] HTTP連結也可以使用不同的文字來顯示: "Redminewebsite":http://www.redmine.org--使用不同文字的外部連結(標準的textile語法):Redminewebsite !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redminewebsite)!:http://www.redmine.org--顯示一個帶有標題並連結至URL的外部影像: 電子郵件地址¶ 電子郵件地址被自動轉為可點擊的連結: "Emailsomeone":mailto:[email protected]以不同文字顯示的電子郵件連結:Emailsomeone 更複雜的電子郵件指令可以被加入到電子郵件連結。

可以定義一個預設的主旨,預設的內文和CC資訊。

請注意,在這些欄位中的任何空白字元需要替換為%20。

"Emailwebmasterandadmin":mailto:[email protected][email protected]給webmaster,CC給admin:Emailwebmasterandadmin "Emailsomeoneforhelp":mailto:[email protected]?subject=Website%20Help--帶有主旨"WebsiteHelp"的電子郵件連結:Emailsomeoneforhelp "Emailsomeoneforhelp":mailto:[email protected]?subject=Website%20Help&body=My%20problem%20is%20--帶有主旨"WebsiteHelp"和預設內文的電子郵件連結:Emailsomeoneforhelp 文字格式設定¶ 對於像是標題、粗體字、表格、清單等項目,Redmine支援使用Textile語法http://redcloth.org/hobix.com/textile/關於使用這些格式化功能的說明資訊。

下面包含了一些使用範例,但格式化引擎的處理能力遠多於這些簡單的使用範例。

首字母縮寫字¶ JPL(Jean-PhilippeLang) 顯示: JPL 字型樣式¶ **bold* *_italic_ **_bolditalic_* *+underline+ *-strike-through- *Plain^superscript^ *Plain~subscript~ *@inlinemonospace@ *normal*bold*_italic_normal;E=mc^2^ *normal*bold*_italic_normal;E=mc^2^ *Escaping:*bold*_italic_@inlinemono@     AlternativeusingHTML-codes:*bold*_italic_@inlinemono@ *

*somelines*some"link":http://www.redmine.org
*
*somelines*some"link":http://www.redmine.org
顯示: bold italic bolditalic underline strike-through Plainsuperscript Plainsubscript inlinemonospace normalbolditalicnormal;E=mc2 normalbolditalicnormal;E=mc2 Escaping:*bold*_italic_@inlinemono@     AlternativeusingHTML-codes:*bold*_italic_@inlinemono@ *somelines*some"link":http://www.redmine.org somelinessomelink 顏色¶ *%{color:red}red%%{color:green}green%%{color:yellow}yellow%%{color:#82B6E1}blue'ish% *%{color:red}red%%{color:green}green%%{color:yellow}yellow%%{color:#82B6E1}blue'ish% *%{background:lightgreen}LightgreenBackground%%{background:yellow}YellowBackground% *%{background:lightgreen}LightgreenBackground%%{background:yellow}YellowBackground% 顯示: redgreenyellowblue'ish redgreenyellowblue'ish LightgreenBackgroundYellowBackground LightgreenBackgroundYellowBackground Inline影像¶ !image_url!顯示位於image_url的影像(textilesyntax) !>image_url!向右浮動的影像 !image_url(Imagetitle)!顯示具有alt/title屬性的影像 !image_url!:URL顯示位於image_url的影像,並加入URL連結 如果您有影像檔附加到您的wiki頁面,可以使用它的檔案名稱來inline顯示:!attached_image.png! 您也可以套用CSS樣式到影像,與套用樣式到SPAN相同。

程式碼!{width:100%}attached_image.png!將影像的大小調整為父元素的寬度。

標題¶ h1.Heading h2.Subheading h3.Subheading Redmine為每一種標題指定一個HTML錨點(anchor),因此您可使用"#Heading"、"#Subheading"等方式連結至這些標題。

段落¶ p.leftaligned p(.leftident1em p((.leftident2em aswellasforfollowinglines p>.rightaligned p)))>.rightident3em p=.Thisiscenteredparagraph. 水平線¶ ---- 顯示: 預定義格式¶ 若要逸出wiki語法
*您的文字將不會變成粗體字*
顯示: *您的文字將不會變成粗體字* 引用文字¶ 使用bq.開始一個引文段落: bq.Railsisafull-stackframeworkfordevelopingdatabase-backedwebapplicationsaccordingtotheModel-View-Controlpattern. Togolive,allyouneedtoaddisadatabaseandawebserver. 顯示: Railsisafull-stackframeworkfordevelopingdatabase-backedwebapplicationsaccordingtotheModel-View-Controlpattern.Togolive,allyouneedtoaddisadatabaseandawebserver. 您也可以在每一行的開頭使用>,然後堆疊它們進行巢狀的引用: >>Railsisafull-stackframeworkfordevelopingdatabase-backedwebapplicationsaccordingtotheModel-View-Controlpattern. >>Togolive,allyouneedtoaddisadatabaseandawebserver. >Great! 顯示: Railsisafull-stackframeworkfordevelopingdatabase-backedwebapplicationsaccordingtotheModel-View-Controlpattern.Togolive,allyouneedtoaddisadatabaseandawebserver. Great! 項目清單¶ *Item1 *Item2 **Item21 **Item22 *Item3 顯示: Item1 Item2 Item21 Item22 Item3 編號清單¶ #Item1 #Item2 #Item3 ##Item3.1 ##Item3.2 顯示: Item1 Item2 Item3 Item3.1 Item3.2 表格¶ |_.UserID|_.Name|_.Group|_.attributelist| |Startingwith|a|simple|row| |\3=.IT|<.alignleft>.alignright| |2|VasyaRogov|=.center| |3|JohnSmith|Admin (root)|^.valigntop| |4|-|Nobody (anonymous)|~.valignbottom| 顯示(所有多個空白字元將被取代為一個空白): UserID Name Group attributelist Startingwith a simple row IT alignleft 1 ArturPirozhkov Users alignright 2 VasyaRogov center 3 JohnSmith Admin(root) valigntop 4 - Nobody(anonymous) valignbottom 如果您要在你表格中(例如,wiki連結)包含管線字元(|),您必須防止textile解譯它們: Input Output | | 目錄¶ {{toc}}=>靠左對齊目錄 {{>toc}}=>靠右對齊目錄 請記得,toc標記的上一行和下一行必須是空白行,而且它的前後不能有其它文字。

範例: h1.headLineOne h2.something {{toc}} h2.somethingmore 巨集¶ Redmine包含一個巨集系統,允許您加入自訂函數,以在格式化文字中插入動態內容。

您可以學習編寫您自己的巨集,在RedmineMacros。

Redmine已包含幾個內建巨集: hello_worldSamplemacro.macro_listDisplaysalistofallavailablemacros,includingdescriptionifavailable.child_pagesDisplaysalistofchildpages.Withnoargument,itdisplaysthechildpagesofthecurrentwikipage.Examples: !{{child_pages}}--canbeusedfromawikipageonly !{{child_pages(depth=2)}}--display2levelsnestingonlyincludeIncludeawikipage.Example: !{{include(Foo)}} ortoincludeapageofaspecificprojectwiki: !{{include(projectname:Foo)}}collapseInsertsofcollapsedblockoftext.Example: {{collapse(Viewdetails...) Thisisablockoftextthatiscollapsedbydefault. Itcanbeexpandedbyclickingalink. }}thumbnailDisplaysaclickablethumbnailofanattachedimage.Examples: {{thumbnail(image.png)}} {{thumbnail(image.png,size=300,title=Thumbnail)}}sample_macroSamplemacro 程式碼高亮度顯示¶ 程式碼高亮度顯示依賴CodeRayRuby所編寫的。

它目前支援C,C++,CSS,Delphi,Diff,Groovy,HTML,Java,Javascript,JSON,Nitro-XHTML,PHP,Python,RHTML,Ruby,Scheme,SQL,XML和YAML程式碼。

您可以在您的wiki頁面中高亮度顯示程式碼,使用以下的語法:

Placeyourcodehere.
範例: #TheGreeterclass classGreeter definitialize(name) @name=name.capitalize end defsalute puts"Hello#{@name}!" end end Textile格式化¶ Redmine支援textile格式化。

詳細資訊請參閱Textilesyntax 額外支援的textiles: %{background:lightgreen}綠色背景%顯示綠色背景 Loading... PoweredbyRedmine©2006-2014Jean-PhilippeLang


請為這篇文章評分?