DokuWikiのソースを表示

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

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

言い換えると、DokuWikiはPHPで書かれたウィキであり、何のデータベースを必要としません。

[http://www.dokuwiki.org/ 実行例を見てみたいですか？]

== 初期の注意事項 ==
DokuWikiは、PHP5.1.2以降をサポートする任意のWebサーバー上で動作するはずです。要件は時間とともに変化するため、追加の詳細については、DokuWikiの[http://www.dokuwiki.org/requirements requirements page]を参照してください。

あなたのWebサーバのために、[http://www.dokuwiki.org/security DokuWiki's security page]の適切なセクションを読むことを強くお勧めします。最も人気のあるWebサーバがカバーされていますが、一般的な指示もそこに記述してあります。

The package in [community] unpacks DokuWiki at {{ic|/usr/share/webapps/dokuwiki}} with the configuration files in {{ic|/etc/webapps/dokuwiki}} and the data files in {{ic|/var/lib/dokuwiki/data}}. It also changes the ownership of the relevant files to the "http" user. This should work fine for most popular web servers as packaged for Arch.

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

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

== 設定 ==
[[lighttpd]] または [[nginx]] を使用する場合は、{{ic|/etc/php/php.ini}} の {{ic|open_basedir}} に dokuwikiディレクトリを含めるように変更する必要があります。(php forbids following symbolic links outside of the allowed scope):

{{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 ===

The package should add the file {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} with the following contents:

{{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>
}}

If you are running [https://httpd.apache.org/docs/2.4/upgrading.html Apache 2.4 or newer], you will have to change the following lines:
{{bc|
    order allow,deny
    allow from all
}}
to read:
{{bc|
    Require all granted
}}

Include the newly created file in the Apache configuration by placing the following line at the end of {{ic|/etc/httpd/conf/httpd.conf}}:
{{bc|
Include conf/extra/dokuwiki.conf
}}

Make sure the folders {{ic|/etc/webapps/dokuwiki}} and {{ic|/var/lib/dokuwiki}} are owned by user and group "http". You may relocate these directories if you like as long as you update the references in {{ic|/etc/httpd/conf/extra/dokuwiki.conf}} respectively.

Afterwards restart Apache:
  # systemctl restart httpd.service

Then finish the installation by running the ''dokuwiki/install.php'' script in your browser.

=== lighttpd の設定 ===

Edit the {{ic|/etc/lighttpd/lighttpd.conf}} file as per the [http://www.dokuwiki.org/install:lighttpd dokuwiki instructions] (might contain updated information).

Make sure the modules {{ic|mod_access}} and {{ic|mod_alias}} are loaded. If not, load them by adding the following to {{ic|/etc/lighttpd/lighttpd.conf}}:
{{bc|1=
server.modules += ("mod_access")
server.modules += ("mod_alias")
}}
{{ic|mod_access}} provides the {{ic|url.access-deny}} command, which we are using from this point.

Under the line:
{{bc|1= 
$HTTP["url"] =~ "\.pdf$" {
  server.range-requests = "disable"
}
}}

add this: 
{{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>
}}

''These entries give some basic security to DokuWiki.'' lighttpd does not use .htaccess files like Apache. You CAN install with out this, but I would NEVER recommend it.


Add alias somewhere in lighttpd or fastcgi conf file:
{{bc|1=
alias.url += ("/dokuwiki" => "/usr/share/webapps/dokuwiki/")
}}

Restart lighttpd:
  # systemctl restart lighttpd

=== nginx ===

{{ic|/etc/nginx/nginx.conf}} に以下の location ブロックを追加します。

 #Assuming that the root is set to /usr/share/webapps.
 #You may need to adjust your location blocks accordingly.
 location ~^/dokuwiki/(data|conf|bin|inc)/ { deny all; } # secure DokuWiki
 location ~^/dokuwiki/\.ht { deny all; } # also secure the Apache .htaccess files
 location ~^/dokuwiki/lib/^((?!php).)*$ { expires 30d; } # no need to serve non .php files through fastcgi, so we catch those requests here.
 location ~^/dokuwiki/.*\.php$ {
             include fastcgi.conf;
             fastcgi_pass unix:/run/php-fpm/php-fpm.sock;
         }

nginx を再起動
  # systemctl restart nginx

== インストール後の作業 ==
=== 不要なファイルの削除 ===
'''After configuring the server remove the install.php file!'''
  # rm /srv/http/dokuwiki/install.php

=== プラグインのインストール ===
Many community created plugins can be found [http://www.dokuwiki.org/plugins here]

They can be added through the web interface (as well as updated) through the Admin menu. Some plugins cannot be downloaded, if they go over ssl (e.g. git). Uncomment following line in {{ic|/etc/php/php.ini}}:
{{bc|1= 
extension=openssl.so
}}

=== バックアップ ===
It is very trivial to backup DokuWiki, since there is no database. All pages are in plain text, and require only a simple tar, or rsync. 

A quick breakdown of the directories of interest in the current (2008-05-05) version:
  /dokuwiki/data/  =>  All User Created Data
  /dokuwiki/lib/plugins/  =>  All User Added Plugins

== 参考文献 ==

The [http://www.dokuwiki.org/ DokuWiki main site] has all of the information and help that you could possibly need.