Manual:Pywikibot/PAWS/id


 * See PAWS for more details.

Dokumen ini menyajikan gambaran singkat dan interaktif terkait penggunaan Pywikibot dengan menggunakan 'laptop' berprogram 'PAWS' (Pywikibot: A Web Shell atau PAWS) yang diinangkan di lab Wikimedia.

Note PAWS Terminal supports copy and paste in Chromium-based browsers only. If you use a different browser, you will need to manually type the commands mentioned in this walk-through.

Cara pembuatan akun Wikimedia
Untuk bisa mengikuti tata langkah berikut, Anda hanya perlu membuat akun pada salah satu proyek Wikimedia.

Untuk membuat akun Wikimedia, kunjungi laman bantuan Log Masuk. (Hindari penggunaan karakter khusus, hingga T120066 sudah diperbaiki.)

Jika Anda sudah membuat akun, kunjungi https://test.wikipedia.org/ dan perhatikan nama pengguna Anda yang muncul di pojok kanan atas. (Proses ini akan berjalan lancar sesuai T120327).

Masuk ke 'laptop'
To start a hosted notebook, go to https://paws.wmflabs.org/paws

Klik "Sign in with MediaWiki", kemudian klik "Allow" jika diminta untuk persetujuan terkait "Use OAuth for Authentication". (Known bug: any username with non-alphanumeric chars will fail.)

Saat pertama kali mengakses PAWS, Anda diharuskan untuk membuat server. Click the green "My Server" button. It's normal to wait a few minutes for the new server to start up.

Once that is completed, you will be redirected to a URL like https://paws.wmflabs.org/paws/user/ /tree

Memulai terminal
To start a new interactive terminal,
 * 1) Go to your PAWS home
 * 2) click 'New' on the right hand side, and
 * 3) select 'Terminal'.

This will open a new window with the URL https://paws.wmflabs.org/paws/user/ /terminals/1, with a Linux '$' prompt.

Anda bisa memberikan markah buku pada pranala ini dan kembali ke terminal sepanjang saat, bahkan jika Anda telah menutup peramban atau mematikan komputer.

Terminal ini bukanlah emulator. Terminal ini layaknya sebuah bash shell yang merupakan bagian dari dudukan instalasi Linux pada docker container. Jadi, Anda bisa menggunakan perintah bash apapun dan perintah manapun yang tersedia pada sistem operasi Linux yang telah diinstal.

Untuk melihat beberapa perintah yang tersedia, gunakan.

Masuk ke Wiki
Pywikibot membutuhkan sebuah berkas konfigurasi 'user-config.py' yang biasanya dibuat secara otomatis oleh PAWS dengan https://test.wikipedia.org/ sebagai wiki terpilih.

Perintah berikutnya untuk memastikan bahwa Anda dapat masuk ke https://test.wikipedia.org/. Perintah ini menggunakan otorisasi otomatis sehingga Anda tidak perlu memasukkan kata sandi lagi.

Membuat laman
Untuk membuat sebuah laman, masukkan perintah berikut ke terminal, ganti ' ' dengan nama pengguna Anda, lalu tekan 'Y' saat diminta untuk menyetujui perubahan yang Anda lakukan:

Anda sudah berhasil menyunting Wiki. Lihat perubahan yang Anda lakukan dengan membuka https://test.wikipedia.org/wiki/User_talk: pada peramban web Anda.

Anda bisa membaca lebih lanjut tentang jenis-jenis skrip baris perintah dengan mengetik '-help' pada opsi baris perintah.

Penarikan sebuah laman
Penarikan banyak laman dapat dilakukan dengan perintah "listpages".

Untuk bisa mendapatkan konten laman yang sudah Anda buat pada tahap sebelumnya, silakan masukkan perintah berikut:

Now if you go to your PAWS files list, the saved page should be present.

