Manual:Pywikibot/Pemasangan
Berikut adalah panduan untuk membantu Anda memulai memasang dan menjalankan Pywikibot pada komputer Anda sendiri. Ada empat langkah utama untuk proses ini:
Menginstal Python
Mengunduh dan menginstal Python dari https://www.python.org/downloads/.
Make absolutely certain that you check the box at the bottom of the install wizard asking if you want to add Python to PATH!
That will allow you to access Python from any command prompt just by typing the keyword python.
Jika Anda sudah menginstal Python, periksa apakah versi yang Anda miliki tersebut adalah versi terkini dengan menjalankan python --version di sebuah konsol.
Untuk mengetahui apakah Python versi 3 atau lebih tinggi diinstal, jalankan python3 --version di konsol.
Ubuntu 19.04 dan lebih datang dengan versi 2 & 3 dipasang.
Python v2 berjalan secara default menggunakan perintah terminal python; untuk menggunakan v3, gunakan perintah terminal python3.
Python 3.7 or higher is currently required to run the bot, but Python 3.8 or higher is recommended. Di Windows, jangan lupa untuk memodifikasi PATH lingkungan variabel untuk membuat Python dan pip bekerja dengan benar.
Instal dependensi
Paket tambahan diperlukan untuk menjalankan Pywikibot. Lakukan perintah berikut untuk menginstal paket ini:
$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging
Untuk Python 3.7 dibutuhkan paket tambahan. Instal dengan:
$ python -m pip install importlib_metadata
Sebuah pemindai markup MediaWiki alternatif dapat dipasang dengan:
$ python -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Menginstal Pywikibot
$ python -m pip install pywikibot
Jika menggunakan pip, gunakan pwb bukan python pwb.py dalam contoh di bawah ini.
Unduh cabang PYWIKIBOT stable saat ini: .tar.gz, .zip.
Buka berkas yang telah diunduh, misalnya di ~/pywikibot atau %USERPROFILE%\pywikibot.
Sebagai alternatif, Anda dapat mengambil versi terbaru menggunakan klien git atau svn dari Gerrit, lihat Manual:Pywikibot/Gerrit#For users. Ini adalah cara yang disarankan untuk operator bot yang aktif dan para pengembang untuk menggunakan Pywikibot.
Versi lainnya tersedia di https://pywikibot.toolforge.org/.
Memperbarui Pywikibot
Buat kerangka bot Anda tetap terbaru. Versi baru dirilis secara terus menerus, dan tersedia di lokasi yang sama.
Jika Anda menggunakan versi dari git atau svn, Anda dapat melompati catatan ini. Jika tidak, harap perhatikan kebutuhan untuk mencadangkan berkas konfigurasi dan skrip Anda (user-config.py, berkas keluarga apa pun, atau skrip khusus yang mungkin Anda buat atau ubah, dan berkas dump XML apa pun yang saat ini Anda gunakan untuk wiki) sebelum menginstal versi terbaru.
Keluarkan versi baru dari versi lama, timpa semua file.
Mengonfigurasi Pywikibot
Buka Terminal pada Unix-like (Linux/BSD/Solaris) atau Command Prompt pada Windows (biasanya berada di folder Windows System atau Aksesoris di Semua aplikasi atau pada menu Semua program di dalam menu Start), dan ubah direktori ke tempat Anda mengekstrak Pywikibot:
- Unix-like (Linux/BSD/Solaris):
$ cd ~/core
- Windows:
$ c: $ cd "%USERPROFILE%\pywikibot"
Tentu saja Anda harus mengganti lokasi ke tempat Anda mengekstrak Pywikibot.
Lanjutkan dengan perintah berikut untuk membuat berkas konfigurasi pengguna:
$ python pwb.py generate_user_files
Ikuti petunjuk untuk mengonfigurasi Pywikibot.
Terakhir jalankan perintah berikut untuk masuk ke wiki Anda:
$ python pwb.py login
Penggunaan pada wiki pihak ketiga
Pywikibot sudah dikonfigurasi untuk sejumlah besar jenis wiki, tetapi mungkin saja tidak untuk yang ingin Anda kerjakan. Lihat Manual:Pywikibot/Use on third-party wikis perihal bagaimana cara mengonfigurasi Pywikibot untuk wiki Anda.
Opsi konfigurasi lainnya
Pywikibot menyediakan berbagai opsi konfigurasi untuk mengubah perilaku bot Anda. Anda dapat mengubah pengaturan ini dalam berkas user-config.py. Lihat config.py untuk daftar mengenai semua parameter yang bisa Anda gunakan.
Konfigurasi proksi
Pywikibot bergantung pada requests untuk berkomunikasi dengan web.
Anda bisa menggunakan variabel lingkungan HTTP_PROXY dan HTTPS_PROXY untuk membuat permintaan ke peladen proksi.
Baca dokumentasi permintaan untuk lebih banyak info.
Jalankan sebuah skrip
Pywikibot hadir dan telah dikemas dengan sejumlah besar skrip di direktori skrip. Anda dapat menjalankan semua ini menggunakan:
$ python pwb.py [name of the script]
Untuk mempelajari lebih lanjut tentang menjalankan skrip Pywikibot dasar, lihat:
- Lokakarya alat wiki kecil tentang menjalankan skrip dasar Pywikibot
- Materi belajar mandiri berdasarkan lokakarya perangkat wiki kecil
- Buku panduan workshop berdasarkan workshop kit alat wiki kecil
Daftar semua skrip tersedia dengan harga Manual:Pywikibot/Scripts dan doc.wikimedia.org/pywikibot.
Dependensi lainnya
Kebanyakan skrip tidak memerlukan paket tambahan, tetapi beberapa di antaranya tidak akan berfungsi tanpa hal tersebut. Ini dicantumkan dalam requirements.txt bersama dengan faktor ketergantungan mereka.
Untuk menginstal dependensi demi beberapa skrip, gunakan pip, dan jalankan perintah berikut:
$ python -m pip install [name of the package]
Sebagai alternatif, jalankan perintah berikut untuk menginstal semua dependensi untuk semua skrip sekaligus:
$ python -m pip install -r requirements.txt
- If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel connect or pywikibot@ mailing list.