Manual:Pywikibot/PAWS/ru


 * См. PAWS для более детальной информации.

Этот документ обеспечивает быстрый интерактивный обзор  с использованием блокнота, размещённого в среде облачных сервисов Викимедиа, использующих PAWS (Pywikibot A Web Shell).



Создание учётной запись Викимедиа
Для прохождения регистрации вам нужен только аккаунт Википедии/Викимедии. Если его нет, тогда для создания новой глобальной учётной записи можно использовать Special:CreateAccount.

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

Если вы только что зарегистрировались как новый пользователь Викимедиа, обязательно войдите в свою учётную запись через Мета-Вики, Википедию, Викиданные и Викисклад (или перейдите через внутренние ссылки на родственные проекты). В каждом из проектов прочитайте и удалите все отложенные сообщения для вас (сверху).



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

Нажмите кнопку «Sign in with MediaWikiи» (вход через Викимедия) и нажмите кнопку «Разрешить», когда появится запрос о полномочиях. При Вашем первом входе в PAWS, Вы должны создать сервер. Нажмите на зелёную кнопку с надписью «Запустить мой сервер». Вполне нормально подождать несколько минут для запуска сервера.

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



Запуск терминала
Для запуска нового интерактивного терминала,
 * 1) Перейдите на Домашнюю станицу PAWS
 * 2) # щёлкните Файл > Новый > Терминал

При этом откроется новое окно с приглашением Linux '$'.

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

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

To see them all, press TAB twice.



Вход в вики
Это установит ваш аккаунт на сервере и позволит вам войти в систему из командной строки. Следующая команда должна подтвердить, что вы можете войти в testwiki. Она использует технологию OAuth, поэтому нет нужды вводить пароль.

Вы можете присоединить pywikibot к другой вики, создав файл, названный user-config.py в своей директории   и добавляя переменные mylang и family:



Создание страницы
Чтобы создать страницу, введите следующую команду в терминале, заменив '&lt;username>' с вашим именем пользователя, и нажав клавишу «Y», когда будет предложено подтвердить изменения:

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

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



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

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

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



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

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

В настоящее время существует 14 возможных случаев в английской Википедии: w:Special:LinkSearch/http://britannica.com/EBchecked/

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

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

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

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

Теперь используйте замену, чтобы добавить недостающие буквы «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

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

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

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

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

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

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



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

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

или



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

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

Для запуска изменённого «checkimages.py»:


 * 1) Введите в терминале « »
 * 2) В браузере перейдите к [$paws Домашней странице PAWS] и нажмите на файл.
 * 3) В браузере вы можете редактировать файл. Отредактируйте код — например, сразу после кода   в строке 1775 добавьте новую строку 1776, в которой будет напечатано ваше имя:
 * 4) В интерфейсе редактирования используйте меню «File» и нажмите «Save», чтобы сохранить изменения.
 * 5) Введите в терминале   (If no '-limit:x' defined, the program would run until all images checked, it may take long time.)



См. также

 * PAWS/PAWS and Pywikibot
 * Using Pywikibot with PAWS notebook based tutorial - A tutorial that helps users get started with using Pywikibot and PAWS
 * Example notebooks using Pywikibot - A list of notebooks hosted on PAWS that use Pywikibot
 * Шпаргалка по PAWS от одного пользователя (например, об API и доступе к базе данных)
 * Source code on GitHub
 * Small wiki toolkits workshop about running basic Pywikibot scripts