====== DokuWiki ======

このサイトで採用している wiki クローン．PHP で実装され，ページのソースがファイルとして格納されているシンプルな構成．

===== インストール =====
==== ダウンロード ====

[[https://www.dokuwiki.org/|DokuWiki 公式サイト]]から tar ball をダウンロードする．公式サイトでは，バージョン・言語・標準的なプラグインを選択すると，必要なモジュールをひとつのパッケージにまとめた tar ball を提供してくれる．ユーザは dokuwiki を配置するディレクトリにこれを展開するだけでよい．

==== インストーラの起動 ====

パッケージを展開したディレクトリをブラウザから参照するとエラーメッセージが表示される．
エラーメッセージにはインストーラを起動するためのリンクが含まれているので，
これをクリックしてインストーラを起動する．

インストーラを起動すると，まずは conf や data などいくつものディレクトリについて
アクセス権設定が不適切であるとのメッセージが表示される．
これは httpd がユーザ _www，グループ _www で dokuwiki にアクセスすることによる．
この問題を解決するには，conf と data およびその下にあるディレクトリのグループを _www に変更し，
いずれのディレクトリも group writable にする．

  * find conf -type d -exec chgrp _www {} ¥;
  * find data -type d -exec chgrp _www {} ¥;
  * find conf -type d -exec chmod 775 {} ¥;
  * find data -type d -exec chmod 775 {} ¥;

アクセス権が適切に設定されると，dokuwiki の設定ウィザード・ページが開く．
トップページの名前や言語など，必要な項目を好みに応じて適切に設定する．
ユーザの登録もインストーラから行う．

設定ウィザードで設定を保存するとインストーラの削除が促されるので，
攻撃を受けないよう install.php を削除する．
インストーラによる設定が完了すると，トップページへアクセスできるようになる．
後は管理インタフェースからプラグインの設定など，必要に応じて細かい調整を行う．

===== アップデート =====

DokuWiki では，新しいバージョンがリリースされていないか常に自動的にチェックをしている．
新しいバージョンが見つかると，パンくずリストの下にアップデートを促すメッセージが表示される．

==== バックアップ ====

<color red>更新の前にバックアップを必ずとっておくこと．tar ball に固めておけば十分</color>

==== ダウンロード ====

インストールと同様に[[https://www.dokuwiki.org/|DokuWiki 公式サイト]]から tar ball をダウンロードする．
これを適当なディレクトリに展開しておき，更新に備える．

==== 更新 ====

rsync を用いて更新を行う．ディレクトリ名の末尾にスラッシュ (/) を付けておくのを忘れないこと．これを忘れると current_version_dir の中に new_version_dir が作成されてしまう．

  * rsync -av new_version_dir/ current_version_dir/
  

==== 不要ファイルの削除 ====

バージョンアップで不要になったファイルを削除する．不要になったファイル名は data/deleted.files にまとめられているので，これを使って削除する．

  * grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf

==== アクセス権の調整 ====

rsync で上書きされたファイルは，rsync を実行したユーザのグループに属してしまう．conf ディレクトリおよび data ディレクトリについては，インストール時と同様に _www グループに変更する．

  * find conf -type d -exec chgrp _www {} ¥;
  * find data -type d -exec chgrp _www {} ¥;
  * find conf -type d -exec chmod 775 {} ¥;
  * find data -type d -exec chmod 775 {} ¥;

またすでに運用されてきた dokuwiki では _www の権限でさまざまなファイルが生成されている．これらについても _www グループに属するようパーミッションを調整しておく．

  * find conf -type f -exec chgrp _www {} ¥;
  * find data -type f -exec chgrp _www {} ¥;
  * find conf -type f -exec chmod 664 {} ¥;
  * find data -type f -exec chmod 664 {} ¥;



===== 設定 =====

|HTML の埋め込み|管理ページ > サイト設定 > 編集 > HTML埋め込み にチェックを入れる．Amazon Affiliate など iframe を html タグで囲むと，そのまま埋め込むことができる．|