Manual:Pywikibot/PAWS/uk


 * Див. PAWS для докладнішої інформації.

Цей документ надає швидкий інтерактивний огляд  із використанням notebook, який розташований у середовищі лабораторій Вікімедіа та використовує PAWS (PAWS: A Web Shell).

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

Щойно Ви створили обліковий запис, будь ласка, відвідайте https://test.wikipedia.org/ та перевірте, що Ваше ім'я користувача з'явилося у верхньому правому кутку (це працює навколо T120327).

If you are a new user on Wikimedia log in with your account on meta.Wikimedia, Wikipedia, Wikidata, and Commons. And in each of them read and delete all pending messages you have (on the top).

Вхід до записника
Для запуску розміщеного записника ідіть до https://paws.wmflabs.org/paws/hub

Натисніть «Увійти за допомогою МедіаВікі», а потім «Дозволяю», коли попросять схвалити «Використовувати OAuth для автентифікації». Під час першого доступу до PAWS Вам необхідно створити сервер. Натисніть зелену кнопку «Запустити мій Сервер». Нормально почекати кілька хвилин, поки новий сервер запуститься.

Щойно це завершиться, Вас буде переспрямовано до URL на кшталт https://paws.wmflabs.org/paws/user/ /tree

Запуск терміналу
Для запуску нового інтерактивного терміналу,
 * 1) Ідіть до свого дому PAWS
 * 2) натисніть «Новий» праворуч, і
 * 3) виберіть «Термінал».

Це відкриє нове вікно з URL https://paws.wmflabs.org/paws/user/ /terminals/1 та запитом Linux «$».

Ви можете зберегти в закладки цей URL і повернутися до терміналу будь-коли, навіть після закриття Вашого браузера чи завершення роботи комп'ютера.

Цей термінал не є емулятором. Це справжня оболонка bash як частина справжньої інсталяції Linux, яка сидить на докерному контейнері, то ж Ви можете використовувати будь-яку команду bash і використовувати будь-які команди, доступні на Linux, які було встановлено.

Щоб побачити деякі доступні команди, використовуйте.

Вхід до Вікіпедії
Це встановить Ваш обліковий запис на сервері та дозволить Вам входити з командного рядка. Наступна команда повинна підтвердити, що Ви входите до тестової Вікіпедії. Вона використовує OAuth, то ж немає необхідності вводити пароль.

Ви можете під'єднати pywikibot до різних Вікіпедій шляхом створення файлу під назвою user-config.py у своїй папці   та додавання змінних mylang і family:

Створення сторінки
Для створення сторінки введіть наступну команду в терміналі, замінивши ' ' своїм іменем користувача та натиснувши 'Y' при запиті на підтвердження Ваших змін:

Ви відредагували Вікіпедію. Перегляньте свої зміни відкриттям https://test.wikipedia.org/wiki/User_talk: у своєму веб-браузері.

Ви можете прочитати більше про кожен із цих сценаріїв командного рядка за допомогою опції '-help' командного рядка.

Завантаження сторінки
Завантаження багатьох сторінок досягається командою «listpages».

Для отримання вмісту створеної Вами сторінки в попередньому розділі введіть наступну команду:

Тепер, якщо Ви підете до свого списку файлів PAWS, збережена сторінка повинна існувати.

Приклад реального сценарію
When a website used on Wikipedia changes its URL, the links on Wikipedia become outdated, and possible also dead links if the website doesn't redirect from the old URLs to the new URLs. For example, Encyclopedia Britannica (EB) has changed their links, such as moving pages from http://www.britannica.com/EBchecked/media/ to http://www.britannica.com/topic/[topic name]/images-videos/*. You can find the list of usages of the old URL on English Wikipedia at w:Special:LinkSearch/http://www.britannica.com/EBchecked/media. Updating all those links manually will be very time consuming. Thankfully EB has maintained redirects from their old URLs to the new URLs, so this does not need to be fixed immediately.

Для простішого прикладу Англійська Вікіпедія наразі містить посилання до http://britannica.com/EBchecked/ замість http://www.britannica.com/EBchecked/ ; тобто піддомен «www.» відсутній у цьому URL.

Наразі існує 14 cases в Англійській Вікіпедії: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Вікіпедія іншою мовою також має цю проблему. Наприклад, один case в Німецькій Вікіпедії: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

In order to fix those links, we can use Pywikibot replace.py script. In this demo we will use the '-simulate' argument to avoid writing to the wiki, as there are strict rules about automated editing of English Wikipedia.

Спочатку давайте перелічимо всі сторінки, що посилаються на http://britannica.com/EBchecked/.

Тепер ми перевіримо ті сторінки, що дійсно мають літерал URL на сторінці, тобто вони не використовують шаблон.

Тепер використаємо заміну для додавання пропущеного «www.»

У PAWS і будь-якому терміналі з підтримкою кольору різниця змін показуватиме додавання «www.» зеленим кольором тексту, спрощуючи пошук пропонованих змін.

Всередині Pywikibot
Далі ми використовуватимемо сеанс PAWS Python.


 * 1) Ідіть до свого дому PAWS,
 * 2) натисніть «Новий» праворуч, і
 * 3) виберіть «Python 3».

Це відкриє нове вікно.

У текстовому полі введіть наступне та в меню Комірка виберіть «Запуск» (або натисніть Shift+Enter для запуску).

Нове текстове вікно з'явиться нижче. Запустіть наступне для створення об'єкту APISite, підключеного до https://test.wikipedia.org/:

Опишіть «сайт» введенням його в нове текстове вікно та виберіть «Запуск».

Повинно показатися

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.

For example, to run a modified "checkimages.py":


 * 1) In the terminal, enter
 * 2) In a browser, go to your PAWS home and click on the file.
 * 3) In the browser, you can edit the file. Edit the code -- for instance, just after the   code on line 1775, add a new line 1776 that will print out your name:
 * 4) In the editing interface, use the File menu and click Save to save your modifications.
 * 5) In the terminal, enter

Див. також

 * PAWS cheatsheet одного користувача (наприклад, про API та доступ до баз даних)
 * Jupyter notebooks user guide
 * Source code on GitHub