Руководство:Pywikibot/Установка
Это руководство позволит вам установить и запустить Pywikibot на своём компьютере. Оно состоит из 4-х основных шагов:
Установка 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
- Материалы для самообучения на основе семинара по небольшим вики-инструментам
- Руководство для семинара, на основе основе семинара по небольшим вики-инструментам
Список всех скриптов доступных в Руководство: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.