Jump to content

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

From mediawiki.org
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/. Make absolutely certain that you check the box at the bottom of the install wizard asking if you want to add Python to PATH! That will allow you to access Python from any command prompt just by typing the keyword python.

Если у вас уже установлен 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.