Manual:Pywikibot/インストール

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 92% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
このページではPywikibotを使い始める貴方をお助けします。お手持ちのコンピューター、Toolforge、PAWS: A Web Shell (PAWS) のどれでも大丈夫です。
Unicorn paw logo.svg

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

お手持ちのコンピューター
Computer n screen.svg

自分のコンピュータにPywikibotをセットアップして実行するためのマニュアルです。この過程には主に4つの手順があります。

Toolforge logo.svg

Wikimediaサーバー上のToolforgeはあなたに安定したクラウド・インフラストラクチャを提供するので、ボットを常時または計画的に実行することが出来ます。

Pythonのインストール

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

すでにPythonをインストール済みなら、端末でpython --versionを実行して、十分に新しいバージョンかどうか確認しましょう。 Python 2.7.4以降か、Python 3.4以降なら、あなたのPythonは十分に新しいです。 However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

On Windows please don't forget to modify PATH environment variable to make Python and pip work properly.

依存関係のインストール

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

$ pip install requests

Pywikibot のインストール

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

ダウンロードしたファイルを、例えば ~/pywikibot または C:\Users\username\pywikibot に展開してください。

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

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

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をご覧ください。

Proxy configuration

Pywikibot relies on requests for communicating with the web. You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

スクリプトの実行

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

$ python pwb.py [name of the script]

スクリプトの一覧はManual:Pywikibot/Scripts から入手できます。

その他の依存関係

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

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

$ pip install [name of the package]

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

$ pip install -r requirements.txt


ご使用の Pywikibot のセットアップにさらなるヘルプが必要な場合は、IRC チャンネル #pywikibot 接続する または pywikibot@ メーリング リストにお問い合わせください。