r-labs

h1. Redmine Wiki Extensions Plugin

{{>toc}}

English page is [[Wiki Extensions en|here]].

Redmineのwikiを拡張するプラグインです。

開発プロジェクトは{{project(Wiki Extensions)}}です。

h2. ダウンロード

h3. 正式公開版

http://code.google.com/p/redminewikiext/downloads/list

h3. 開発版

http://hudson.r-labs.org/hudson/job/Wiki%20Extensions%20Plugin/

h2. インストール

# プラグインをRedmineインストールフォルダの下の vendor/plugins に展開します。

# rake db:migrate_plugins RAILS_ENV=production を実行します。

# 「ロールと権限」で各ロールにWiki Extensionsの権限設定をします。

# プロジェクトの設定で WikiExtension モジュールをチェックします。

h2. サイトバー

[[SideBar]]という名前のページを作成すると、それをwikiのサイドバー上に読み込みます。

h2. 脚注

文中に{{fn(脚注, ページの下部に表示される注釈)}}を埋め込むための{{fn(マクロ, wikiの書式を拡張する機能)}}です。

h3. 書式

@{{fn(単語, 説明)}}@ のように書きます。例えば

<pre>

このサイトは{{fn(Redmine, 最強のプロジェクト管理ツール)}}です。

</pre>

と書くと、"このサイトは{{fn(Redmine, 最強のプロジェクト管理ツール)}}です。"となります。

脚注の一覧はページ下部に表示されます。

h2. コメント追加機能

wikiにコメントを書き込めるようにします。

h3. 書式

@{{comment_form}}@ と書くととコメント追加のためのフォームを表示します。 @{{comments}}@ と書くとそのページに書きこまれたコメントの一覧を表示します。

{{comments}}

{{comment_form}}

h2. 他のプロジェクトのwikiページにリンクを張る

{{new(2009-06-11)}}

他のプロジェクト上のwikiページへのリンクを埋め込むことができます。

h3. 書式

* @{{wiki(プロジェクト名, ページ名)}}@

* @{{wiki(プロジェクト識別子, ページ名)}}@

また、@{{wiki(プロジェクト名, ページ名, エイリアス)}}@ のようにエイリアスを指定することで表示する文字を変えることができます。

h2. 他のプロジェクトにリンクを張る

{{new(2009-06-11)}}

他のプロジェクトの概要ページへのリンクを埋め込むことができます。

h3. 書式

* @{{project(プロジェクト名)}}@

* @{{project(プロジェクト識別子)}}@

また、@{{project(プロジェクト名, エイリアス)}}@ のようにエイリアスを指定することで表示する文字を変えることができます。

例)

<pre>

Wiki Extensionsの開発プロジェクトは{{project(Wiki Extensions, ここ)}}です。

</pre>

と書くと以下のようになります。

Wiki Extensionsの開発プロジェクトは{{project(Wiki Extensions, ここ)}}です。

h2. 更新情報を表示する

{{new(2009-06-12)}}

h3. 書式

* @{{new(yyyy-mm-dd)}}@

* @{{new(yyyy-mm-dd, expire)}}@

指定した日からexpireで指定した日付が経過していなければ"new"という文字列を表示します。expireのデフォルトは5日です。

h2. タグを入力する

{{new(2009-06-23)}}

wikiの編集画面下部にタグ入力フィールドがあります。ここでページにタグを設定できます。タグは複数設定できます。

@{{tagcloud}}@ と入力するとタグクラウドを表示できます。[[SideBar]]に書いておくとよいでしょう。

h2. スタイルシートを編集する

{{new(2009-07-16)}}

[[SyleSheet]] というページを作成し、CSSの記述をしておくとそれをHTMLヘッダ部分に読み込みます。

このスタイルはWikiだけでなくすべてのページで読み込まれます。なのでプロジェクト毎にテーマを変えるようなことも可能です。

また、ページの一部分だけスタイルを変えたい場合もあると思います。以下のマクロを使って<div>タグを埋め込むことができます。

*@{{div_start_tag(id_name)}}@* と書くと、<div id="id_name">に変換されます。

*@{{div_start_tag(id_name, class_name)}}@* と書くと、<div id="id_name" class="class_name">に変換されます。

*@{{div_end_tag}}@* と書くと、</div>に変換されます。