====== コマンドラインツール ======

[[:ja:dokuwiki|DokuWiki]] には DokuWiki サーバーの(UNIX)コマンドラインから実行可能な PHP スクリプトがいくつか付属しています。
**これらのスクリプトはすべて ''<yourWiki>/bin/'' ディレクトリの中に置かれています。**

**注意：**これらのスクリプトを利用可能にするには、PHP のコマンドラインインタープリタをシステム上にインストールする必要があります。

スクリプトを実行するには 2 つの方法があります。以下のどちらの方法でも実行できます。

<code bash>
$> chmod +x <script>.php
$> ./<script>.php
</code>

または、以下のようにして実行します (こちらを推奨します)。

<code bash>
$> /path/to/php <script>.php
</code>

===== dwpage.php =====

**注意：**認証とアクセス制御、もしくは DokuWiki の[[:devel:events|イベントシステム]]に依存したいくつかのプラグインで問題が発生することが報告されています。

  書式：dwpage.php [オプション] <アクション>
  
    コマンドラインでの DokuWiki のページ編集をサポートするための
    ユーティリティです。編集作業のためのページのチェックアウトと、
    ページ編集後のコミットを実行することができます。
  
    アクション
        checkout: $ dwpage.php --help=checkout を参照
        commit  : $ dwpage.php --help=commit   を参照
        lock    : $ dwpage.php --help=lock     を参照
  
    オプション
        -h, --help=<アクション>    ヘルプを出力します。
            例: $ ./dwpage.php -hcommit
            例: $ ./dwpage.php --help=commit

===== indexer.php =====

[[:ja:search|検索]]インデックスをアップデートすることができます。

  書式：indexer.php [オプション]
  
    新規もしくは更新があったすべてのページについて、検索インデッ
    クスを更新します。-c オプションが指定された場合は、最初にイ
    ンデックスを削除します。
  
    オプション
        -h, --help     ヘルプを出力します。
        -c, --clear    更新前にインデックスを削除します。
        -q, --quiet    何も出力しないようにします。

適切なアクセス権を持つユーザーによる、できる限り適切な作業ディレクトリ上での実行が必要です。
例：debian lenny の場合、ユーザーは www-data 、ディレクトリは ~www-data 。

===== wantedpages.php =====

  書式：wantedpages.php [名前空間]
  
    リンクされているものの存在しないページのリストを出力します。
      
    もし検索する名前空間 [名前空間] が指定されなかった場合は、
    ルート名前空間から検索します。
  
    オプション
        -h, --help    ヘルプを出力します。

===== striplangs.php =====

インストール状態から不要な言語ファイルを削除できます。

  書式：striplangs.php [-h [-x]] [-e] [-k 言語1[,言語2]..[,言語N]]
  
    インストール状態から -k オプションにしてされた言語を残して
    全ての言語を削除します。英語は削除されません。
  
    オプション
        -h, --help     ヘルプを出力します。
        -x, --examples 使用例も出力します。
        -k, --keep     カンマ区切りの言語です。-e は常に暗黙指定です。
        -e, --english  英語を残します。-k がない場合のダミーです。