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 95% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bân-lâm-gú • ‎Deutsch • ‎English • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
このページではPywikibotを使い始める貴方をお助けします。お手持ちのコンピューター、Toolforge、PAWS: A Web Shell (PAWS) のどれでも大丈夫です。
Gnome-system-software-installer.svg
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 $py2以降か、Python $py3以降なら、あなたの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"

For Python 2.7 additional packages are mandatory:

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

プロキシの設定

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

スクリプトの実行

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@ メーリング リストにお問い合わせください。