Contoh skrip asli
Saat Lokator Sumber Seragam (URL) dari sebuah alamat web yang ada di Wikipedia berubah, makan pranala akan usang dan menjadi pranala mati jika situs web tidak mengalihkan ke URL baru, misalnya Encyclopedia Britannica (EB) mengubah pranala mereka dari http://www.britannica.com/EBchecked/media/ menjadi http://www.britannica.com/topic/[topic name]/images-videos/*. Anda bisa melihat daftar penggunaan URL lama pada Wikipedia Bahasa Inggris melalui pranala https://en.wikipedia.org/wiki/Special:LinkSearch/http://www.britannica.com/EBchecked/media. Pengubahan semua pranala secara manual tentu saja akan menyita banyak waktu. Untung saja, EB sudah membuat pengalihan dari URL lama ke URL baru, sehingga tidak perlu diperbaiki sesegera mungkin.

Contoh sederhana yaitu Wikipedia Bahasa Inggris saat ini mempunyai pranala berjudul http://britannica.com/EBchecked/ bukannya http://www.britannica.com/EBchecked/. Subdomain 'www.' tidak ada pada URL-nya.

Saat ini ada 14 masalah pada Wikipedia Bahasa Inggris: https://en.wikipedia.org/wiki/Special:LinkSearch/http://britannica.com/EBchecked/

Wikipedia bahasa lainnya juga memiliki masalah yang sama, misalnya saja pada Wikipedia Bahasa Jerman yang memiliki satu masalah: https://de.wikipedia.org/wiki/Spezial:Weblinksuche/http://britannica.com/EBchecked/

Untuk memperbaiki prana ini, kita bisa mempergunakan skrip Pywikibot yaitu replace.py. Pada percobaan ini, kami akan mempergunakan argumen '-simulate' untuk menghindari penulisan langsung ke dalam wiki. Hal ini dikarenakan adanya peraturan tegas terkait penyuntingan otomatis di Wikipedia Bahasa Inggris.

Pertama-tama, mari kita susun daftar semua laman yang terhubung ke http://britannica.com/EBchecked/.

Sekarang kita periksa laman mana saja yang mengandung URL harfiah dalam lamannya, misalnya tidak ditempatkan dalam sebuah templat.

Sekarang gunakan 'replace' untuk menambahkan "www."

Dalam PAWS dan terminal lain yang mendukung tampilan warna, perbedaan revisi akan menampilkan warna hijau pada teks "www." sehingga kita bisa dengan mudah menemukan perubahan yang akan dilakukan.

Program Pywikibot lebih lanjut
Selanjutnya, kita akan mempejalari cara penggunaan sesi Python untuk PAWS.


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

Sebuah jendela baru akan terbuka.

Pada kota teks, masukkan teks berikut dan di menu 'Cell' pilih 'Run' (atau tekan tombol shift+enter untuk menjalakannya).

Kotak teks baru akan muncul seperti di bawah. Kemudian, jalankan teks berikut untuk membuat sebuah objek APISite yang terhubung pada https://test.wikipedia.org/:

Jelaskan "site" dengan memasukkan teks tersebut ke dalam kotak teks kemudian pilih "Run".

Maka akan muncul

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

Buat sebuah objek laman:

Periksa keberadaannya dengan menjalankan:

Maka akan menghasilkan keluaran

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

Tunjukkan teks pada laman:

Ubah teks laman pada objek:

Simpan laman ke dalam wiki:

Respon seharusnya seperti berikut:

'laptop' interaktif Python 3 memungkinkan banyak baris bisa dijalankan secara bersama-sama. Sesi di atas bisa dimasukkan ke dalam satu kotak teks dan dijalankan secara bersamaan.

Log sesi interaktif Python Anda bisa disimpan atau diunduh sebagai acuan di masa mendatang.

Pengaksesan dokumentasi daring pada PAWS
Dokumentasi tentang Pywikibot bisa ditemukan pada https://doc.wikimedia.org/pywikibot/index.html. Laman tersebut merupakan sumber utama dari docstring yang bisa dimuat di dalam 'laptop' interaktif Python 3 memperguna fungsi tertaman Python help.

Contohnya, untuk pencarian argumen metode 'save' seperti di atas, kita bisa menjalankan skrip berikut:

or

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

Skrip bisa diubah dengan menyalinnya ke dalam laman PAWS Anda.

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