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 (ファイルのダウンロードを強制)
- フォーラムのメッセージ:
- message#1218 (id 1218のメッセージへのリンク)
- プロジェクト:
- project#3 (id 3のプロジェクトへのリンク)
- project:someproject ("someproject"という名前のプロジェクトへのリンク)
エスケープ:
- テキストを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
サンプルのマクロです。
include
別のWikiページの内容を挿入します。 以下は使用例です:
{{include(Foo)}}
macro_list
上記のマクロを含め、利用可能なマクロの一覧を表示します。
コードハイライト
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 you 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