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:
 |
| Pywikibot |
|---|
|
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 python3.
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.
Saat ini persyaratan menjalankan bot ini adalah {{$1|Python 3.9 atau lebih tinggi}}, namun direkomendasikan Python 3.10 atau lebih tinggi.
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:
python3 -m pip install "requests>=2.20.1"
python3 -m pip install "mwparserfromhell>=0.5.2"
python3 -m pip install packaging
Untuk Python 3.7 dibutuhkan paket tambahan. Instal dengan:
python3 -m pip install importlib_metadata
Sebuah pemindai markup MediaWiki alternatif dapat dipasang dengan:
python3 -m pip install "wikitextparser>=0.47.5"
See also https://doc.wikimedia.org/pywikibot/stable/introduction.html#quick-start
Menginstal Pywikibot
Recommended
python3 -m pip install pywikibot
Jika menggunakan pip, gunakan pwb alih-alih python3 pwb.py dalam contoh di bawah ini.
Alternatives
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 dari Gerrit, lihat Manual:Pywikibot/Gerrit#For users. This is the recommended way for active bot operators and developers to use 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 rilis dari git, Anda dapat melewatkan catatan ini. Otherwise please be aware of a necessity to backup your configuration files and scripts (user-config.py, any family file, or custom script that you might have created or changed, and any current XML dump file you're using for a wiki) before installing a new release.
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 (prompt perintah, bukan PowerShell):
c: cd "%USERPROFILE%\pywikibot"
Tentu saja Anda harus mengganti lokasi ke tempat Anda mengekstrak Pywikibot.
Lanjutkan dengan perintah berikut untuk membuat berkas konfigurasi pengguna:
python3 pwb.py generate_user_files
Ikuti petunjuk untuk mengonfigurasi Pywikibot. Anda perlu membuat kata sandi
Terakhir jalankan perintah berikut untuk masuk ke wiki Anda:
python3 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.
Lihat request' dokumentasi untuk info lebih lanjut.
Jalankan sebuah skrip
Pywikibot hadir dan telah dikemas dengan sejumlah besar skrip di direktori skrip. Anda dapat menjalankan semua ini menggunakan:
python3 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/Skrip 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 dependensinya.
Untuk menginstal dependensi demi beberapa skrip, gunakan pip, dan jalankan perintah berikut:
python3 -m pip install [name of the package]
Sebagai alternatif, jalankan perintah berikut untuk menginstal semua dependensi untuk semua skrip sekaligus:
python3 -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.