Manual:Pywikibot/PAWS/ru

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

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

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

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

Регистрация в тетради
Для запуска блокнота, перейдите на 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, там должны присутствовать сохраненные страницы.

Пример скрипта
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. e.g. 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 https://en.wikipedia.org/wiki/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.

For a simpler example, English Wikipedia currently contains links to http://britannica.com/EBchecked/ instead of http://www.britannica.com/EBchecked/ ; i.e. a 'www.' subdomain is missing in the URL.

There are currently 14 cases on English Wikipedia: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia in other language also have this problem. e.g. there is one case on German Wikipedia: 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.

First lets list all of the pages which link to http://britannica.com/EBchecked/.

Now we check those pages actually have the literal URL in the page; i.e. they are not using a template.

Now use replace to add the missing "www."

In PAWS, and any terminal that supports color, the diff of changes will show the added "www." in green text color, making it easier to find the proposed changes.

Inside Pywikibot
Next we will use the PAWS Python session.


 * 1) Go to your PAWS home,
 * 2) click 'New' on the right hand side, and
 * 3) select 'Python 3'.

This will open a new window.

In the text box, enter the following and in the Cell menu select 'Run' (or pressing shift+enter to run).

A new text box will appear below. Run the following to create an APISite object connected to https://test.wikipedia.org/:

Describe "site" by entering it into the new text box and selecting "Run".

It should show

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

Create a page object:

Check it exists by running:

It should output

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

Show the text on the page:

Change the page text in the object:

Save the page to the wiki:

The response should be:

The interactive Python 3 notebook allows many lines to be run together. The above could be put into one text box and Run

The log of your interactive Python session can be saved or downloaded for future reference.

Accessing online documentation in PAWS
Pywikibot documentation may be found at https://doc.wikimedia.org/pywikibot/index.html. It is primarily sourced from docstrings, which can be loaded in the interactive Python 3 notebook using the Python built-in function help.

For example, to look at the arguments for the save method above, run either:

or

Editing Pywikibot scripts
The Pywikibot library and scripts are located in /srv/pwb, and are read-only. The installed Pywikibot library can not be modified in PAWS.

Scripts may be modified after copying them into your PAWS home.

To run a modified "checkimages.py"
 * 1) In the terminal, enter "cp /srv/pwb/scripts/checkimages.py ~"
 * 2) Click on the file checkimages.py in your PAWS home
 * 3) Edit the code and save your modifications
 * 4) In the terminal, enter "pwb.py ~/checkimages.py -simulate"