Руководство:Pywikibot/Установка
Это руководство позволит вам установить и запустить Pywikibot на своём компьютере. Оно состоит из 4-х основных шагов:
Установка 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, but Python 3.8 or higher is recommended. При работе в 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.