====== 設定オプション ====== [[DokuWiki]]の特徴のほとんどは、様々な設定オプションを通して変更することができます。これらのオプション変更の簡単な方法は、[[doku>plugin:config|設定マネージャー]]を使うことです。 このページは、有効な設定や可能な値を説明しています。すべてのデフォルトの値は、''conf/dokuwiki.php''というファイルに格納されています。もし、設定を変更したい場合は、''conf/local.php''というファイルを編集してください。このファイルは、後のアップグレードでも上書きされずに設定が保持されます。設定マネージャーもこのファイルを使用します。 ''conf/local.php''のサンプルです： 設定ファイルにいくつかの注意があります。ファイルは、PHPコードの一部です。そのため、PHP文法で保持されます。それぞれの行は、セミコロンで終わっていなければなりません。変数には以下に示すとおりいくつかの型があります。 * **数値**は、数字でそのままを記述します。例: ''9'' * **文字列**はシングルクォートかダブルクォートで括られている必要があります。例: ''%%'foo bar'%%'' * **ブール値**は、''true''か''false''、または''1''か''0''のどちらかです。 * **配列**は、上記の型のいくつかが複合的に含まれます。 ^ :!: これはマニュアルページです :!: ^ | このページの記載を変更してもWikiの設定オプションには反映されません。マニュアルの改善のためにだけ編集してください。 | ====== 基本設定 ====== ==== WIKIタイトル : title ==== インストールしたWikiの名前を指定します。お好きなタイトルを指定してください。同じサーバに複数の[[DokuWiki]]をインストールする場合に、それぞれに異なるタイトルを付けることができます。 * 型: 文字列　Unicode * デフォルト値: ''DokuWiki'' ==== スタートページ名 : start ==== 各[[wiki:ja:namespace|名前空間]]（ルート名前空間を含む）のデフォルトページの名前を指定します。ページ名が指定されない場合にここで指定した名前のページ（ホームページ）が読み込まれます。 * 型: 文字列 * デフォルト値: ''start'' ==== 使用言語 : lang ==== このオプションは、インタフェースで使用する言語を指定します。詳細は[[multilanguage|Multilanguage Support]]を参照してください。 * 型: 文字列 * デフォルト値: ''en'' ==== テンプレート : template ==== インストールした[[wiki:ja:dokuwiki|DokuWiki]]で使用するテンプレートの名前を指定します。詳細は[[wiki:ja:tpl:templates|Templates]]を参照してください。 * 型: 文字列 * デフォルト値: ''default'' ==== 保存ディレクトリ : savedir ==== ファイルの保存先のパスを指定します。次の「ベースディレクトリ」で指定するディレクトリからのファイルシステム上の相対パスを指定します。このディレクトリは、Webサーバから書き込み可能でなければなりません。 * 型: 文字列 * デフォルト値: ''./data'' このディレクトリ配下には複数のサブディレクトリとchangelogが存在します。以下に示す設定ファイルのパラメータを設定することで、サブディレクトリやchangelogの配置を変更することができます。 ^ パラメータ ^ savedir配下のデフォルト配置 ^ | datadir | pages | | olddir | attic | | mediadir | media | | cachedir | cache | | lockdir | locks | | changelog | changes.log | | metadir | meta | ==== ベースディレクトリ : basedir ==== 通常、DokuWikiはインストール先のディレクトリを自動検出します。しかし、さまざまな理由で自動検出がうまくいかない場合があります。Webページの画像を見つけられないなど、DokuWikiが正常に機能しない場合ここでディレクトリを指定してみてください。 ここで指定するパスは、サーバのドキュメントルートからDokuWikiのインストールディレクトリまでの絶対パスです。たとえば、WikiのURLが''%%http://www.yourserver.com/dokuwiki/%%''である場合は、「ベースディレクトリ」に''/dokuwiki/''を指定します。先頭と末尾のスラッシュを忘れないように注意してください。 * 型: 文字列 * デフォルト値: '''' ==== ベースURL : baseurl ==== プロトコル部を含むサーバのURLを指定します（指定しない場合は自動検出）。 ここで指定するパスは、サーバのドキュメントルートです。WikiのURLが''%%http://www.yourserver.com:port/dokuwiki/%%''である場合は、「ベースURL」には''%%http://www.yourserver.com:port%%''を指定します（末尾のスラッシュは付けない）。 * 型: 文字列 * デフォルト値: '''' //注意: ':port'の部分はWebサーバが標準ポート以外（ポート番号80以外）で動作している場合にポート番号を指定します。標準ポートで動作しているWebサーバの場合は、この部分は省略可能です。// ==== フォルダ作成マスク : dmode ==== このオプションはディレクトリが作成されるときのパーミッションを設定します。このオプションには、ディレクトリに設定するモードの8進数（文字列ではなく0で始まる数値）で指定します。デフォルトでは、UNIXの''0755''（''rwxr-xr-x''）のパーミッションでディレクトリが作成されます（パーミッションの数値については次の「ファイル作成マスク」の説明を参照）。 * 型: 数値 * デフォルト値: ''0755'' この設定は、Windowsサーバーには影響しません。設定に当たっては[[wiki:ja:install:permissions|Setting up file permissions]]および[[wiki:ja:security|セキュリティ]]のページをよく読んでください。 ==== ファイル作成マスク : fmode ==== このオプションは、作成したいファイルのパーミッションを指定します。ここで設定する値は、8進法で指定します(数値は常に0から始まります)。デフォルトは、UNIXの''0644''(''rw-r--r--'')のパーミッションでファイルが作成されます。 * 型: 数値 * デフォルト値: ''0644'' この設定は、Windowsサーバーには影響しません。設定に当たっては[[wiki:ja:install:permissions|Setting up file permissions]]および[[wiki:ja:security|セキュリティ]]のページをよく読んでください。 最初のゼロではない数値(上記のデフォルトは6)は、//ユーザー//（ファイルの所有者）のパーミッションを決定します。2つ目の数値は//グループ//のパーミッションで、最後の数値は、//その他//(つまり他の全部)のパーミッションです。パーミッションを適切な数値に変換するには、次のキーを使います。 * 読込(Read)=4 * 書込(Write)=2 * 実行(Execute)=1 そして、各グループについて上記の数値を合計します。たとえば、ファイルを所有するユーザーに読み書きのパーミッションを与えるには、ゼロの後の最初の数字に4+2=6を指定します。また、ファイルが所属するグループに読み込みと実行のパーミッションを与えるには、ゼロの後の2番目の数字に4+1=5を指定します。したがって、デフォルトのパーミッション値は、''user''に読み込みおよび書き込みパーミッション、''group''と''others''に読み込み専用パーミッションを与えるものと解釈されます。 ==== デバッグモード : allowdebug ==== サポートの対応をスムーズにするために、DokuWikiにはリクエストに対する詳細なデバッグ文字列を出力する機能を持っています。デバッグ出力を得るには、次の例のようにURLに''"/?do=debug"''（文字"を除く）を付加します。 http://hostname.domain/your-dokuwiki/doku.php?id=playground&do=debug この機能は、Wikiの最初にセットアップで発生するさまざまな設定の問題を解決するのに非常に役立ちます。しかし、同時にDokuWikiが稼働しているサーバに関する情報の漏洩にもつながります。 :!: セキュリティ確保のため、適切にWikiをセットアップし終えたらこのオプションをオフにしてデバッグ機能を無効にしてください。 * 型: ブール値 * デフォルト値: ''0'' ===== 表示設定 ===== ==== 最近の変更表示数 : recent ==== [[:wiki:ja:recent_changes|最近の更新]]で1ページあたりに表示するドキュメントの数を指定します。ここで指定した値は、最近の変更のXML [[wiki:ja:syndication|XML Syndication]]に出力されるアイテムのデフォルト値、XML [[wiki:ja:syndication|XML Syndication]]のドキュメントリストに出力されるアイテム数としても使われます。 * 型: 数値 * デフォルト値: ''20'' ==== トレース(パンくず)表示数 : breadcrumbs ==== [[breadcrumbs|Breadcrumbs]]トレースに表示される閲覧履歴の数を指定します。0を指定すると閲覧履歴の表示が無効になります。 * 型: 数値 * デフォルト値: ''10'' ==== 現在位置を表示 : youarehere ==== 上記の「トレース」とは異なり、名前空間の階層を示すパンくずリストを表示します。この機能を使う場合、上記の標準のパンくずリストは無効にしてもよいでしょう。 * 型: ブール値 * デフォルト値: ''0'' ==== ページのフッターに絶対パスを表示 : fullpath ==== このオプションをオンにすると、表示されているドキュメントのファイルシステム上のフルパスが表示されます。 * 型: ブール値 * デフォルト値: 0 ==== タイポグラフィー変換 : typography ==== 特定の文字の組み合わせを対応する正しい活字に置き換えます。 * 型: ブール値 * デフォルト値: ''1'' ==== 日付フォーマット : dformat ==== 日付のフォーマットを指定します。ここで設定した値は、PHPの[[phpfn>date]]関数にそのまま渡されます。たとえば、''%d.%m.%Y %H:%i''のように設定してもよいでしょう。 * 型: 文字列 * デフォルト値: ''%Y/%m/%d %H:%M'' ==== 署名 : signature ==== ログインユーザーの署名がどのように表示されるかを設定します。[[phpfn>strftime]]関数で定義されているすべての変数と以下に示す特殊変数を使用できます。 ^ 変数 ^ 変換結果 ^ | @USER@ | ユーザーのログイン名 | | @NAME@ | ユーザーの氏名 | | @MAIL@ | ユーザーのe-mailアドレス | | @DATE@ | [[config#日付フォーマット : dformat|dform]]オプションの指定によってフォーマットされた現在の日付 | * 型: 文字列 * デフォルト値: ''%% --- //[[@MAIL@|@NAME@]] @DATE@//%%'' もう少し短い形式にしたい場合は、''%% --- //[[@MAIL@|@USER@]] %b%e//%%''のように設定するとよいでしょう。また、ユーザーのページを用意したい場合は、''%% --- //[[user:@USER@|@NAME@]] @DATE@//%%''のように設定します。 ==== 目次トップレベル見出し : toptoclevel ==== 自動生成される目次のトップレベルとなる見出しレベルを指定します。 * 型: 数値 (1-5) * デフォルト: ''1'' ==== 目次 表示限度見出し : maxtoclevel ==== 自動生成される目次の最下位となる見出しレベル（最大値）を指定します。 * 型: 数値 (0-5) * デフォルト値: ''3'' 0を指定すると目次の生成が無効になります。 ==== 編集可能見出し : maxseclevel ==== 個別に編集可能なセクションとして扱う最下位の見出しレベル（最大値）を指定します。 * 型: 数値 (0-5) * デフォルト値: ''3'' 0を指定するとページ内に表示されるEditボタンが無効になります。 ==== キャメルケースリンク : camelcase ==== [[wp>CamelCase|キャメルケース（ラクダ記法）]]リンクを有効にするかどうかを指定します。キャメルケースリンクはWikiでリンクを作成する方法として一般的ですが、その善し悪しについては議論の分かれるところです。このオプションをいったん有効にした後、再度無効にすると[[wiki>OrphanPage|孤立ページ]]ができてしまうことがありますので注意してください。 * 型: ブール値 * デフォルト値: ''0'' ==== ページ名アクセント : deaccent ==== このオプションを''1''に設定すると、ページ名に含まれるアクセント記号付きの文字を、対応する同等のアクセント記号のつかないASCII文字に置き換えられます。たとえば、''''は''ue''に、''''は''a''に置き換えられます。''2''を設定するとページ名の[[romanization|Romanization]]が有効になり、非ラテンアルファベットのシンボルを近似のASCII文字に置き換えられます。''0''を設定すると両方の機能が無効になります。 * 型: 数値 (''0''-''2'') * デフォルト値: ''1'' ==== 最初の見出しをページ名とする : useheading ==== このオプションを有効にすると、Wikiページ名へのリンクに関する以下のものについて、ページ内で最初に現れる見出しを使うようになります。 * ブラウザや検索エンジンの結果に表示されるページのタイトル * ページへのリンクテキスト（リンク指定で明示的にタイトルが含まれている場合を除く） * ページのRSSフィードエントリに使われるタイトル 詳細については、[[wiki:ja:useheading|Using the first heading as the page name]]を参照してください。 * 型: ブール値 * デフォルト値: ''0'' ==== メディア参照元チェック : refcheck ==== メディアファイルを削除する際に被参照をチェックするかどうかを指定します。 * 型: ブール値 * デフォルト値: ''1'' ==== メディア参照元表示数 : refshow ==== 参照元をいくつ表示するかを指定します（5を設定するのが適切でしょう）。 * 型: ブール値 * デフォルト値: ''5'' ===== 認証設定 ======== ==== アクセス管理を行う(ACL) : useacl ==== このオプションをオンにすると[[wiki:ja:acl|アクセスコントロール]]を利用してユーザごとにWikiに対する操作を制限することができます。 * 型: ブール値 * デフォルト値: ''0'' ==== パスワードの自動生成(ACL) : autopasswd ==== DokuWikiは、新規ユーザーが登録された後にパスワードを処理する2種類の方法をサポートしています。この設定オプション変数は、パスワード処理にどちらの方法を使うかを指定します。 - 自動生成パスワード(''1'')\\ ユーザーは自分のemailアドレスのみを指定し、DokuWikiが自動生成したパスワードをユーザーに送信します。この方法を使うには、''autopasswd''を''1''に設定してください（DokuWikiがすべてのメールを送信するときに使う"From" アドレスは、[[wiki:ja:config#メール送信時の送信元アドレス : mailfrom|mailfrom]]オプションにより設定できます）。 - ユーザ指定のパスワード(''0'')\\ 登録フォームに2つのフィールドが提示され、ユーザーが好きなパスワードを入力できます。この方法を使うには、''autopasswd''を''0''に設定してください。 * 型: ブール値 * デフォルト値: ''1'' ==== 認証方法(ACL) : authtype ==== 認証の際に使用するバックエンド機構を指定します。 DokuWikiはいくつかの認証バックエンド機構をサポートしています。詳細については、[[wiki:ja:auth:backends|Authentication Methods]]を参照してください。 * 型: 文字列 * デフォルト値: ''plain'' ==== 暗号化方法(ACL) : passcrypt ==== パスワードは暗号化したハッシュとして保存する必要があります。DokuWikiは複数のハッシュ方式をサポートしており、このオプションではそのうちどの方式を使うかを指定します。どの方式を選択したらよいかは、管理者が要求するセキュリティレベルや既存の認証データベースを利用するかどうかによって異なります。DokuWikiは使用された暗号化パスワードからどの方法が使われているのか判断することができるので、バックエンド機構がサポートしている方式であればいつでも暗号化方式を変更できます。 saltによるハッシュ化を利用する場合は、ユーザーが最初にパスワードを割り当てられたとき、およびパスワードを変更したときにランダムsaltが生成されます。saltはパスワード内に格納されます。DokuWikiがsaltを適用できるかどうかは、使用する[[wiki:ja:auth:backends|認証バックエンド機構]]に依存します。 利用できる方式は下の表のとおりです。 ^ オプション ^ 説明 ^ | smd5 | salt付きMD5ハッシュ | | md5 | 単純なMD5ハッシュ（古いバージョンで使われていた方式） | | sha1 | SHA1ハッシュ | | ssha | salt付きSHA1ハッシュ（LDAPで使われている方式） | | crypt | Unixのcrypt関数 | | mysql | バージョン4.1.1以前のMySQLで使われていたパスワード | | my411 | バージョン4.1.1以降のMySQLで使われているパスワード | * 型: 文字列 * デフォルト値: ''smd5'' ==== デフォルトグループ(ACL) : defaultgroup ==== サインアップを完了したユーザーが自動的に参加するグループを指定します（''openregister''を使う場合）。 * 型: 文字列 * デフォルト値: ''user'' ==== スーパーユーザー(ACL) : superuser ==== DokuWikiのスーパーユーザー権限を持ったユーザーを設定します。スーパーユーザーはACLの制限に関わらず、全ての権限を持っています。ACLの制限そのものを編集することも出来ます。いわゆるrootのようなものです。 このオプションにはユーザ名またはグループ名（グループ名の場合は名前の先頭に''@''を付ける）を指定します。 * 型: 文字列 * デフォルト値: ''!!not set!!'' **注意:** 現行バージョンでは、ユーザー名かグループ名に特殊記号を使っている場合は、以下の表に基づいて変換して記述する必要があります。 > 表の記述は現状の動作と食い違っているようです。たとえば、@wiki%5fwriteと設定すると@wiki%255fwriteに二重にエンコードされます。 ^ Space | %20 ^ ! | %21 ^ " | %22 ^ # | %23 ^ $ | %24 ^ % | %25 ^ & | %26 ^ ' | %27 ^ ( | %28 ^ ) | %29 ^ * | %2a | ^ + | %2b ^ , | %2c ^ - | %2d ^ . | %2e ^ / | %2f ^ : | %3a ^ ; | %3b ^ < | %3c ^ = | %3d ^ > | %3e ^ ? | %3f | ^ @ | %40 ^ [ | %5b ^ \ | %5c ^ ] | %5d ^ %%^%% | %5e ^ _ | %5f ^ ` | %60 ^ { | %7b ^ %%|%% | %7c ^ } | %7d ^ ~ | %7e | 例: ユーザー名が''admin@foo.bar''の場合は、このオプションには''admin%40foo%2ebar''を設定します。グループ名の先頭に付ける''@''は**エンコードしない**でください。 ==== マネージャー : manager ==== DokuWikiのマネージャー権限を持つユーザーを指定します。マネージャーは、[[plugin:revert|Revert Manager]]など管理メニューのうちの一部の権限にアクセスできます。 ユーザ名または先頭に''@''を付けたグループ名を指定します。 * 型: 文字列 * デフォルト値: ''!!not set!!'' ==== プロフィール変更時に現在のパスワードを要求(ACL) : profileconfirm ==== DokuWikiのユーザ情報を更新するときに確認のために現在のパスワードを要求するかどうかを指定します。 * 型: ブール値 * デフォルト値: 1 ==== 新規ユーザー登録を通知するメールアドレス : registernotify ==== このオプションにemailアドレスを指定すると、Wikiに新しいユーザの登録があったときにそのアドレスにお知らせが送信されます。 * 型: 文字列 * デフォルト値: ==== DokuWiki の動作を無効にする : disableactions ==== %%''?do=something''%%コマンドのいくつかを無効にします。 * 型: 文字列 * デフォルト値: %%""%% たとえば、indexmenuプラグインを導入した場合に、$conf['disableactions']="index"と設定することですべてのページのデフォルトの索引を無効にすることができます。 アクションのリストは、[[plugin:config|設定マネージャ]]プラグインをご覧ください。 ==== sneaky_index ==== このオプションを有効にすると、ユーザーが特定の名前空間読み取り権限を持たない場合、そのユーザーにはその名前空間の索引が表示しないようにします。下位階層の名前空間が上位の名前空間より高い権限を要求する一般的なケースでは、この設定によって索引ページの表示が乱れることがあります。完璧主義者にしかお勧めしません。 * 型: ブール値 * デフォルト値: 0 ===== スパム対策設定 ===== ==== 単語リストに基づくスパムブロック : usewordblock ==== [[blacklist|Blacklisting]]による[[meatball>WikiSpam|Wikiスパム]]対策を有効にします。 * 型: ブール値 * デフォルト値: ''1'' ==== rel="nofollow"を付加 : relnofollow ==== 外部リンクに''''のように''rel="nofollow"''を使うかどうかを指定します。\\ //nofollowについては、[[http://googleblog.blogspot.com/2005/01/preventing-comment-spam.html|このページ]]や、別の視点から書かれた[[http://www.nonofollow.net/index.php?title=Main_Page|このページ]]が参考になります。// * 型: ブール値 * デフォルト値: ''1'' ==== インデックスを許可 : indexdelay ==== ページの作成/編集の後、検索エンジンのインデックス化を許可するまでの時間を秒で指定します。 このオプションで指定した秒数が経過するまでは、ページの出力に''''を追加することで検索エンジンのインデックス化をブロックします。 * 型: 数値 * デフォルト値: ''60*60*24*5'' (5日) ==== メールアドレス保護 : mailguard ==== メール収集ロボット対策としてメールアドレスの難読化を行うかどか、および行う場合の方式を指定します。 * ''visible'' -- ''@''を''[at]''に、''.''を''[dot]''に、''-''を''[dash]''にそれぞれ置き換える * ''hex'' -- 16進数値参照によりアドレスをエンコードする * ''none'' -- 難読化を行わない * 型: 文字列 * デフォルト値: ''hex'' ==== HTMLのアップロード攻撃対策 : iexssprotect ==== メディアマネージャーによるHTMLのアップロードによる攻撃（ほかのHTMLでないファイルに隠されている場合にも有効）からWikiを保護します。この機能は[[http://www.splitbrain.org/blog/2007-02/12-internet_explorer_facilitates_cross_site_scripting|Microsoft Internet Explorerのバグ]]対策です。 * 型: ブール値 * デフォルト値: 1 ===== 編集設定 ===== ==== 編集中の自動保存(ドラフト)機能を使用 : usedraft ==== 自動保存（[[draft|ドラフト]]）機能を有効にするかどうかを指定します。 * 型: ブール値 * デフォルト値: ''1'' ==== HTML埋め込み : htmlok ==== ''%%%%''タグによるHTMLの埋め込みを許可するかどうかを指定します。このオプションをオンにすると、間違ったHTMLの挿入でレイアウトが崩れたり、XHTMLへの準拠が失われる場合があります。:!:このオプションをオンにすると、自由にアクセスできるサイトでは重大なセキュリティ上の問題となりますので注意してください。 * 型: ブール値 * デフォルト値: ''0'' ==== PHP埋め込み : phpok ==== ''%%%%''タグによるPHPの埋め込みを許可するかどうかを指定します。:!:このオプションをオンにすると、自由にアクセスできるサイトでは重大なセキュリティ上の問題となりますので注意してください。 * 型: ブール値 * デフォルト値: ''0'' ==== 更新通知機能 : notify ==== このオプションには、ページが追加されたり更新されたときに通知するemailアドレスを指定します。空文字列を指定した場合は通知メールは送信されません。複数のメールアドレスを指定するには、各エントリをコンマ（','）で区切って記述します（DokuWikiがすべてのメールを送信するときに使う"From" アドレスは、[[wiki:ja:config#メール送信時の送信元アドレス : mailfrom|mailfrom]]オプションにより設定できます）。 * 型: 文字列 * デフォルト値: ==== 変更を通知するメールアドレス : subscribers ==== 特定のページについての更新通知機能（**notity**オプションと類似の機能）を有効にするかどうかを指定します。このオプションをオンにすると、ログインユーザに対して「変更履歴配信の登録」ボタンが表示されるようになります（DokuWikiがすべてのメールを送信するときに使う"From" アドレスは、[[wiki:ja:config#メール送信時の送信元アドレス : mailfrom|mailfrom]]オプションにより設定できます）。 * 型: ブール値 * デフォルト値: 1 ==== ファイルロック期限 : locktime ==== ファイルロックの存続期間を指定します。詳細は[[locking|Page Locking]]を参照してください。 * 型: 数値 * デフォルト値: ''15*60'' (15分) ==== キャッシュ保持時間 : cachetime ==== ページキャッシュの存続期間を秒で指定します。詳細は[[caching|Caching]]を参照してください。 * 型: 数値 * デフォルト値: ''60*60*24'' (1日) ===== リンク設定 ===== ==== リンクの表示先 : target ==== このオプションはリンクの種類ごとにHTMLでのtarget属性の値を設定します。target属性の値は、Webブラウザに要求されたリンクをどのウィンドウで開くかを指示します。target属性の値が空の場合は同じページでリンク先を開きます。 * 型: 配列 * デフォルト値: 空（すべてのリンクを同じブラウザウィンドウで開く） 可能な配列のキーを以下に示します。 * ''wiki'' * ''interwiki'' : [[interwiki|InterWiki]]リンクに対する指定 * ''extern'' * ''media'' : アップロードファイルに対する指定 * ''windows'' : Windows共有に対する指定 target属性として指定できる値を以下に示します。 * ''_blank'' : リンクを新しいウィンドウで開く * ''_self''または空文字列 : リンクを同じウィンドウで開く * その他、''_parent'' or ''_top'' or //framename//などの値は、フレームを使ったテンプレートを利用している場合に指定する。指定すべき値はフレームの設定によって異なる ===== メディア設定 ===== ==== GDlibバージョン : gdlib ==== PHPのlibGDが利用できる場合、DokuWikiはこのライブラリを使用して[[images]]をリサイズします。DokuWikiは利用できるlibGDのバージョンを自動的に検出しますが、PHPのバージョンが古い場合、検出に失敗します。このオプションではそうした場合にバージョンを強制的に指定できます。指定できる値は、'''0'''（libGDサポートなし）、'''1'''（libGD 1.xを使用）、または'''2'''（自動検出によるlibGD 2を使用）のいずれかです。 * 型: 数値 * デフォルト値: 2 ==== ImageMagick変換ツールへのパス : im_convert ==== DokuWikiはデフォルトではPHPのlibGDライブラリ（上記参照）を使用しますが、さらに強力な機能を持ったImageMagickを使用することもできます。ImageMagickを利用できる環境は限られますが、もし利用できるならこのオプションでパスを指定することでlibGDの代わりにImageMagickを利用できます。 * 型: 文字列 * Default: ==== JPG圧縮品質 : jpg_quality ==== jpgのリサイズ画像を作成する際の圧縮品質を指定します。小さい値を指定すればファイルサイズが小さくなりますがjpg圧縮による劣化が生じます。0～100までの値を指定できます。 * 型: 数値 * デフォルト値: 70 ==== 外部からのダウンロード最大サイズ : fetchsize ==== fetch.phpが外部からダウンロードする際の最大サイズを指定します。この値は外部画像を必要に応じてリサイズしてキャッシュする際に使われます。この機能を完全に無効にする場合は、0を指定します（[[wiki:ja:security|セキュリティ]]ページでは0を指定するように推奨）。 * 型: 数値 * デフォルト値: ''0'' ===== 高度な設定 ===== ==== DokuWikiの更新とセキュリティに関する情報をチェックする : updatecheck ==== 新リリースのメッセージをチェックするかどうかを指定します。詳細は[[update check|Update Check]]を参照してください。 * 型: ブール値 * デフォルト値: ''1'' ==== URLの書き換え : userewrite ==== ナイスなURLに書き換える機能を利用するかどうかを指定します。Apacheのmod_rewriteモジュール、またはDokuWikiによるURL書き換えが利用できます。 * 型: 数値 * デフォルト値: ''0'' 指定できる値は以下のとおりです。 ^ 値 ^ 情報 ^ URLの例 ^ | 0 | URL書き換えを行わない（デフォルト） | %%http://example.com/dokuwiki/doku.php?id=wiki:syntax%% | | 1 | ApacheモジュールによるURL書き換えを行う（.htaccessファイルの編集が必要） | %%http://example.com/dokuwiki/wiki:syntax%% | | 2 | DokuWikiによる書き換えを行う | %%http://example.com/dokuwiki/doku.php/wiki:syntax%% | 詳細については[[wiki:ja:rewrite|URLの書き換え]]を参照してください。 ==== URL上の名前空間の区切りにスラッシュを使用 : useslash ==== 上記のURL書き換えを有効にした場合、このオプションを設定することでURL中の[[namespace|名前空間]]の区切り文字をコロンからスラッシュに置き換えることができます。 * 型: ブール値 * デフォルト値: ''0'' ==== ページ名の単語区切り文字 : sepchar ==== この設定オプションは、ページIDに含まれる単語の区切り文字を指定します。ページIDに含まれる有効でないページ文字はこのオプションで指定した文字に置き換えられます。 ページIDとはURLのうちのページを指定する部分を指します。たとえば、[[doesn't exist|doesn't exist]]というリンクは、''wiki.splitbrain.org/wiki:doesn_t_exist''というURLになります。このうちの''wiki:doesn_t_exist''の部分がページIDです。sepcharのデフォルト値は'_'なので、リンクに含まれるアポストロフとスペースが'_'に置き換えられています。 sepcharを別の文字に変更することで、'_'を別の文字に変えることができます。sepcharに指定できる有効な文字は、ページIDとして有効な文字、すなわち英字、数字、アンダースコアー（''_''）、ダッシュ（''-''）、およびドット（''.''）です。sepcharには**正確に**1文字だけを指定してください。 //このオプションの扱いには注意が必要です。//このオプションを変更すると、以前のsepcharの設定のときに作成したページにアクセスできなくなります。新規ページを作成するとそのページIDがページの内容を保存するファイルの名前になります。sepcharの設定値が'_'のときにページを作成し、後に'-'に変更すると、以前の設定のときに作成したページへのリンクは新しい設定に基づくURLに変わるのに対して、ファイル名は変更されないためにリンクが壊れてしまうためです。 * 型: 文字 (英字、数字、'_'、'-'、'.') * デフォルト値: ''_'' ==== Canonical URL(正準URL)を使用 : canonical ==== このオプションを有効にすると、リンクが''%%http://server/path%%''のような絶対URLになります。以前のDokuWikiでは絶対URLがデフォルトでしたが、現在ではサーバルートからの相対URLの方が望ましいでしょう。 * 型: ブール値 * デフォルト値: ''0'' ==== 自動複数形処理 : autoplural ==== このオプションはおそらく英語のWikiにのみ有益です。このオプションに''1''を設定すると、単数形のリンクページが見つからない場合、自動的に複数形のページを試みます（逆も同様）。したがって、[[pagenames]]と[[pagename]]は、存在する同一のページに自動的にリンクされます。 * 型: ブール値 * デフォルト値: ''0'' ==== メール送信時の送信元アドレス : mailfrom ==== [[DokuWiki]]から送信されるメールの送信者アドレスを指定します。使用するメールサーバがここで指定したメールアドレスを受け付けることが必要です。このオプションを指定しない場合は、PHPのデフォルトアドレス（通常はwebserveruser@webserverhostname）が使われます。 * 型: 文字列 * デフォルト値: ==== CSSとJavaScriptを圧縮 : compress ==== CSSとJavaScriptから空白文字とコメントを取り除くシンプルな圧縮を有効にするかどうかを指定します。[[#アーカイブの圧縮方法 : compression|compression]]オプションとは異なりますので注意してください。混乱を避けるためコンパクト化と呼ばれることもあります。 * 型: ブール値 * デフォルト値: 0 ==== xhtmlに対するコンテンツ圧縮（gzip）を使用 : gzip_output ==== ''gzip''または''deflate''によるコンテンツエンコーディングを扱うことができるブラウザに対して、圧縮したページをネットワーク経由でページを送信するかどうかを指定します。Apacheのmod_gzipなどの外部ツールによる圧縮を適用する場合は、この設定を無効にしてください。 * 型: ブール値 * デフォルト値: 0 ==== 非公開ページ(Regex) : hidepages ==== 特定のページを自動リスト（RSS、最近の更新、検索結果、索引）からフィルタするための正規表現を指定します。このオプションは、特定のページをサイドバーのテンプレートなどから除外したいときに役立ちます。指定した正規表現は、先頭にコロンの付いたページIDとマッチされ、マッチした場合そのページは非公開ページとみなされます。このオプションは、セキュリティ対策というよりは見た目を整える目的で使用します。 * 型: 文字列 * デフォルト値: ==== 文書が存在しないページに"HTTP404/Page Not Found"を使用 : send404 ==== 誰かが存在しないページへのリンクをたどった場合、DokuWikiは通常の200 HTTP応答を返します。Wikiとしてはこの動作は望ましいものですが、DokuWikiをCMSシステムとして使う場合には"not found"を表す404応答が望ましいでしょう。このオプションを有効にすることで404応答を返す動作を実現できます。注意: この設定はHTTPステータスを変更するだけで、送出されるコンテンツは変わりません。 * 型: ブール値 * デフォルト値: false ==== アーカイブの圧縮方法 : compression ==== ページの古いバージョン([[attic|以前のリビジョン]])を保存する方法を指定します。デフォルトは''gz''でgzipにより圧縮しますが、''bz2''を指定するとbzip2による圧縮を行います。''0''を指定すると圧縮が無効になります。[[#CSSとJavaScriptを圧縮 : compress|compress]]オプションと混同しないように注意してください。 * 型: 文字列 * デフォルト値: ''gz'' リビジョンが作成された後に圧縮方法を変更すると、「以前のリビジョン」ボタンで過去のリビジョンにアクセスすることができなくなるので注意してください。この問題を解決するには、古いリビジョンを変更後の圧縮方法で圧縮しなおすか、古いリビジョンを解凍する必要があります。 ==== Googleサイトマップ作成頻度 : sitemap ==== DokuWikiは、検索エンジンのGoogleに提出するためのXML [[http://www.google.com/webmasters/sitemaps/docs/en/about.html|サイトマップ]]を自動的に生成することができます。このオプションは、サイトマップを何日おきに再生成するかを指定します。デフォルトではサイトマップを生成しません。詳細は[[sitemap|Google Sitemap]]を参照してください。 * 型: 数値 * デフォルト値: 0 ==== RSSフィード形式 : rss_type ==== 作成するXMLフィードの種類を指定します。詳細は[[wiki:ja:syndication|XML Syndication]]を参照してください。 * 型: 文字列 * デフォルト値: 'rss1' * Options * 'rss' - RSS 0.91 * 'rss1' - RSS 1.0 * 'rss2' - RSS 2.0 * 'atom' - Atom 0.3 * 'atom1' - Atom 1.0 ==== RSS内リンク先 : rss_linkto ==== XMLフィードのリンク先を指定します。詳細は[[wiki:ja:syndication|XML Syndication]]を参照してください。 * 型: 文字列 * デフォルト値: 'diff' * Options * 'diff' - リビジョン間の差分を表示するページ * 'page' - 現行のリビジョンのページ * 'rev' - そのページのすべて乗りビジョンを表示するページ * 'current' - 最新リビジョンを表示するページ（'page'より新しいリビジョンを表示） ==== RSSフィードの更新間隔 : rss_update ==== RSSの更新頻度を秒で指定します。更新頻度の間の時間はキャッシュされたRSSが使用されます。更新ペースが遅いWikiでは、更新頻度の設定値は1時間程度で十分でしょう。詳細は[[wiki:ja:syndication|XML Syndication]]を参照してください。 * 型: 数値 * デフォルト値: 60*5 (5分) ==== 最近の更新とする期間(日数) : recent_days ==== グローバルの「最近の更新」リストに何日前までの更新を表示するかを指定します。 * 型: 整数値 * デフォルト値: 7 ==== フィードのタイトルにサマリーを表示 : rss_show_summary ==== フィードのアイテムタイトルに編集サマリーを付加するかどうかを指定します。DokuWikiをブログまたはCMSとして使用している場合は、このオプションをオフにした方がよいでしょう。 * 型: ブール値 * デフォルト値: 1 ==== broken_iua ==== このオプションは、PHPの[[phpfn>ignore_user_abort]]関数が機能しないプラットフォームのための回避策です。現在のところ、対象となるのはIIS上でPHPがCGIとして稼働しているシステムのみです。 * 型: ブール値 * デフォルト値: 0 ===== ネットワーク設定 ===== ==== プロキシ設定 : proxy ==== 外部への接続のためにWebプロキシを使用するための設定オプションです。詳細は[[proxy|Proxy-Support]]を参照してください。 * 型: 配列 * デフォルト値: （プロキシを使用しない） ==== セーフモード対策を行う : safemodehack ==== [[safemodehack|セーフモード対策]]を有効にします。詳細は[[safemodehack|セーフモード対策]]を参照してください。 * 型: ブール値 * デフォルト値: 0 ==== FTP設定(セーフモード対策) : ftp ==== [[safemodehack|セーフモード対策]]で使用するFTPのオプションを指定します。詳細は[[safemodehack|セーフモード対策]]を参照してください。 * 型: 配列 * デフォルト値: （使用しない） ====== 翻訳について ====== =====オリジナル文書のリビジョン===== このページは[[wiki:config|Configuration Options]]の2008/06/10 15:52に更新されたリビジョンを元に翻訳しています。オリジナル文書の新しい更新に気づいた方は、[[http://wiki.splitbrain.org/wiki:config?do=revisions|差分]]を参照してアップデートしてください。 =====翻訳者===== 翻訳を更新したら以下に日付つきの署名を追加してください。 *[[denden@denden-cafe.com|denden]] -- 2008/06/10 翻訳完了 =====査読者===== 査読を完了したら以下に日付つきの署名を追加してください。