DokuWiki

文書の過去の版を開いています。もしこのまま保存すると、この文書が最新となります。

====== DokuWiki の設定 ======

[[:ja:dokuwiki|DokuWiki]] のほとんどの機能は、様々な設定オプションを通じて設定することができます。これらの設定オプションを変更するもっとも簡単な方法は、[[:ja:plugin:config|サイト設定用プラグイン]]を利用することです。

===== DokuWiki で設定できること =====

DokuWiki のシステム全体の設定項目は、''conf/dokuwiki.php'' ファイルに格納されています。しかし、このファイルはシステムの「デフォルト値」を設定するためのものです。実際に設定項目を変更するには ''conf/local.php'' ファイルを編集すべきです (もしこのファイルが無い場合は作成してください)。このファイルの中で設定できる設定項目については、このページの下部にある[[#利用可能なオプション]]のリストをご覧ください。

ユーザ名および (暗号化された) パスワード、アクセス制御ルールについては [[:ja:acl|users.auth.php と acl.auth.php]] ファイルに保存されています。

メディアマネージャーから新しいファイルをアップロードする際に「アップロードは拒否されました。この拡張子は許可されていません。」というメッセージを目にするかもしれません。この振る舞いは ''conf/mime.conf'' ファイルで制御されています。新しい種類のファイルをアップロードするには [[:ja:mime|mime.conf]] ファイルの中で定義してください。

ページが編集された際はその内容に対していくつかの自動的な変換が行われます。略語を説明するためのヒントの生成や、スマイリーや特殊文字への変換などです。これらの振る舞いは、それぞれ [[:ja:abbreviations|acronyms.conf]]、[[:ja:smileys|smileys.conf]]、[[:ja:entities|entities.conf]] ファイルで制御されます。

===== 設定ファイルのまとめ =====

すべての設定ファイルは ''./conf'' ディレクトリの中にあります。

「メインファイル」は DokuWiki に同梱されていますが、「ローカルファイル」は Wiki の管理者が作成する必要があります。

もしローカルファイルがサポートされている場合は、バージョンアップ時のトラブルを避けるため、メインファイルではなくローカルファイルを編集するようにしてください。

^ メインファイル     ^ ローカルファイル         ^ 設定の種類                          ^ 概要                                      ^
| ''dokuwiki.php''   | ''local.php''\\ ''local.protected.php''| [[#設定オプション]]   | 一般的な Wiki の設定                      |
| ''acronyms.conf''  | ''acronyms.local.conf''  | [[:ja:abbreviations|略語]]          | 自動付加される略語のヒントの設定          |
| ''entities.conf''  | ''entities.local.conf''  | [[:ja:entities|文字実体]]           | 自動変換される文字列の設定                |
| ''interwiki.conf'' | ''interwiki.local.conf'' | [[:ja:interwiki|InterWiki]]         | InterWiki リンク (Wiki 間リンク) の設定   |
| ''mime.conf''      | ''mime.local.conf''      | [[:ja:mime|MIME]]                   | アップロード用の MIME タイプの設定        |
| ''smileys.conf''   | ''smileys.local.conf''   | [[:ja:smileys|スマイリー]]          | スマイリー画像の設定                      |
| ---                | ''acl.auth.php''         | [[:ja:acl|アクセス制御]]を参照      | アクセス制御リストの設定                  |
| ---                | ''users.auth.php''       | [[:ja:acl|アクセス制御]]を参照      | ユーザとパスワードの設定                  |
| ''license.php''    | ''license.local.php''    | [[:ja:config:license]]              | 利用可能なライセンスの設定                |
| ''scheme.conf''    | ''scheme.local.conf''    | [[:urlschemes]] （未訳）            | リンクとして認識される URL スキームの設定 |
| ''mediameta.php''  | ---                      | [[:ja:exif|EXIF]]                   | 画像の編集できるメタデータの設定          |
| ''wordblock.conf'' | ''wordblock.local.conf'' | [[:ja:blacklist|ブラックリスト]]    | スパム用ブラックリストの設定              |
|''plugins.required.php'' |''plugins.local.php''\\ ''plugins.protected.php'' |下記を参照  | プラグインの動作状態の設定（有効・無効） |
| ---                | ''userscript.js''        | [[:ja:devel:javascript|Javascript]] | 追加で読み込む Javascript の設定          |
| ---                | ''userstyle.css''        | [[:ja:devel:css|スタイルシート]]    | 追加で読み込むスタイルシートの設定        |

===== プラグインの有効・無効 =====

インストール済みのプラグインはデフォルトで有効化されます。
[[ja:plugin:extension|拡張機能管理]]や[[ja:plugin:plugin|プラグイン管理]]を使って ''plugins.local.php'' ファイルに記録することで無効化できます。
''conf/plugins.protected.php'' に記載することで特定のプラグインを保護することもできます。

DokuWikiは、デフォルトで次の順序で設定ファイルを読み込みます：

- ''conf/plugins.php'' -- デフォルトのプラグイン設定
  - ''conf/plugins.local.php'' -- プラグイン管理で変更
  - ''conf/plugins.required.php'' -- この同梱プラグインは、プラグイン管理での制御不可
  - ''conf/plugins.protected.php'' -- 他のファイルの設定よりも優先

設定ファイルの読込み順は、''$config_cascade'' グローバル変数によって制御されています。
[[ja:devel:preload|プリロード]]ファイルを使用して、この動作は変更可能です。
===== 設定オプション =====

[[:ja:dokuwiki|DokuWiki]] のほとんどの機能は様々な設定オプションを通じて設定することができます。これらの設定オプションを変更するもっとも簡単な方法は、[[:ja:plugin:config|サイト設定用プラグイン]]を利用することです。

利用可能な設定オプションは、次のセクションで示します。設定オプションのデフォルト値は ''conf/dokuwiki.php'' ファイルに格納されています。もし設定を変更する場合はこのファイルを直接編集するのではなく、''conf/local.php'' ファイルを編集するべきです。''conf/local.php'' ファイルのみを編集するようにしておけば、後で DokuWiki のバージョンアップを行った場合でもあなた独自の設定が上書きされる心配はありません。なお、サイト設定用プラグインも ''conf/local.php'' ファイルを編集する仕組みとなっています。

以下に ''conf/local.php'' ファイルのサンプルを示します。

設定ファイルについて、いくつかの注意を以下に示します。設定ファイルは PHP スクリプトとして取り扱われますので、PHP の文法を守らなければなりません。例えば、行末にはセミコロン (;) を付けるなどです。設定項目には数種類の型があります。型について、以下に説明します。

* **数値**は、値として数字を取ります。例: ''42''
  * **文字列**は、シングルクォート (''%%'%%'') もしくはダブルクォート (''%%"%%'') で囲まなければなりません。例: ''%%'ほげ ふが'%%''
  * **真偽値**は、値に ''1'' もしくは ''0'' を取ります (設定の都合上 ''true'' と ''false'' は使用しないでください)。
  * **配列**は、上記の型の値を複数個含みます。

==== 利用可能なオプション ====

* **基本設定**
    * [[:ja:config:title]]
    * [[:ja:config:startpage|start]]
    * [[:ja:config:lang]]
    * [[:ja:config:template]]
    * [[:ja:config:tagline]]
    * [[:ja:config:sidebar]]
    * [[:ja:config:license]]
    * [[:ja:config:savedir]]
    * [[:ja:config:basedir]]
    * [[:ja:config:baseurl]]
    * [[:ja:config:dmode]]
    * [[:ja:config:fmode]]
    * [[:ja:config:allowdebug]]
  * **表示設定**
    * [[:ja:config:recent]]
    * [[:ja:config:recent_days]]
    * [[:ja:config:breadcrumbs]]
    * [[:ja:config:youarehere]]
    * [[:ja:config:fullpath]]
    * [[:ja:config:typography]]
    * [[:ja:config:dformat]]
    * [[:ja:config:signature]]
    * [[:ja:config:showuseras]]
    * [[:ja:config:toptoclevel]]
    * [[:ja:config:tocminheads]]
    * [[:ja:config:maxtoclevel]]
    * [[:ja:config:maxseclevel]]
    * [[:ja:config:camelcase]]
    * [[:ja:config:deaccent]]
    * [[:ja:config:useheading]]
    * [[:ja:config:sneaky_index]]
    * [[:ja:config:hidepages]]
  * **認証設定**
    * [[:ja:config:useacl]]
    * [[:ja:config:autopasswd]]
    * [[:ja:config:authtype]]
    * [[:ja:config:passcrypt]]
    * [[:ja:config:defaultgroup]]
    * [[:ja:config:superuser]]
    * [[:ja:config:manager]]
    * [[:ja:config:profileconfirm]]
    * [[:ja:config:rememberme]]
    * [[:ja:config:disableactions]]
    * [[:ja:config:auth_security_timeout]]
    * [[:ja:config:securecookie]]
    * [[:ja:config:remote]]
    * [[:ja:config:remoteuser]]
  * **スパム対策設定**
    * [[:ja:config:usewordblock]]
    * [[:ja:config:relnofollow]]
    * [[:ja:config:indexdelay]]
    * [[:ja:config:mailguard]]
    * [[:ja:config:iexssprotect]]
  * **編集設定**
    * [[:ja:config:usedraft]]
    * [[:ja:config:htmlok]]
    * [[:ja:config:phpok]]
    * [[:ja:config:locktime]]
    * [[:ja:config:cachetime]]
  * **リンク設定**
    * [[:ja:config:target|target (wiki, interwiki, extern, media, windows)]]
  * **メディア設定**
    * [[:config:mediarevisions]] （未訳）
    * [[:ja:config:gdlib]]
    * [[:ja:config:im_convert]]
    * [[:ja:config:jpg_quality]]
    * [[:ja:config:fetchsize]]
    * [[:ja:config:refcheck]]
    * [[:ja:config:refshow]]
  * **通知設定**
    * [[:ja:config:subscribers]]
    * [[:config:subscribe_time]]（未訳）
    * [[:ja:config:notify]]
    * [[:ja:config:registernotify]]
    * [[:ja:config:mailfrom]]
    * [[:config:mailprefix]]（未訳）
    * [[:config:htmlmail]]（未訳）
  * **RSSフィード設定**
    * [[:ja:config:sitemap]]
    * [[:ja:config:rss_type]]
    * [[:ja:config:rss_linkto]]
    * [[:ja:config:rss_content]]
    * [[:config:rss_media]] （未訳）
    * [[:ja:config:rss_update]]
    * [[:ja:config:rss_show_summary]]
  * **高度な設定**
    * [[:ja:config:updatecheck]]
    * [[:ja:config:userewrite]]
    * [[:ja:config:useslash]]
    * [[:ja:config:sepchar]]
    * [[:ja:config:canonical]]
    * [[:ja:config:fnencode]]
    * [[:ja:config:autoplural]]
    * [[:ja:config:compress]]
    * [[:ja:config:cssdatauri]]
    * [[:ja:config:gzip_output]]
    * [[:ja:config:send404]]
    * [[:ja:config:compression]]
    * [[:ja:config:broken_iua]]
    * [[:ja:config:xsendfile]]
    * [[:ja:config:renderer_xhtml]]
    * [[:ja:config:readdircache]]
  * **ネットワーク設定**
    * [[:ja:config:proxy|proxy (host, port, user, pass, ssl)]]
    * [[:ja:config:safemodehack]]
    * [[:ja:config:ftp|ftp (host, port, user, pass, root)]]

人間の証明として、ボックス内の全ての文字を入力してください。 Y᠎ Z B᠎ F Y この項目は空のままにして下さい：

編集の概要

注意：本ページを編集した場合、あなたの編集した内容が次のライセンスに従うことに同意したものとみなします： CC Attribution-Share Alike 4.0 International