DokuWikiのソースを表示

[[Category:ウィキソフトウェア]]
[[en:DokuWiki]]
[[es:DokuWiki]]
[[zh-hant:DokuWiki]]
「[https://www.dokuwiki.org/dokuwiki DokuWiki] はユーザーがリッチなドキュメントリポジトリを作成することを可能にする、標準規格に準拠した使いやすいウィキです。DokuWiki は、ドキュメントを作成する個人、共同作業を行うチームや企業のための環境を提供し、シンプルで強力な構文を使用して、ウィキ外でも可読性のある構造化されたデータファイルの作成を可能とします。」

「ページは無制限に改訂して以前のバージョンのページにいつでも復元することができ、データはプレーンテキストファイルに格納されるので、データベースを必要としません。強力なプラグインアーキテクチャは、コアシステムの拡張・強化をすることができます。DokuWiki が提供する機能の完全な説明は、機能のセクションを参照してください。」 [http://wiki.splitbrain.org/wiki:dokuwiki]

すなわち、DokuWiki は PHP で書かれたウィキであり、何のデータベースも必要としません。

== はじめに ==
DokuWiki は、PHP 5.6 から 7.4.x までのバージョンをサポートする任意の Web サーバー上で動作するはずです。バージョンアップによって要件はときどき変わることがあるので、詳細な要件については、DokuWiki の [https://www.dokuwiki.org/start?id=ja:requirements システム要件のページ] を参照してください。

あなたの Web サーバーを守るために、[https://www.dokuwiki.org/start?id=ja:security DokuWiki のセキュリティのページ] の適切なセクションを読むことを強くお勧めします。最も人気のある Web サーバーがカバーされていますが、一般的な指示も記述してあります。

[community] にあるパッケージは DokuWiki を {{ic|/usr/share/webapps/dokuwiki}} に、設定ファイルを {{ic|/etc/webapps/dokuwiki}} に、データファイルを {{ic|/var/lib/dokuwiki/data}} に展開します。また、関連するファイルの所有者を "http" ユーザーに変更します。これで Arch 向けにパッケージ化された人気のウェブサーバーなら問題なく動作するはずです。

== インストール ==
# Web サーバー (例: [[Apache]]、[[nginx]] または [[lighttpd]]) を選んでインストールして、[[PHP]] を設定します。前述したように DokuWiki はデータベース・サーバーを必要としないので、Web サーバを設定するときにデータベースを設定するステップはスキップできます。
# [[pacman]] を使用して、[community] の {{Pkg|dokuwiki}} をインストールします。
# Web サーバーを設定します (以下のセクションを参照)。
# お好みの Web ブラウザで、<nowiki>http://&lt;your-server&gt;/dokuwiki/install.php</nowiki> を開いて、そこからインストールを続行してください。nginx の場合 URL は <nowiki>http://&lt;your-server&gt;/install.php</nowiki> です。

別の方法として、tarball からインストールしたい場合は、http://www.dokuwiki.org/Install を読んでください。大体の手順は上記と同様です。pacman を使用する代わりに、[http://www.splitbrain.org/projects/dokuwiki tarball をダウンロード] し、サーバーのドキュメントルート (例えば、{{ic|/srv/http/dokuwiki}}) に解凍し、適切なユーザー (例: "http") に、chown してください。

== 設定 ==
[[lighttpd]] や [[nginx]] を使用する場合、PHP のバージョンが 7 よりも古い場合、{{ic|/etc/php/php.ini}} の {{ic|open_basedir}} に dokuwiki のディレクトリを含めるように変更する必要があります (php では許可された範囲外にシンボリックリンクを使うことを禁止しています):

{{hc|/etc/php/php.ini|<nowiki>
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/dokuwiki/:/var/lib/dokuwiki/
</nowiki>}}

また、以下の行をアンコメントします:
{{hc|/etc/php/php.ini|<nowiki>
extension=gd.so
</nowiki>}}
Dokuwiki は画像のサイズ変更のために、このライブラリを必要とします。

=== Apache ===

パッケージは以下の内容のファイル {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} を追加します:

{{bc|
Alias /dokuwiki /usr/share/webapps/dokuwiki
<Directory /usr/share/webapps/dokuwiki/>
    Options +FollowSymLinks
    AllowOverride All
    order allow,deny
    allow from all
    php_admin_value open_basedir "/tmp/:/usr/share/pear/:/usr/share/webapps/:/etc/webapps/dokuwiki/:/var/lib/dokuwiki/"
</Directory>
}}

[https://httpd.apache.org/docs/2.4/upgrading.html Apache 2.4 以上] を使っている場合、以下の行を変更する必要があります:
{{bc|
    order allow,deny
    allow from all
}}
以下のようにしてください:
{{bc|
    Require all granted
}}

{{ic|/etc/httpd/conf/httpd.conf}} の末尾に以下の行を記述することで Apache の設定から新しく作成されたファイルを Include してください:
{{bc|
Include conf/extra/dokuwiki.conf
}}

{{ic|/etc/webapps/dokuwiki}} と {{ic|/var/lib/dokuwiki}} フォルダの所有者と所有グループが "http" になっていることを確認してください。ディレクトリは自由に場所を変更できますが、その際は {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} の設定も更新してください。

その後 Apache を再起動します:
 # systemctl restart httpd.service

ブラウザで ''dokuwiki/install.php'' スクリプトを開いてインストールを完了してください。

=== lighttpd ===

[http://www.dokuwiki.org/install:lighttpd dokuwiki の手順] (情報が更新されている可能性があります) に従って {{ic|/etc/lighttpd/lighttpd.conf}} ファイルを編集してください。

{{ic|mod_access}} と {{ic|mod_alias}} モジュールがロードされていることを確認してください。モジュールがロードされていない場合、{{ic|/etc/lighttpd/lighttpd.conf}} に以下を追加することでロードします:
{{bc|1=
server.modules += ("mod_access")
server.modules += ("mod_alias")
}}
{{ic|mod_access}} の {{ic|url.access-deny}} コマンドを使います。

以下の行の下に:
{{bc|1= 
$HTTP["url"] =~ "\.pdf$" {
  server.range-requests = "disable"
}
}}

以下を追加:
{{bc|1=
# subdir of dokuwiki
# comprised of the subdir of the root dir where dokuwiki is installed
# in this case the root dir is the basedir plus /htdocs/
# Note: be careful with trailing slashes when uniting strings.
# all content on this example server is served from htdocs/ up.
#var.dokudir = var.basedir + "/dokuwiki"
var.dokudir = server.document-root + "/dokuwiki"

# make sure those are always served through fastcgi and never as static files
# deny access completly to these<nowiki>
$HTTP["url"] =~ "/(\.|_)ht" { url.access-deny = ( "" ) }
$HTTP["url"] =~ "^" + var.dokudir + "/(bin|data|inc|conf)/"  { url.access-deny = ( "" ) }</nowiki>
}}

''上記のエントリは DokuWiki に基本的なセキュリティを追加します''。lighttpd は Apache のように .htaccess ファイルは使いません。上記の設定は必須ではありません。

lighttpd や fastcgi の設定ファイルのどこかにエイリアスを追加します:
{{bc|1=
alias.url += ("/dokuwiki" => "/usr/share/webapps/dokuwiki/")
}}

lighttpd を再起動:
 # systemctl restart lighttpd

=== nginx ===

{{Pkg|php-fpm}} をインストールして[[起動]]してください。

以下の server ブロックを追加してください。ただしサーバーの名前は適当な名前に置き換えてください。DokuWiki のインストールが完了したら install.php のブロックはコメントアウトしてください。以下のブロックは TLS を使用します [https://www.dokuwiki.org/install:nginx]:
{{hc|/etc/nginx/nginx.conf|<nowiki>
    server {
        listen 443 ssl http2;
        listen [::]:443 ssl http2;
        server_name wiki.example.com;
         
        root /usr/share/webapps/dokuwiki;
        index doku.php;

        #Remember to comment the below out when you're installing DokuWiki, and uncomment it when you're done.
        location ~ /(data/|conf/|bin/|inc/|install.php) { deny all; } # secure Dokuwiki

        location ~^/\.ht { deny all; } # also secure the Apache .htaccess files
        location @dokuwiki {
            #rewrites "doku.php/" out of the URLs if you set the userewrite setting to .htaccess in dokuwiki config page
            rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
            rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
            rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
            rewrite ^/(.*) /doku.php?id=$1&$args last;
        }

        location / { try_files $uri $uri/ @dokuwiki; }
        location ~ \.php$ {
            try_files $uri =404;
            fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
            fastcgi_index index.php;
            include fastcgi.conf;
        }

    }
</nowiki>}}

nginx を再起動:
 # systemctl restart nginx

=== SVG ファイルのアップロードと表示を有効化 ===
DokuWiki は SVG ファイルに対応していますがデフォルトでは無効になっています。

有効にしたい場合、以下のファイルを作成してください:

{{hc|/etc/webapps/dokuwiki/mime.local.conf|
svg image/svg+xml
}}

上記の設定はセキュリティ上問題があります。[https://github.com/splitbrain/dokuwiki/issues/1045#issuecomment-90226230 こちら] を参照。

== インストール後の作業 ==
=== 不要なファイルの削除 ===
'''サーバーを設定した後は install.php ファイルを削除してください！''':
 # rm /usr/share/webapps/dokuwiki/install.php

=== プラグインのインストール ===
[http://www.dokuwiki.org/plugins こちら] にコミュニティによって作成されたプラグインが多数記載されています。

ウェブインターフェイスを使って管理者メニューからプラグインを追加 (更新) できます。プラグインによっては ssl を通すとダウンロードできないことがあります (例: git)。

=== バックアップ ===
データベースが存在しないため DokuWiki のバックアップはとても簡単です。全てのページはプレーンテキストで保存されているため、[[tar]] や [[rsync]] などでバックアップできます。

最新バージョン (2015-08-10a) で使われているディレクトリの簡単な解説:
 /usr/share/webapps/dokuwiki/data/  =>  ユーザーが作成した全てのデータ
 /usr/share/webapps/dokuwiki/conf/  =>  設定

将来的に上記のディレクトリは変わる可能性があります。[https://www.dokuwiki.org/faq:backup DokuWiki Backup FAQ] を参照してください。

== 参考文献 ==

[http://www.dokuwiki.org/ DokuWiki のメインサイト] にはあなたが必要としている全ての情報が記載されています。