Manual:Pywikibot/PAWS/ru

Этот документ обеспечивает быстрый интерактивный обзор Pywikibot с использованием 'блокнота' размещенного в Лаборатории Викимедиа в среде 'PAWS' (Pywikibot Как Веб Сервис) (Pywikibot: веб-оболочка).

Создание пользователя Викимедиа
Для прохождения регистрации вам нужен только аккаунт на Викимедиа.

Для регистрации в Викимедиа, см. Вход страницу помощи. (Избегайте специальных символов в имени пользователя пока не будет устранено замечание T120066.)

После того как вы создали аккаунт, пожалуйста, посетите https://test.wikipedia.org/ и проверьте, что Ваш логин появился в верхнем правом углу (это работает после T120327).

Регистрация в блокноте PAWS
Для запуска блокнота, перейдите на https://tools.wmflabs.org/paws

Нажмите кнопку "Вход в Медивавики" и нажмите кнопку "Разрешить", когда появится запрос "Использовать OAuth для аутенификации".

При Вашем первом входе в PAWS, Вы должны создать сервер.

Как только это будет завершено, Вы будете перенаправлены на URL такого вида https://tools.wmflabs.org/paws/user/ /tree

Запуск терминала
Для запуска нового интерактивного терминала,
 * 1) Перейдите на Домашнюю станицу PAWS
 * 2) Щёлкните 'New' справа, и
 * 3) Выберете 'Terminal'.

При этом откроется новое окно с URL https://tools.wmflabs.org/paws/user/ /terminals/1, с приглашением Linux '$'.

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

Этот терминал-это не эмулятор. Это настоящая оболочка bash, которая является частью Linux установленной в Докер-контейнер, поэтому Вы можете использовать любые команды bash, и любые команды доступные в Linux.

Чтобы увидеть некоторые из доступных команд, используйте.

Вход в вики
Pywikibot необходим конфигурационный файл 'user-config.py' который PAWS автоматически создает для Вас, с настроенной по умолчанию вики https://test.wikipedia.org/.

Следующая команда должна подтвердить, что вы можете войти в https://test.wikipedia.org/. Она использует протокол oauth, поэтому нет необходимости вводить пароль.

Создание страницы
Чтобы создать страницу, введите следующую команду в терминале, заменив '<имя_пользователя>' с вашим именем пользователя, и нажав клавишу "Y", когда будет предложено подтвердить изменения:

После редактирования Вики. Вы можете посмотреть изменения, открыв <в nowiki>https://test.wikipedia.org/wiki/User_talk:<имя пользователя> в вашем браузере.

Вы можете узнать больше о каждом из этих сценариев командной строки с '-help' опции командной строки.

Выборка страниц
Выбор нескольких страниц осуществляется командой "listpages".

Чтобы получить содержимое страницы, которую Вы создали в предыдущем разделе, введите следующую команду:

Теперь если зайти на Список файлов PAWS, там должны присутствовать сохраненные страницы.

Пример скрипта
Когда вебсайт, на который ссылается Википедия меняет URL, ссылки на Википедии становятся устаревшими, а возможно и мертвыми в случае отсутствия перенаправления со старых URL на новые. Как пример, Encyclopedia Britannica (EB) сменила ссылки, переместив страницы с http://www.britannica.com/EBchecked/media/ на http://www.britannica.com/topic/[topic name]/images-videos/*. Вы можете найти список использований старых URL на Английской Википедии по https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Обновление всех ссылок вручную заняло бы много времени. Спасибо EB за перенаправление старых URL на новые, нам не придется исправлять все немедленно.

Простой пример: Английская Википедия содержит ссылки на http://britannica.com/EBchecked/ вместо http://www.britannica.com/EBchecked/ ; то есть в URL пропущен поддомен 'www.'.

В настоящее время существует 14 случаев в английской Википедии: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

В Википедии на других языках тоже есть эта проблема. Например, есть один случай в немецкой Википедии: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

Для того, чтобы исправить эти ссылки, мы можем использовать Pywikibot Manual:Pywikibot/replace.py/replace.py скрипт. В этой демонстрации мы будем использовать '-simulate' аргумент, чтобы не писать в вики, так как существуют строгие правила о автоматическое редактирование в английской Википедии.

Сначала получите список всех страниц которые ссылаются на http://britannica.com/EBchecked/.

Сейчас мы проверяем что эти страницы на самом деле имеют буквенный URL - адрес страницы; т. е. они не используют шаблон.

Теперь используйте replace, чтобы добавить недостающие буквы "www."

В PAWS, и любой терминал, который поддерживает цвет, разница изменений покажет добавленные буквы "www." зеленым цветом, что позволит легче найти предлагаемые изменения.

Внутри Pywikibot
Далее мы будем использовать сессию PAWS Python.


 * 1) Перейдите на Вашу Домашнюю страницу PAWS,
 * 2) Щёлкните 'New' с правой стороны, и
 * 3) Выберете 'Python 3'.

При этом откроется новое окно.

В текстовом поле введите следующее и в ячейке меню выберите "Выполнить(Run)" (или нажмите клавиши Shift+ввод, чтобы запустить).

Новое текстовое поле будет отображаться ниже. Выполните следующую команду для создания APISite объекта подключенного к https://test.wikipedia.org/:

Наберите "site", введя его в новое текстовое поле и выберете "запустить(Run)".

Он должен показать

Out[3]: APISite("test", "wikipedia")

Создайте страницу объекта:

Проверьте её существование, запустив:

Нужно вывести

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

Показать текст на странице:

Изменить текст страницы в объект:

Сохраните страницу в вики:

Ответ должен быть:

Интерактивная "Тетрадь Питон 3" позволяет нескольким строкам выполнятся параллельно. Вышесказанное может быть введено в одно текстовое поле и запущено

Журнал интерактивной Питон сессии могут быть сохранены или загружены в будущем.

Доступ к онлайн документации по PAWS
Документация Pywikibot может быть найдена на https://doc.wikimedia.org/pywikibot/index.html. Она созадется из docstrings, и может быть загружена в интерактивной консоли Python 3 используя встроенные функции Python help.

Например, чтобы посмотреть на аргументы для метода сохранённого выше, либо:

or

Редактирование скрипта Pywikibot
В Pywikibot библиотеки и скрипты находятся в /srv/pwb, и доступны только для чтения. Установленная Pywikibot библиотека не может быть изменен в PAWS.

Скрипты могут быть изменены после их копирования в Домашнюю страницу PASW.

Для запуска изменённого "checkimages.py"
 * 1) В терминале, введите "cp /srv/pwb/scripts/checkimages.py ~"
 * 2) Щёлкните по файлу checkimages.py в Вашей Домашней странице PAWS
 * 3) Исправьте код и сохраните Ваши изменения
 * 4) В терминале, введите "pwb.py ~/checkimages.py -simulate"