Manual:Pywikibot/インストール
自分のコンピュータにPywikibotをセットアップして実行するためのマニュアルです。この過程には主に4つの手順があります。
 |
| Pywikibot |
|---|
|
Pythonのインストール
https://www.python.org/downloads/ からPythonをダウンロードしてインストールしましょう。
すでにPythonをインストール済みなら、端末でpython --versionを実行して、十分に新しいバージョンかどうか確認しましょう。
Python 2.7.4 or higher, or Python 3.4 or higherがインストールされている場合は、Pythonのバージョンが十分に最新であることを示しています。
しかし、Python 3.5未満のバージョンは、近い将来にサポートが終了します。
そのため、Python 3.5以上のバージョンを使用することが推奨されます。
Windowsでは、Pythonやpipが正しく動作するように、環境変数PATHを変更し忘れないようにしましょう。
依存関係のインストール
追加パッケージ requests がPywikibotを動かすためには必要です。pipを使用して下さい。Python 2.7.9以上もしくはPython 3.4以上を使っているなら、それはインストールされています。パッケージのインストールのため以下のコマンドを実行してください：
$ pip install "requests>=2.20.1"
Python 2.7 では追加パッケージが必要
$ pip install "enum34>=1.1.6!=1.1.8"
$ pip install ipaddress
$ pip install pathlib2
Pywikibot のインストール
最新の Pywikibot stable ブランチ: .tar.gz, .zip をダウンロードしてください。
Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.
ダウンロードしたファイルを、例えば ~/pywikibot または C:\Users\username\pywikibot に展開してください。
あるいは、最新版を git クライアントや svn クライアントから手に入れたい場合は、Manual:Pywikibot/Gerrit をみてください。Pywikibot を使った作業や開発を行う場合は、この方法を推奨します。
その他のバージョンは https://pywikibot.toolforge.org/ から入手できます。
Pywikibot の更新
あなたのbotフレームワークを最新に保って下さい。安定版は継続的に発表され、以前と同じ場所から入手できます。
もしgitやsvnリリースを使っているなら、この節はスキップするかもしれません。ただし、新しいリリースをインストールする前に、あなたの設定ファイルとスクリプト（user-config.py、familyファイル、あなたが作成したカスタムスクリプト、あなたがウィキで使用している現在のXMLファイルのダンプ）のバックアップの必要性に気づいていて下さい。
旧バージョンの場所に新バージョンを解凍してください。すべてのファイルが上書きされます。
Pywikibotの設定
Unixライク（Linux／BSD／Solaris）ならターミナルを、Windowsならコマンドプロンプト（"Windows System"／"全てのアプリケーション"の中の"アクセサリ"フォルダ／スタートメニューの中の"全てのプログラム"以下にあります）を開いて、あなたがpywikibotを解凍した場所にディレクトリを変更しましょう。
Unix系（Linux/BSD/Solaris）：
$ cd ~/pywikibot
Windows：
$ c: $ cd "\Users\username\pywikibot"
当然ですが、（上記の例は）あなたがpywikibotを解凍した場所に置き換えてください。
ユーザ設定ファイルを生成するため以下のコマンドを続けて下さい：
$ python pwb.py generate_user_files
pywikibotを設定する為にプロンプトに従いましょう。
最後に、次のコマンドを入力することで、あなたの wiki にログインできます。
$ python pwb.py login
サードパーティーのwikiで使用するには
Pywikibotには数多くのウィキに対する事前設定がありますが、あなたが使用したいウィキの事前設定がないかもしれません。 あなたのウィキ用にPywikibotを設定をする方法についてはManual:Pywikibot/Use on third-party wikisをご覧ください。
その他の設定オプション
あなたのボットの挙動を変更できるように、Pywikibotには幅広い設定オプションがあります。 あなたは「user-config.py」ファイルでそれらの設定を変更することが出来ます。 あなたが使用可能なパラメーターのリストはconfig2.pyをご覧ください。
プロキシの設定
Pywikibotは、ウェブとの通信に requests を使用しています。プロキシサーバーを使用するようにするには、環境変数 HTTP_PROXY および HTTPS_PROXY を設定してください。詳細については、requests の解説を参照してください。
スクリプトの実行
Pywikibotには数多くの付属スクリプトが提供されており、scriptsディレクトリにまとめてあります。 あなたはそれらを全て使う事が出来ます
$ python pwb.py [name of the script]
スクリプトの一覧はManual:Pywikibot/スクリプトから入手できます。
その他の依存関係
ほとんどのスクリプトには動作に追加パッケージは不要ですが、いくつかは動かない物があります。 それらは依存パッケージと共に requirements.txt でリストされています。
依存パッケージをインストールするには、$pipを使用し、以下のコマンドを実行しましょう。
$ pip install [name of the package]
もしくは全ての推奨パッケージを一度にインストールするために以下のコマンドを実行しましょう。
$ pip install -r requirements.txt
- ご使用の Pywikibot のセットアップにさらなるヘルプが必要な場合は、IRC チャンネル #pywikibot 接続する または pywikibot@ メーリング リストにお問い合わせください。