Manual:Pywikibot/Installation/ru

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

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

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

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

Если у вас уже установлен Python, проверьте его версию, просто набрав в консоли. Если у вас установлен Python $py2 и выше, или Python $py3 или выше, вашей версии будет достаточно. However, Python versions below 3.5 can be dropped in near future. It is strictly recommended to use Python 3.5 or higher.

On Windows please don't forget to modify PATH environment variable to make Python and pip work properly.

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

For Python 2.7 additional packages are mandatory:

Установка Pywikibot
Скачайте Pywikibot stable: .tar.gz, .zip.

Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.

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

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

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

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

Если вы используете выпуск с 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. Смотрите в config2.py список всех параметров, которые вы можете использовать.

Proxy configuration
Pywikibot relies on  for communicating with the web. You can use  and   environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

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

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

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

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

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