Manual:Pywikibot/Installation/ru

  Эта страница поможет вам начать работу с Pywikibot, либо на вашем собственном компьютере, в Toolforge, либо используя Pywikibot: A Web Shell (PAWS).

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

 На ваш компьютер Это руководство позволит вам установить и запустить Pywikibot на своём компьютере. Оно состоит из 4-х основных шагов:  На Toolforge Toolforge обеспечит вас стабильной облачной инфраструктурой на серверах Викимедиа, допускающей работу ботов непрерывно или по расписанию.
 * Установка Python
 * Установка Pywikibot
 * Настройка Pywikibot
 * Запуск скриптов



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

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

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

Если у вас установлен, вашей версии будет достаточно.

При работе в Windows не забудьте отредактировать переменную среды PATH для корректной работы Python и pip.



Установка зависимостей
Дополнительный пакет, называёмый requests необходим для запуска Pywikibot. Используйте pip, который по умолчанию включен во все поддерживаемые версии Python. Используйте нижеприведённые команды для установки этого пакета:

In addition a MediaWiki markup parser is required. Please install (at least) one of the following (or both):



Установка Pywikibot
If using pip, use  instead of   in examples below.

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

Распакуйте эти файлы, например в  или.

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

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



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

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

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



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


 * Unix-подобные системы (Linux/BSD/Solaris):




 * Windows:



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

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

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

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



Использование в частном вики-проекте
Pywikibot уже предварительно настроен для большого количества вики-сайтов, но, возможно, не для того, с которым вы хотите работать. Смотрите для настройки Pywikibot для вашей вики.



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



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



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

To learn more about running basic Pywikibot scripts, see:
 * Small wiki toolkits workshop about running basic Pywikibot scripts

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



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

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

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