Руководство:Pywikibot/Compat/Основное использование

This page is a translated version of the page Manual:Pywikibot/Compat/Basic use and the translation is 45% complete.

Применение

Смотрите создание коротких ссылок для пользователей Windows.

Выбор и запуск скрипта бота

Теперь, когда вы установили Python и Pywikibot, вам теперь нужно получить текстовый интерфейс для вашей операционной системы.

Получение доступа к Pywikibot

После того как вы создали файл который называется user-config.py , вы можете получить доступ к Pywikibot.

На Windows это можно выполнить открыв меню Пуск, и потом нажав на Выполнить и написать "cmd.exe".

  • Измените корень на диск C: написав "chdir C:\".
  • Напишите chdir \"название папки в которую Pywikibot был загружен" (например: chdir \"pywikibot" если папка была в самом диске C:)

Данные шаги также могут понадобиться:

  • Переместите папку httplib2 которая находится в поддиректории externals на уровень выше.
  • Все скрипты которые вам могут понадобится лучше скопировать из поддиректории "scripts" в основную папку. Это включает login.py.

На системах Mac вам нужно найти Terminal.app в /Applications/Utilities, посмотрите Установка в Mac.

На Linux или любом другом Unix, используйте любой терминал такие как gnome-terminal, konsole, xterm, или просто консоль в текстовом режиме.

In compat, run the script login.py by typing "python login.py". If you don't have user-config.py yet, this command will interactively create it.

In core, from the core directory, run the script login.py by typing "python pwb.py login". If you don't have user-config.py yet, this command will interactively create it.

pwb.py does add the core directory to the `PATH` variable so that python sees the pywikibot directory. There are other ways to fix this like adding the core directory (or any directory containing the pywikibot directory) to `PATH` or `PYTHONPATH`.
Введите пароль

Python will then return:

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.

Using a bot

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").

Скрипты

Main page: Руководство:Pywikibot/Скрипты

Аргументы командной строки

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:

-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 xx, overriding the configuration in user-config.py.
-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-config.py.
-user:xyz
Log in as user 'xyz' instead of the default username.
-log
Разрешите лог-файлы. Логи будут сохранены в подкаталоге logs.
-log:xyz
Enable the logfile, using xyz 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, python scriptname.py -family:wiktionary 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.