Bantuan:Bot

Ini adalah tutorial sederhana tentang cara membuat dan menjalankan pywikipediabot, yaitu 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:Pywikipediabot. 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 :D

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 pywikipediabot. Ekstrak ke "C:\pywikipedia"

3. Buat berkas teks baru bernama "user-config.py" di folder tersebut. Isi dengan

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

4. Unduh python untuk menjalankan program ini. Instal program ini.

5. Coba jalankan pywikipedia dengan mengetik "login.py". Jika tidak ada pesan galat, maka Anda sudah berhasil memasang pywikipedia 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 sini, lalu set path ke folder instalasi Python Anda (misalnya ";C:\Python27\")

Langkah-langkah menjalankan

Pywikipediabot terdiri dari 115 program. Yang dimaksud 1 program adalah setiap berkas dengan ekstensi ".py". Yang dimaksud "menjalankan" program adalah mengetik nama program tersebut, misalnya "login.py". Untuk menjalankan program pywikipediabot 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.

1. Log masuk dengan bot Anda. Jika Anda sudah membuat user_config.py dengan betul, tinggal ketik "login.py", 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 "capitalize_redirects.py". Ketikkan "capitalize_redirects.py -start:A", 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 "capitalize_redirects.py -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 pywikipediabot 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: akan segera obsolete 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. Sebenarnya dapat dikategorikan sebagai Aman, namun karena suatu hal, LaninBot sudah siaga 24/7 untuk hal ini, sehingga tidak diperlukan lagi bot yang lain, termasuk pengguna, untuk menyapa 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.

Lihat pula

• (Inggris) meta:Bot dan mw:Manual:Pywikipediabot - tutorial yang lebih detil dan teknis, dalam bahasa Inggris
• (Inggris) en:Wikipedia:Creating a bot - tutorial di Wikipedia bahasa Inggris
• (Inggris) DotNetWikiBot Framework (Microsoft .NET)