◆ Hikiのインストールと設定 ◆ Hikiを動かすためには何はなくとも、まずRuby (バージョン1.8以降) が必要です。 [[Rubyホームページ|http://www.ruby-lang.org/ja/]]からダウンロードしてイン ストールしてください。 ○ 依存するライブラリのインストール Ruby のバージョンが 1.8.2 より前の環境で、trackback.rb または rss-show.rb を使う時には、以下のいずれかをインストールする必要がありま す。バージョン 1.8.2 以降では不要です。 * uconv http://www.yoshidam.net/Ruby_ja.html#uconv * rbuconv http://www.yoshidam.net/Ruby_ja.html#rbuconv ○ インストール例で前提とする環境 一般的なCGIの実行を許可しているISPやレンタルサーバ上で利用する場合を想定 し、以下のような環境を例に説明します。 * WWWサーバ: Apache HTTP server 2.0.x * ユーザ名: foo * HikiのURL: http://www.hoge.example.org/~foo/hiki/ * 上記URLのパス: /home/foo/public_html/hiki/ * データ格納用のパス: /home/foo/hiki/ ○ CGIスクリプトの設定 配布アーカイブを展開し、中身をすべて/home/foo/public_html/hiki/にコピーし ます。hiki.cgiがCGIスクリプト本体なので、WWWサーバの権限で実行可能なよう にパーミッションを設定してください。 また、/usr/bin/envを使った起動ができない環境では、各ファイルの先頭をRuby のパスに書き換える必要があるでしょう。 ○ .htaccessの作成 続いて、CGIの実行環境を整えます。dot.htaccess を .htaccess にリネー ムして、環境に合わせて書き換えます。添付のサンプルは以下のようになってい ます。 Options +ExecCGI AddHandler cgi-script .cgi DirectoryIndex hiki.cgi deny from all ここでは、 * CGIの実行を可能にし、 * サフィックス「.cgi」のファイルをCGIと認識させ、 * hiki.cgiをデフォルトのファイルに設定し、 * hikiconf.rbの参照を禁止 という設定になっています。 ○ データ格納用ディレクトリの作成 展開したディレクトリ中にdataというディレクトリがあります。このディレクト をどこかへコピーしてください。このディレクトリの場所は、WWW経由でアクセス できない (例えば public_html 以下でない) 場所が良いでしょう。 $ cp -r data /home/foo/hiki データ格納用のディレクトリ配下にある全てのファイルはWWWサーバの権限で書き 込めるパーミッションにしておく必要があります。 $ chmod -R og+w /home/foo/hiki/data ○ hikiconf.rbの作成 次に、hikiconf.rb.sample を hikiconf.rb にリネームして、内容を書き換 えます。これはRubyスクリプトとして、CGIに直接読み込まれます。 Hikiの主要な設定はCGI経由で行えるので、最低限書き換えるべきなのは最初に出 てくる @data_path だけです。 @data_path = '/home/foo/hiki/data' hikiconf.rb には、他にもいろいろな設定項目を記述できます。詳細について は、hikiconf.rb.sample 中のコメントを参照してください。 ◆ Hikiの実行 ◆ HikiをインストールしたURL (例ではhttp://www.hoge.example.org/~foo/hiki/) をブラウザで開いてみてください。FrontPageが表示されればインストールは成功 です。 /-【重要】---------------------------------------- | インストールが成功したら、すぐに「管理」画面で | 管理者用パスワードを設定してください。 `------------------------------------------------- ページの上部には以下のようなメニューが表示されているはずです。 新規作成 編集 差分 FrontPage ページ一覧 検索 更新履歴 管理 以下、これらのメニューについて説明します。 ○ 新規作成 「新規作成」のアンカをクリックすると「新規作成」画面へ遷移し新しくページ を追加することができます。 ○ 編集 「編集」のアンカをクリックすると参照しているページの内容を編集することが できます。 ○ 差分 「差分」のアンカをクリックすると参照しているページの最新版と、一つ前の版 との内容の差分を参照することができます。 ○ FrontPage 「FrontPage」のアンカをクリックするとHikiのトップページに遷移します。 ○ ページ一覧 「ページ一覧」のアンカをクリックすると作成された全てのページを一覧で表示 します。一覧画面では、各ページの最終更新日時、凍結されているか否かを参照 することができます。 ○ 検索 「検索」のアンカをクリックすると「検索」画面に遷移します。検索画面で検索 したいキーワードを入力し、「検索」ボタンを押下すると、全てのページ中から 入力したキーワードを含むページが一覧されます。 ○ 更新履歴 「更新履歴」のアンカをクリックすると作成された全てのページを更新日時が新 しい順に並び替えて一覧表示します。 ○ 管理 管理者用パスワードを設定した後、ユーザ名を 'admin' としてログインすると、 「管理」メニューが現れ、そこからプラグインの選択や各種の設定をすることが できます。また、個々のページの編集画面でページの凍結 (編集の禁止) や削除 を行えるようになります。 ◆ おわりに ◆ このドキュメントはtDiary配布パッケージのdoc/README.htmlを参考にさせていた だきました。tDiaryの作者、たださんに感謝します。