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

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 90% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
Эта страница поможет вам начать работу с Pywikibot, либо на вашем собственном компьютере, в Toolforge, либо используя Pywikibot: A Web Shell (PAWS).
On PAWS
Unicorn paw logo.svg

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

На ваш компьютер
Computer n screen.svg

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

Toolforge logo.svg

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

Установка Python

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

Если у вас уже установлен Python, проверьте его версию, просто набрав в консоли python --version. Если у вас установлен Python 2.7.4 и выше, или Python 3.4 или выше, вашей версии будет достаточно. 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 или выше. Используйте нижеприведённые команды для установки этого пакета:

$ pip install requests

Установка Pywikibot

Скачайте Pywikibot stable branch: .tar.gz, .zip.

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

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

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

Обновление

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

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

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

Настройка Pywikibot

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

Unix-подобные системы (Linux/BSD/Solaris):
$ cd ~/pywikibot
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. Смотрите в config2.py список всех параметров, которые вы можете использовать.

Proxy configuration

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

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

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

$ python pwb.py [name of the script]

Список всех скриптов доступных в Manual:Pywikibot/Scripts .

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

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

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

$ pip install [name of the package]

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

$ pip install -r requirements.txt


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