Manual:Pywikibot/PAWS/ru


 * See PAWS for more details.

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

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

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

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

Нажмите кнопку "Вход в Медивавики" и нажмите кнопку "Разрешить", когда появится запрос "Использовать OAuth для аутенификации". При Вашем первом входе в PAWS, Вы должны создать сервер. Click the green "Start my Server" button. It's normal to wait a few minutes for the new server to start up.

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

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

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

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

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

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

Login to the wiki
This will establish your account on the server and allow you to log in from the command line. Следующая команда должна подтвердить, что вы можете войти в https://test.wikipedia.org/. Она использует протокол oauth, поэтому нет необходимости вводить пароль.

You can connect pywikibot to a different wiki by creating a file named user-config.py in your  directory  and adding mylang and family variables:

Создание страницы
Чтобы создать страницу, введите следующую команду в терминале, заменив '<имя_пользователя>' с вашим именем пользователя, и нажав клавишу "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/paws, и доступны только для чтения. Установленная Pywikibot библиотека не может быть изменен в PAWS.

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

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