Manual:Pywikibot/Compat/Basic use/ja

使用

 * ウィンドウズユーザーの方は、ショートカットを作るを御覧ください. 

ボット スクリプトの選択と実行
これでPythonとPywikibotのインストールができたので、あなたのオペレーティングシステムのテキスト・インターフェースにアクセスしましょう.


 * pywikibot へのアクセス

という名前のファイルを作成した後、pywikibotにアクセスすることができます.

ウィンドウズではスタートメニューを開いて、「ファイル名を指定して実行」をクリックしてください. プログラムの名前を訊かれるので、 と打ち込みましょう.

を打ち込むことで、ルートをC:に変更しましょう
 * 「chdir　pywikibotがダウンロードされた場所」と入力してください. （例えばファイルがC:フォルダにあるなら、「chdir \"pywikibot"と入力しましょう. ）

以下の作業が必要になるかもしれません.

externalsのサブフォルダに入っているhttplib2フォルダを一階層上に移動させましょう.
 * 実行したいすべてのスクリプトはscriptsサブフォルダからメインフォルダに移動する必要があります. login.pyも含まれます.

Macでは、/Applications/UtilitiesからTerminal.appを探して、Macでのインストールを御覧ください.

Linuxや他のUnixでは、gnome-terminalやkonsole、xtermなど、好きなターミナルを使用してください. テキストモードのコンソールでもいいです.

Compatでは、スクリプトをpython login.pyと入力して実行しましょう. user-config.pyをまだ持っていなければ、このコマンドで対話的に作成することができます.

coreでは、coreのディレクトリにおいて、スクリプトをpython login.pyと入力して実行しましょう. user-config.pyをまだ持っていなければ、このコマンドで対話的に作成することができます.

pwb.pyはcoreディレクトリを'PATH'環境変数に加えます. これによってpythonはpywikibotのディレクトリを把握できます. coreディレクトリを'PATH'や'PYTHONPATH'に加えるなどの方法でも解決できます.


 * パスワードの入力

するとPythonは次のように返してきます.

''' Password for user your_bot on your_site:en: '''

Use the password you used for the bot's login name. Note that your input will not be visible for privacy reasons. The bot can't work anonymously. Unless you change your password, you normally need to run this program only once, the bot usually does not get logged off.


 * ボットの使用

The bots are in the main pywikibot folder when downloaded.

If necessary, use the command cd to go to the directory where the bot files are saved.

Now run any of the bots here by typing "python botname.py" (If you are using Windows, you can leave out "python").

スクリプト

 * メインのページ: 

コマンドライン引数
Although many bot scripts have their own command line arguments, which should be documented on their respective pages (or in their source code), all bots unless specifically stated to the contrary recognize the following command line arguments:

(full list here: )


 * -help
 * Print a list of global bot arguments (this list), followed by bot-specific help if available.


 * -lang:xx
 * Set the language of the wiki you want to work on to language code, overriding the configuration in.


 * -family:xyz
 * Set the family of the wiki you want to work on, e.g., wikipedia, wiktionary, wikitravel, ... This will override the configuration in.


 * -user:xyz
 * Log in as user 'xyz' instead of the default username.


 * -log
 * Enable the logfile. Logs will be stored in the logs subdirectory.


 * -log:xyz
 * Enable the logfile, using  as the filename.


 * -nolog
 * Disable the logfile (if it's enabled by default).


 * -putthrottle:nn
 * Set the minimum time (in seconds) the bot will wait between saving pages. The default value is 10.

For example,  will run the "scriptname" bot on wiktionary articles, overriding the default family setting in your user configuration.

Permission on Wikimedia projects
Make sure that your bot is approved by the wiki community where you are going to use it: see the global Bot policy for guidance. Strictness differs greatly between various projects.

Using your normal browser, create a login name and password for the bot. It is best to use a name that makes clear that it is a bot, and preferably also who is operating it. A common method is to use your own login name and add the word 'bot' to it, but several other forms also exist.