Wiki記法
リンク
RedmineはWiki記法が使える箇所のどこからでも、チケット・チェンジセット・Wikiページなどリソース間へリンクを行うことができます。
- チケットへのリンク: #124 (終了したチケットは
#124 のように取り消し線付きで表示されます)
- チケットの注記へのリンク: #124-6 または #124#note-6
Wikiへのリンク:
- [[Guide]] "Guide"という名前のページへのリンクです: Guide
- [[Guide#further-reading]] "Guide"というページ内の"further-reading"というアンカーに飛びます。見出しには自動的にアンカーが設定されるのでリンク先とすることができます: Guide
- [[Guide|User manual]] "Guide"というページへのリンクを異なるテキストで表示: User manual
別のプロジェクトのwikiへのリンクも可能です:
- [[sandbox:some page]] sandboxという名前のプロジェクトのwikiの"some page"という名前のページへのリンク
- [[sandbox:]] sanbdoxという名前のプロジェクトのwikiのメインページへのリンク
存在しないwikiページへのリンクは赤で表示されます。 例: Nonexistent page.
そのほかのリソースへのリンク:
- Documents:
- document#17 (id 17の文書へのリンク)
- document:Greetings ("Greetings" というタイトルの文書へのリンク)
- document:"Some document" (文書のタイトルに空白が含まれる場合はダブルクォーテーションで囲んでください)
- sandbox:document:"Some document" ("sandbox" というプロジェクトの "Some document" というタイトルの文書へのリンク)
- Versions:
- 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 というファイルへのリンク)
- 現在のオブジェクト上の添付ファイルのみリンク先として指定可能です (例えばあるチケットからは、そのチケットに添付されたファイルのみリンク先にできます)
- チェンジセット:
- 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にスペースが含まれる場合はダブルクォーテーションで囲んでください)
- export:some/file (ファイルのダウンロードを強制)
- source:svn1|some/file (複数のリポジトリが設定されたプロジェクトで、特定のリポジトリのファイルへのリンク)
- sandbox:source:some/file ("sandbox" というプロジェクトのリポジトリ上の /some/file というファイルへのリンク)
- sandbox:export:some/file (ファイルのダウンロードを強制)
- フォーラム:
- forum#1 (id 1のフォーラムへのリンク)
- forum:Support ("Support"という名前のフォーラムへのリンク)
- forum:"Technical Support" (フォーラム名に空白が含まれる場合はダブルクォーテーションで囲んでください)
- フォーラムのメッセージ:
- message#1218 (id 1218のメッセージへのリンク)
- プロジェクト:
- project#3 (id 3のプロジェクトへのリンク)
- project:someproject ("someproject"という名前のプロジェクトへのリンク)
- project:"some project" (プロジェクト名に空白が含まれる場合はダブルクォーテーションで囲んでください)
- ニュース:
- news#2 (id 2のニュースへのリンク)
- news:Greetings ("Greetings"というタイトルのニュースへのリンク)
- news:"First Release" (タイトルに空白が含まれる場合はダブルクォーテーションで囲んでください)
エスケープ:
- テキストをRedmineのリンクとして解釈させたくない場合は感嘆符 ! を前につけてください。
外部リンク
HTTP URLとメールアドレスは自動的にリンクになります:
http://www.redmine.org, someone@foo.bar
上記の記述は次のように表示されます: http://www.redmine.org, someone@foo.bar
URLのかわりに別のテキストを表示させたい場合は、標準的なtextile記法が利用できます:
"Redmine web site":http://www.redmine.org
上記の記述は次のように表示されます: Redmine web site
テキストの書式
見出し、太字、テーブル、リスト等は、RedmineはTextile記法での記述に対応しています。Textile記法の詳細は http://en.wikipedia.org/wiki/Textile_(markup_language) を参照してください。Textileの一例を以下に示しますが、実際にはここで取り上げた以外の記法にも対応しています。
文字の書式
* *太字*
* _斜体_
* _*太字で斜体*_
* +下線+
* -取り消し線-
表示例:
画像
- !image_url! image_urlで指定されたURLの画像を表示 (Textile記法)
- !>image_url! 画像を右寄せ・テキスト回り込みありで表示
- Wikiページに添付された画像があれば、ファイル名を指定して画像を表示させることができます: !attached_image.png!
見出し
h1. Heading
h2. Subheading
h3. Subsubheading
Redmineは見出しにアンカーを設定するので、"#Heading", "#Subheading"などを指定してリンクが行えます。
段落
p>. 右寄せ
p=. センタリング
センタリングされた段落
引用
段落を 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 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.
目次
{{toc}} => 目次(左寄せ)
{{>toc}} => 目次(右寄せ)
区切り線
---
マクロ
Redmineには以下の組み込みマクロが用意されています:
hello_world
サンプルのマクロです。
macro_list
上記のマクロを含め、利用可能なマクロの一覧を表示します。
child_pages
子ページの一覧を表示します。引数の指定が無ければ現在のwikiページの子ページを表示します。以下は使用例です:
{{child_pages}} -- wikiページでのみ使用可能です
{{child_pages(depth=2)}} -- 2階層分のみ表示します
include
別のWikiページの内容を挿入します。 以下は使用例です:
{{include(Foo)}}
プロジェクトを指定することもできます。:
{{include(projectname:Foo)}}
collapse
折り畳まれた状態のテキストを挿入します。以下は使用例です:
{{collapse(詳細を表示...)
この部分はデフォルトでは折り畳まれた状態で表示されます。
リンクをクリックすると展開されます。
}}
thumbnail
添付ファイルのクリック可能なサムネイル画像を表示します。以下は使用例です:
{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}}
コードハイライト
Redmineのコードハイライトは CodeRay という、Rubyで記述された高速なライブラリを使用しています。Coderayはc, cpp, css, delphi, groovy, html, java, javascript, json, php, python, rhtml, ruby, scheme, sql, xml, yamlに対応しています。
Wikiページでコードハイライトを利用するには次のように記述します:
<pre><code class="ruby">
Place your code here.
</code></pre>
表示例:
1
2 class Greeter
3 def initialize(name)
4 @name = name.capitalize
5 end
6
7 def salute
8 puts "Hello #{@name}!"
9 end
10 end