Lihat sumber Bantuan:Bot

{{update}}
{{Templat:Bantuan:Bantuan/seri tab}}
{{Templat:Bantuan:Bantuan/sidebar}}
Ini adalah tutorial sederhana tentang cara membuat dan menjalankan [[mw:Manual:Pywikibot/id|pywikibot]], yaitu kerangka kerja (''framework'') {{WP|bot}} yang paling banyak digunakan di proyek-proyek Wikimedia.

== Asumsi dasar ==
Tutorial ini akan mengasumsikan Anda mengetahui hal-hal di bawah ini, atau paling tidak dapat membacanya sendiri di [[mw:Manual:Pywikibot/id]]. Bila Anda kesulitan di bagian ini, dianjurkan Anda mencari pengguna lain yang sudah berpengalaman dengan bot, dan bertanya secara lebih mendetil. Asumsi dasar:
* Anda tahu apa itu bot, terutama bot Wikipedia
* Anda tahu kegunaan bot dan apa yang seharusnya tidak dilakukan dengan bot (mis. vandal)
* Anda tahu risiko, kewajiban, dan tanggung jawab operator bot
* Anda tahu minimal sedikit pemrograman komputer
* Anda tahu bahwa pembuat ini tidak bertanggung jawab atas apa pun yang terjadi atas komputer Anda selama Anda mempelajari tutorial ini

Beberapa asumsi lain:
* Anda menggunakan komputer standar, misalnya Windows, atau Linux. <!-- Untuk hematnya, ''tutorial di bawah mengasumsikan Anda menggunakan Windows.''-->
* Anda menggunakannya untuk menyunting Wikipedia bahasa Indonesia.

== Langkah-langkah ==
Langkah-langkah ini tidak dimaksudkan untuk komprehensif, melainkan hanya checklist. Apabila Anda telah berpengalaman dalam membuat dan menjalankan bot, silakan mengembangkan bagian ini, tetapi tidak perlu sampai terlalu detil (bisa dijelaskan secara lebih mendetil di subhalaman).

=== Langkah-langkah memasang ===
1. '''Membuat akun untuk bot Anda.''' Untuk awalnya Anda tidak perlu mendaftarkan dulu di [[Wikipedia:Bot/Permohonan]]. Setelah Anda bisa menjalankannya, baru bot itu perlu didaftarkan.

2. '''Unduh [http://pywiki-indonesia.club/nightly/package/pywikipedia/pywikipedia-nightly.zip pywikipediabot].''' Ekstrak ke "C:\pywikipedia"

