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

This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 100% complete.
Эта страница поможет вам начать работу с 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. Чтобы узнать, установлен ли Python версии 3 или выше, выполните в консоли команду python3 --version.

Ubuntu 19.04 и выше поставляется с установленными 2 и 3 версиями. Python версии 2 по умолчанию использует терминальную команду python; чтобы использовать версию 3, используйте терминальную команду python3.

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

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

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

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

Для Python 3.7 требуется дополнительный пакет. Устанавливается командой:

$ python -m pip install importlib_metadata

Альтернативный анализатор MediaWiki разметки может быть установлен командой:

$ 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

При использовании pip, используйте pwb в python pwb.py примерах ниже.

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

Распакуйте эти файлы, например в ~/pywikibot или %USERPROFILE%\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 "%USERPROFILE%\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]

Чтобы узнать больше о запуске базовых скриптов Pywikibot, см.

Список всех скриптов доступных в Руководство:Pywikibot/Скрипты и doc.wikimedia.org/pywikibot.

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

Большинство скриптов не требую дополнительных пакетов, но некоторые могут не заработать без них. Они перечислены в 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.