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 python.
Jika Anda sudah menginstal Python, periksa apakah versi yang Anda miliki tersebut adalah versi terkini dengan menjalankan python --version di sebuah konsol.
To discover if Python version 3 or above is installed, run python3 --version in a console.
Ubuntu 19.04 and up comes with versions 2 & 3 installed.
Python v2 runs by default using terminal command python; to use v3, use terminal command python3.
Python 3.7 or higher is currently required to run the bot. Di Windows, jangan lupa untuk mengubah variabel lingkungan PATH agar Python dan pip bekerja dengan benar.
Dependensi instal
Additional packages are required to run Pywikibot. Run the following command to install these packages:
$ python -m pip install "requests>=2.20.1"
$ python -m pip install "mwparserfromhell>=0.5.2"
$ python -m pip install packaging
For Python 3.7 an additional package is required. Install it with:
$ python -m pip install importlib_metadata
An alternate MediaWiki markup parser may be installed with:
$ 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
If using pip, use pwb instead of python pwb.py in examples below.
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]
To learn more about running basic Pywikibot scripts, see:
- Small wiki toolkits workshop about running basic Pywikibot scripts
- Self-study materials based on the small wiki toolkits workshop
- Workshop handbook based on the small wiki toolkits workshop
Daftar semua skrip tersedia di $scripts.
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.