3. '''Buat berkas teks baru bernama "user-config.py"''' di folder tersebut. Isi dengan
<pre>
mylang = 'id'
family = 'wikipedia'
usernames['wikipedia']['id'] = 'namaBotAnda'
console_encoding = 'utf-8'
#use_api = True #opsional, hilangkan tanda pagar di depan
#cosmetic_changes = True #opsional, hilangkan tanda pagar di depan
</pre>
* Cara lain: jalankan ''generate_user_files.py'' dan masukan input sesuai perintah yang diberikan.
4. '''Unduh [http://www.python.org/download/ python]''' untuk menjalankan program ini.''' Instal program ini.

:'''Catatan (Linux)''': jika Anda menggunakan sistem operasi Linux, [[Python (bahasa pemrograman)|python]] biasanya tersedia sebagai paket yang bisa diinstall dengan perangkat lunak manager paket sesuai distribusi linux yang Anda gunakan, misalnya apt untuk distribusi berbasis debian (ubuntu, mint,dll.), atau dnf jika menggunakan [[Fedora]] atau [[CentOS]].

5. '''Coba jalankan pywikibot dengan mengetik''': <code>pwb.py login.py</code>. Jika tidak ada pesan galat, maka Anda sudah berhasil memasang pywikibot dan siap untuk menjalankannya.

* Jika ada masalah dengan langkah terakhir, mungkin Anda perlu mengeset path ke folder instalasi Python Anda. Tergantung sistem operasi Windows Anda, silakan baca tutorialnya di [http://www.mathworks.com/support/solutions/en/data/1-15ZLK/index.html sini], lalu set path ke folder instalasi Python Anda (misalnya ";C:\Python27\")

=== Langkah-langkah menjalankan ===
Pywikibot terdiri dari 115 program. Yang dimaksud 1 program adalah setiap berkas dengan ekstensi ".py" yang terdapat di direktori <code>$Home/pywikibot/scripts/</code> (di Linux). Yang dimaksud "menjalankan" program adalah mengetik nama program tersebut, misalnya "login.py". Untuk menjalankan program pywikibot di Windows, Anda perlu masuk ke [[Command line]]. Salah satu cara paling cepat adalah klik tombol "Start", lalu ketik "cmd". Cara lainnya adalah klik tombol "Win+R", lalu ketik "cmd". '''Anda harus berada di folder pywikipediabot untuk menjalankan programnya'''. Misalnya Anda meng-ekstrak pywikipediabot di "C:\pywikipediabot", maka pertama-tama yang harus Anda lakukan adalah mengetik "cd c:\pywikipediabot" (atau folder apa pun yang Anda gunakan untuk pywikipediabot) di Command line. Semua langkah di bawah ini mengasumsikan hal-hal tersebut.
:'''Linux''': pywikibot secara baku tidak menyediakan antarmuka grafis, Anda harus menjalankan semua perintah melalui terminal.
:1. '''Log masuk dengan bot Anda'''. Jika Anda sudah membuat user_config.py dengan benar, tinggal ketik "pwb.py login", kemudian masukkan kata sandi bot Anda. Sekarang Anda sudah masuk log sebagai robot. Mungkin sekarang saat yang tepat untuk meminta status robot.

:2. Apabila belum, '''lakukan suntingan percobaan''', misalnya salah satu program yang cukup "aman" digunakan untuk percobaan adalah <code>capitalize_redirects.py</code>. Ketikkan <code>pwb.py capitalize_redirects -start:A</code>, Enter, lalu apabila muncul pertanyaan, ketik Y. jika muncul pertanyaan selanjutnya, ketik "Ctrl+C". Kemudian lihat kontribusi robot Anda, apabila kontribusinya sudah tercatat, berarti percobaan Anda berhasil.

:3. Sekarang Anda bisa menjalankan program yang Anda pilih. Ada 115 pilihan, dan masing-masing program memiliki fungsi dan keistimewaan masing-masing. '''Untuk bantuan masing-masing program, ketik "-help" tepat setelah mengetik nama program''', misalnya "pwb.py capitalize_redirects -help"

:4. Ingat, jalankan bot Anda dengan hati-hati dan '''tidak melakukan penyuntingan yang drastis''', seperti menambahkan artikel dalam jumlah banyak tanpa persetujuan komunitas. Bila bot Anda bertindak sembrono, tidak tertutup kemungkinan bot Anda akan diblokir, bahkan Anda sebagai operator bot juga bisa mendapat sanksi.

:5. '''Banyaklah bertanya''' bagaimana cara operator bot lain menjalankan bot mereka. Karena masing-masing program memiliki keunikan tersendiri, dibutuhkan waktu lama untuk menguasai seluruhnya, walaupun biasanya operator bot hanya berkonsentrasi di beberapa program tertentu saja.

== Daftar program pywikibot yang umum ==

Berikut ini daftar program yang umum dijalankan, dan kriteria / komentar tentang masing-masing program:

=== Aman ===
Yang masuk kriteria ini adalah program-program yang dapat dijalankan oleh operator yang baru, dengan risiko yang sangat kecil bagi proyek. Bot dapat dijalankan tanpa henti (komputer dalam posisi terus menyala) untuk program-program di bawah ini tanpa masalah berarti.
* capitalize_redirects.py – sangat berguna untuk menambah jumlah "halaman" di Wikipedia, sekaligus "suntingan", sehingga "depth" akan naik.
** bot yang pernah/sering menjalankan ini: OrophinBot, <tambahkan>
** perintah umum: "capitalize_redirects.py -start:! -always" (start dapat dimulai dari sembarang huruf/kata, misal ketika koneksi terputus di tengah-tengah huruf "B", dapat mulai lagi dari artikel terakhir yang disunting, misalnya "-start:Bali")
* redirect.py – berguna untuk membetulkan pengalihan ganda
** bot yang pernah/sering menjalankan ini: banyak
** perintah umum: "redirect.py double"
* interwiki.py – berguna untuk menambah/memperbaiki interwiki. '''Catatan:''' tidak diperlukan lagi karena kehadiran [[Wikidata]]
* checkimages.py – berguna untuk mengecek berkas-berkas yang terakhir dimuat
* clean_sandbox.py – berguna untuk mereset bak pasir secara otomatis

=== Butuh pengawasan ===
* welcome.py – berguna untuk menyambut pengguna baru.
* cosmetic_changes.py – sangat luas kegunaannya. Harus berpengalaman dulu minimal dalam menjalankan program-program yang lain sebelum menjalankan ini.
* replace.py – sangat luas kegunaannya, di WBI sering digunakan antara lain untuk melakukan standardisasi ejaan bahasa Indonesia
** bot yang pernah menjalankan ini: banyak
** perintah umum: "replace.py "<kata1>" "<kata2>""
* category.py – kegunaannya bermacam-macam, berhubungan dengan kategori
** bot yang pernah menjalankan ini: banyak, OrophinBot, TjBot, Borgxbot, dll.
** perintah umum: "category.py move -from:<kategori1> -to:<kategori2>"
* pagefromfile.py – berguna untuk menambah artikel dari sebuah berkas teks.
** bot yang pernah menjalankan ini: LaninBot, TjBot, PepenxBot
** karena tidak sembarang operator bot boleh melakukan hal ini, maka cara menjalankannya silakan ditanyakan langsung ke operator bot yang bersangkutan.
== Catatan ==
Jika Anda menggunakan sistem operasi berbasis [[Linux]], Anda mungkin perlu menambahkan <code>python</code> disetiap awal perintah misalnya <code>python pwb.py login</code> (dengan asumsi Anda berada di direktori dimana pywikibot berada).

== Lihat pula ==
* {{id}} [[meta:Bot/id]] dan {{id}} [[mw:Manual:Pywikibot/id]] – tutorial yang lebih detil dan teknis.
* {{en}} [[:en:Wikipedia:Creating a bot]] – tutorial di Wikipedia bahasa Inggris
* {{en}} [http://dotnetwikibot.sourceforge.net/ DotNetWikiBot Framework (Microsoft .NET)]
{{Navbox Gabungan Pedoman WBI}}
[[Category:Bot]]