Manual:Pywikibot/Pemasangan

From mediawiki.org
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 79% complete.
Outdated translations are marked like this.
Halaman ini akan membantu Anda bagaimana memulai Pywikibot, baik pada komputer Anda sendiri, pada Toolforge, atau menggunakan PAWS: A Web Shell.
Di PAWS

PAWS: A Web Shell adalah cara termudah untuk memulai Pywikibot. Tidak ada instalasi yang diperlukan, dan Anda menggunakan antarmuka web untuk mengirimkan perintah.

Pada komputer Anda sendiri

Berikut adalah panduan untuk membantu Anda memulai memasang dan menjalankan Pywikibot pada komputer Anda sendiri. Ada empat langkah utama untuk proses ini:

Toolforge menyediakan prasarana layanan cloud stabil di peladen Wikimedia yang memungkinkan Anda menjalankan bot secara terus-menerus atau sesuai jadwal.

Menginstal Python

Mengunduh dan menginstal Python dari https://www.python.org/downloads/.

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.

Unduh cabang Pywikibot terbaru stable: .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]

To learn more about running basic Pywikibot scripts, see:

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.