1. crimson_21

    Posted

    crimson_21
Changes in title
+Dokuwikiサイトの構築
Changes in tags
Changes in body
Source | HTML | Preview
@@ -0,0 +1,180 @@
+# 前提条件
+
+個人的なナレッジの蓄積の為に何種類かのオープンソースのwikiを試してみたのですが、
+もっとも使いやすく感じられたDocuwikiを正式に使っていこうと思いました。
+
+そこで個人用・チーム用・一般公開用など複数用途で今後利用していくことを想定し、
+それぞれを別々に設定するのではなく、CMSのマルチサイトの機能を利用して
+バージョンアップの作業や、セキュリティパッチの適用、プラグインの追加を
+一括で済ませるられるようにしたいと思います。
+
+# Dokuwikiのインストール
+
+まずはDokuwiki本体のダウンロードし解凍。
+
+```bash:bash
+wget http://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+tar zxfvp ./dokuwiki-stable.tgz
+```
+
+解凍されたファイルは下記のフォルダに格納されます。
+dokuwiki-2013-12-08 
+ ※このフォルダ名は現行の安定板のリリース日を元にフォルダ名が作成されています。
+  今後のVersion-Up時にはおそらくこの部分のフォルダ名が変わりますのでご注意ください。
+
+解凍されたフォルダの中身をapacheのDocumentRootフォルダへ移動させます。
+
+```bash:bash
+mkdir /var/www/dokuwiki
+mv ~/dokuwiki-2013-12-08/* /var/www/dokuwiki
+chown -R apache.apache /var/www/dokuwiki
+```
+
+# ApacheのVirtualHostの設定
+
+apacheのVirtual Host/Alias の設定を行います。
+※私の環境ではdocuwiki全体で一つのNameベースのVirtualHostを設定したうえで、
+ 複数のWikiをAliasで設定することにしました。
+
+まずはVirtualHostの設定から
+
+```bash:httpd.conf
+ #NameVirtualHost *:80 ← コメントアウトをはずす
+ NameVirtualHost *:80
+```
+
+
+```bash:httpd.conf
+<VirtualHost *:80>
+ ServerAdmin webmaster@example.com
+ DocumentRoot /var/www/dokuwiki
+ ServerName dokuwiki.example.com/
+ ErrorLog logs/dokuwiki.example.com-error_log
+ CustomLog logs/dokuwiki.example.com-access_log common
+</VirtualHost>
+```
+
+httpd.confを変更したため、apacheを再起動します。
+
+```bash:bash
+/sbin/service httpd restart
+httpd を停止中: [ OK ]
+httpd を起動中: [ OK ]
+```
+
+# 確認作業
+
+この時点で一度http://dokuwiki.example.com/ にWEBアクセスしてみて状態を確認してみます。
+
+
+![DokuWiki インストーラー5.png](https://qiita-image-store.s3.amazonaws.com/0/13000/60b81cd5-632f-aeee-1aed-6c0114db7974.png)
+
+
+
+問題なくインストールが完了したことが確認できました。
+
+# エラーの確認
+
+さらにブラウザから該当のサイトの初期設定ページ(install.php)にWEBアクセスしたうえでGUIで詳細設定を行います。
+
+http://dokuwiki.example.com/install.php
+
+## エラー対応
+
+![DokuWiki インストーラーAlert.png](https://qiita-image-store.s3.amazonaws.com/0/13000/9c5464b0-92f4-3eda-3b1d-459306807981.png)
+
+ここで画面の右側に赤いAlertが表示されています。
+これは本来WEBからアクセスできてはいけないファイル類が外部に
+見える状態になってしまっている事が原因です。
+
+DokuWikiインストール時に各フォルダ内に自動的に設定される
+.htaccessファイルがApacheのサーバconfigで許可されていない問題を解消する必要があります。
+.htaccessを有効にするには、httpd.confに以下の行を追加してください。
+
+```httpd.conf
+<Directory /var/www/dokuwiki>
+ AllowOverride All
+</Directory>
+```
+
+## エラーの解消を確認
+
+再度、初期設定ページ(install.php)にWEBアクセスしエラーが解消されているかを確認します。
+先ほど表示されていた赤い四角のウィンドウが消えていれば問題ありません。
+
+http://dokuwiki.example.com/install.php
+
+![DokuWiki インストーラー3.png](https://qiita-image-store.s3.amazonaws.com/0/13000/b3d6b321-66f5-23fd-6591-779912862a9e.png)
+
+
+# サイト管理情報の設定
+
+本サイトを運用していくにあたっての必要事項を入力します。
+・wiki名
+・スーパーユーザー(管理者用ID)
+・フルネーム   (上記の管理者用IDでログインし書き込んだ際に表示される名前)
+・メールアドレス
+・パスワード
+・確認 (確認の為パスワードを再入力します)
+・ACL初期設定 
+
+> + オープンWiki(全ての人に、閲覧・書き込み・アップロードを許可)
+> + パブリックWiki(閲覧は全ての人が可能、書き込み・アップロードは登録ユーザのみ
+> + クローズドWiki(登録ユーザにのみ使用を許可)
+
+・本サイトのコンテンツが属するライセンスを選択
+
+> + CC0 1.0 Universal
+> + Public Domain
+> + CC Attribution 3.0 Unported
+> + CC Attribution-Share Alike 3.0 Unported
+> + GNU Free Documentation License 1.3
+> + CC Attribution-Noncommercial 3.0 Unported
+> + CC Attribution-Noncommercial-Share Alike 3.0 Unported
+> + ライセンス情報を表示しません。
+
+![DokuWiki インストーラー4.png](https://qiita-image-store.s3.amazonaws.com/0/13000/e1f4e219-356e-3a5c-719f-9b434c0b59e7.png)
+
+
+上記の項目をすべて埋めた上で、最下段の「確認」ボタンをクリックするとサイトが完成します。
+
+![DokuWiki インストーラー7.png](https://qiita-image-store.s3.amazonaws.com/0/13000/789fd9a9-4ee2-de09-737d-33f0feab2cd7.png)
+
+最後に初期設定用のinstall.phpファイルを削除します。
+
+```bash
+rm -rf /var/www/dokuwiki/install.php
+```
+
+上記のURLにアクセスし「404 Not Found Error」が出ることを確認します。
+
+以上でDokuWikiを利用する環境が整いました。
+
+# テンプレートの変更(おまけ)
+
+ただし、デフォルトのテンプレートではメニューバーがなく個人的には使いづらいため、
+テンプレートをデフォルトのものからarcticというものに変更します。
+
+```bash:bash
+wget http://r.notomorrow.de/dokuwiki-template-arctic/pkg/arctic-stable.tgz
+tar zxfvp arctic-stable.tgz
+mv ./arctic /var/www/dokuwiki/lib/tpl/
+chown -R apache.apache /var/www/dokuwiki
+```
+
+管理者でログインし、「管理」→「サイト設定」
+
+![DokuWiki インストーラー9.png](https://qiita-image-store.s3.amazonaws.com/0/13000/aa6816fd-3586-a6a7-a3cd-01480e38270f.png)
+
+「テンプレート」項目を選択し dokuwiki から article に変更します。
+
+![DokuWiki インストーラー10.png](https://qiita-image-store.s3.amazonaws.com/0/13000/03e98979-dc98-22d2-7e5a-b0b9e0584b80.png)
+
+
+これでDokuwikiのインストールおよびテンプレートの変更が完了しました
+
+
+![DokuWiki インストーラー11.png](https://qiita-image-store.s3.amazonaws.com/0/13000/1f8d444d-dc79-4fa4-ffd4-e933e21dea8f.png)
+
+
+以上。