Manual:Pywikibot/Installation/ja

 このページではPywikibotを使い始める貴方をお助けします. お手持ちのコンピューター、Toolforge、PAWS: A Web Shell (PAWS) のどれでも大丈夫です.

  PAWS PAWS: A Web ShellはPywikibotを使い始める最も簡単な方法です. インストールは不要で、ウェブインターフェースを使ってコマンドを送信します.

 お手持ちのコンピューター 自分のコンピュータにPywikibotをセットアップして実行するためのマニュアルです. この過程には主に4つの手順があります.  Toolforge Wikimediaサーバー上のToolforgeはあなたに安定したクラウド・インフラストラクチャを提供するので、ボットを常時または計画的に実行することが出来ます.
 * Pythonのインストール
 * Pywikibot のインストール
 * Pywikibotの設定
 * スクリプトの実行

Pythonのインストール
https://www.python.org/downloads/ からPythonをダウンロードしてインストールしましょう.

すでにPythonをインストール済みなら、端末で を実行して、十分に新しいバージョンかどうか確認しましょう. Python 2.7.4以降か、Python 3.4以降なら、あなたのPythonは十分に新しいです. しかし、Python 3.5未満のバージョンは、近い将来にサポートが終了します. そのため、Python 3.5以上のバージョンを使用することが推奨されます.

Windowsでは、Pythonやpipが正しく動作するように、環境変数PATHを変更し忘れないようにしましょう.

依存関係のインストール
追加パッケージ requests がPywikibotを動かすためには必要です. pipを使用して下さい. Python 2.7.9以上もしくはPython 3.4以上を使っているなら、それはインストールされています. パッケージのインストールのため以下のコマンドを実行してください：

For Python 2.7 additional packages are mandatory:

Pywikibot のインストール
最新の Pywikibot stable: .tar.gz, .zip をダウンロードしてください.

Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.

ダウンロードしたファイルを、例えば  または   に展開してください.

あるいは、最新版を git クライアントや svn クライアントから手に入れたい場合は、 をみてください. Pywikibot を使った作業や開発を行う場合は、この方法を推奨します.

その他のバージョンは https://tools.wmflabs.org/pywikibot/ から入手できます.

Pywikibot の更新
あなたのbotフレームワークを最新に保って下さい. 安定版は継続的に発表され、以前と同じ場所から入手できます.

もしgitやsvnリリースを使っているなら、この節はスキップするかもしれません. ただし、新しいリリースをインストールする前に、あなたの設定ファイルとスクリプト（ 、familyファイル、あなたが作成したカスタムスクリプト、あなたがウィキで使用している現在のXMLファイルのダンプ）のバックアップの必要性に気づいていて下さい.

旧バージョンの場所に新バージョンを解凍してください. すべてのファイルが上書きされます.

Pywikibotの設定
Unixライク（Linux／BSD／Solaris）ならターミナルを、Windowsならコマンドプロンプト（"Windows System"／"全てのアプリケーション"の中の"アクセサリ"フォルダ／スタートメニューの中の"全てのプログラム"以下にあります）を開いて、あなたがpywikibotを解凍した場所にディレクトリを変更しましょう.

Unix系（Linux/BSD/Solaris）：



Windows：



当然ですが、（上記の例は）あなたがpywikibotを解凍した場所に置き換えてください.

ユーザ設定ファイルを生成するため以下のコマンドを続けて下さい：

pywikibotを設定する為にプロンプトに従いましょう.

最後に、次のコマンドを入力することで、あなたの wiki にログインできます.

サードパーティーのwikiで使用するには
Pywikibotには数多くのウィキに対する事前設定がありますが、あなたが使用したいウィキの事前設定がないかもしれません. あなたのウィキ用にPywikibotを設定をする方法についてはをご覧ください.

その他の設定オプション
あなたのボットの挙動を変更できるように、Pywikibotには幅広い設定オプションがあります. あなたは「user-config.py」ファイルでそれらの設定を変更することが出来ます. あなたが使用可能なパラメーターのリストはconfig2.pyをご覧ください.

プロキシの設定
Pywikibotは、ウェブとの通信に  を使用しています. プロキシサーバーを使用するようにするには、環境変数  および   を設定してください. 詳細については、の解説を参照してください.

スクリプトの実行
Pywikibotには数多くの付属スクリプトが提供されており、scriptsディレクトリにまとめてあります. あなたはそれらを全て使う事が出来ます

スクリプトの一覧はから入手できます.

その他の依存関係
ほとんどのスクリプトには動作に追加パッケージは不要ですが、いくつかは動かない物があります. それらは依存パッケージと共に requirements.txt でリストされています.

依存パッケージをインストールするには、$pipを使用し、以下のコマンドを実行しましょう.

もしくは全ての推奨パッケージを一度にインストールするために以下のコマンドを実行しましょう.