Руководство:Pywikibot/Установка

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 80% complete.
Outdated translations are marked like this.
Эта страница поможет вам начать работу с Pywikibot, либо на вашем собственном компьютере, в Toolforge, либо используя Pywikibot: A Web Shell (PAWS).
На PAWS

PAWS: A Web Shell - самый простой способ начать работу с Pywikibot. Нет необходимости установки, для отправки команд используется веб-интерфейс.

На ваш компьютер

Это руководство позволит вам установить и запустить Pywikibot на своём компьютере. Оно состоит из 4-х основных шагов:

Toolforge обеспечит вас стабильной облачной инфраструктурой на серверах Викимедиа, допускающей работу ботов непрерывно или по расписанию.

Установка Python

Загрузите и установите Python с https://www.python.org/downloads/.

Если у вас уже установлен Python, проверьте его версию, просто набрав в консоли python --version. To discover if Python version 3 or above is installed, run python3 --version in a console.

Ubuntu 19.04 and up comes with versions 2 & 3 installed. Python v2 runs by default using terminal command python; to use v3, use terminal command python3.

Python 3.7 or higher is currently required to run the bot. При работе в Windows не забудьте отредактировать переменную среды PATH для корректной работы Python и pip.

Установка зависимостей

Additional packages are required to run Pywikibot. Run the following command to install these packages:

$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging

For Python 3.7 an additional package is required. Install it with:

$ python -m pip install importlib_metadata

An alternate MediaWiki markup parser may be installed with:

$ python -m pip install "wikitextparser>=0.47.5"

See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start

Установка Pywikibot

$ python -m pip install pywikibot

If using pip, use pwb instead of python pwb.py in examples below.

Скачайте текущую сборку Pywikibot версии stable: .tar.gz, .zip.

Распакуйте эти файлы, например в ~/pywikibot или c:\users\username\pywikibot.

Также можно получить последнюю версию, используя git или svn из Gerrit, см. Manual:Pywikibot/Gerrit#For users . Этот способ рекомендуется активным ботоводам и разработчикам, использующим Pywikibot.

Старые версии доступны по адресу https://pywikibot.toolforge.org/.

Обновление

Сохраняйте среду запуска своего бота в актуальном состоянии. Новые версии выходят непрерывно и доступны по тому же адресу.

Если вы используете выпуск с git или svn, то можете пропустить этот этап. В противном случае помните о необходимости сделать резервную копию ваших файлов настроек конфигурации и скриптов ("user-config.py", family-файла или своих скриптов, которые вы могли создать или изменить, и какого-либо текущего XML-дампа, который вы используете для вики) перед установкой нового выпуска.

Распакуйте новую версию поверх старой, перезапишите все файлы.

Настройка Pywikibot

Откройте терминал в UNIX-подобной системе (Linux/BSD/Solaris) или "Командную строку" в Windows и смените директорию на ту, в которую вы распаковали pywikibot.

Unix-подобные системы (Linux/BSD/Solaris):
$ cd ~/core
Windows:
$ c:
$ cd "\Users\username\pywikibot"

Разумеется, заменив на тот путь, куда вы распаковали pywikibot.

Продолжайте с нижеприведёнными командами для генерации файла настроек пользователя:

$ python pwb.py generate_user_files

Следуйте инструкциям, чтобы настроить Pywikibot.

Наконец запустите нижеприведённую команду в лог в свою Вики:

$ python pwb.py login

Использование в частном вики-проекте

Pywikibot уже предварительно настроен для большого количества вики-сайтов, но, возможно, не для того, с которым вы хотите работать. Смотрите Manual:Pywikibot/Use on third-party wikis для настройки Pywikibot для вашей вики.

Дополнительная настройка

Pywikibot обеспечивает широкие возможности настройки для изменения поведения вашего бота. Вы можете изменить эти настройки в файле user-config.py. Смотрите в config.py список всех параметров, которые вы можете использовать.

Конфигурация прокси

Для связи с сетью Pywikibot использует библиотеку requests. Чтобы requests использовала прокси сервер, можно настроить переменные среды HTTP_PROXY и HTTPS_PROXY. См. документацию requests за более подробной информацией.

Запуск скрипта

Pywikibot выпускается с большим количеством скриптов в комплекте, они находятся в директории scripts. Вы можете запустить всё это с помощью

$ python pwb.py [name of the script]

To learn more about running basic Pywikibot scripts, see:

Список всех скриптов доступных в $scripts.

Другие зависимости

Большинство скриптов не требую дополнительных пакетов, но некоторые могут не заработать без них. Они перечислены в requirements.txt вместе с их зависимостями.

Чтобы установить зависимости, воспользуйтесь $pip. Выполните следующие команды, чтобы установить пакеты:

$ python -m pip install [name of the package]

Или следующую команду для установки всех рекомендуемых пакетов:

$ python -m pip install -r requirements.txt


If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel подключиться or pywikibot@ mailing list.