Download from Git/id

Git adalah sebuah sistem pengendali versi terdistribusi. Git memungkinkan Anda untuk mengunduh versi terbaru dari kode sumber, dengan semua percabangan dan rilis berlabel juga tersedia.

Anda sebaiknya mengunduh dari Git apabila Anda adalah seorang pengembang dan ingin mengajukan tambalan

Jika Anda tidak ingin mengembangkan tetapi hanya ingin memasang MediaWiki dan ekstensi-ekstensi, maka unduh rilis tarball yang stabil saja.

Lihat Git untuk detail lebih lanjut, khususnya untuk berkontribusi. Berikut ini adalah petunjuk-petunjuk singkat untuk melakukan beberapa hal umum.

Prasyarat
Anda harus memasang Git sebelum Anda bisa menggunakannya. Ada banyak cara untuk mendapatkan Git, tergantung kepada sistem operasi Anda. Ikuti Gerrit/Tutorial#Memasang Git, atau gunakan mesin pencari favorit Anda.

Disarankan Anda telah memasang untuk mengunduh dan memasang pustaka pihak ketiga, tapi tidak diharuskan.



Pengunduhan
Anda bisa mengunduh inti MediaWiki menggunakan Git, serta semua ekstensi yang sedang dipasang di gugus server Wikimedia Foundation dan banyak ekstensi lainnya yang dihos di.

Langkah pertamanya adalah mengklon repositori inti MediaWiki. Ini akan memakan waktu cukup lama.



Mengunduh untuk pengembangan
Versi pengembangan terbaru MediaWiki dilacak di cabang 'master'.

Pertama-tama pastikan Anda telah membuat akun pengembang, agar Anda memiliki nama pengguna ssh.

Lalu, di jendela terminal, masukkan perintah berikut untuk mengklon ssh Anda agar Anda bisa mengajukan tambalan untuk ditinjau.

Ini mengklon seluruh repositori inti MediaWiki, disinkronkan dengan cabang master, ke dalam sebuah subdirektori yang bernama.

Untuk memasang di direktori yang berbeda, ubah itu di command line (untuk lebih banyak info baca dokumentasi berikut). Setelah repositorinya diklon, Anda bisa berganti ke cabang atau tag yang berbeda. Cabang pengembangan,, adalah versi mutakhir MediaWiki untuk pengembang; Anda sebaiknya tidak menggunakan kode master untuk produksi dalam situasi apapun karena kode tersebut tidak dinilai stabil.





Mengunduh cabang stabil
Bila Anda tidak ingin mengembangkan tambalan perangkat lunak tapi ingin mengklon cabang rilis stabil secara anonim, gunakan perintah ini:

Jika Anda memiliki koneksi internet yang lambat dan ingin mengurangi banyak revisi yang diklon, tambahkan  ke perintah.



Tag MediaWiki (versi stabil)
Selain itu, beberapa versi stabil tertentu Mediawiki dilacak menggunakan 'tags'. Versi-versi tersebut setara dengan rilis tarball. Saat ini, versi-versi tersebut meliputi (stabil),  (LTS) dan  (warisan).

Anda bisa melihat semua tag yang tersedia menggunakan perintah:

Untuk menggunakan tag tertentu, misalnya rilis stabil terbaru:



Memperbarui submodul Git
Cabang-cabang tersebut mengandung submodul-submodul Git, untuk ekstensi dan kulit yang biasa digunakan (cabang master tidak memilikinya). Untuk memperbarui submodul tersebut, jalankan: Cabang  tidak memiliki ini. Untuk memperbarui submodul, jalankan:



Mengambil pustaka luar
MediaWiki menggunakan Composer untuk mengelola pustaka PHP luar, yang semuanya diletakkan di direktori  di dalam direktori MediaWiki Anda.

Untuk memasang pustaka yang diperlukan, Anda bisa memilih:


 * Mengunduh dan memasang composer PHAR, mengubah nama berkas composer.phar sebagaimana diinstruksikan untuk OS Anda (opsional), dan kemudian menjalankan  dari direktori MediaWiki Anda. Ini adalah cara yang disarankan.
 * If the default PHP CLI version does not match the web server's PHP version, specify it with e.g..
 * Atau, jika Anda tidak mau menggunakan Composer atau jika Anda mau menggunakan kumpulan pustaka vendor yang persis sama dengan yang digunakan di gugus produksi WMF, Anda bisa membuat direktori  di dalam folder inti pemasangan MediaWiki Anda:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Perhatikan bahwa jika di antara ekstensi Anda ada yang memiliki kebutuhan Composer-nya sendiri, maka Anda tidak bisa menggunakan pilihan ini.

Sebelum MediaWiki 1.25, pustaka luar disimpan di repositori inti, dan tidak memerlukan manajer paket.



Memperbarui
Jika Anda menggunakan cabang tertentu atau versi pengembangan (cabang "master") MediaWiki, mengikuti perubahan terbaru relatif mudah. Masuk ke direktori klon MediaWiki Anda lalu jalankan perintah ini:

Semua perubahan terbaru dalam cabang yang Anda gunakan akan dilaksanakan.

Versi baru dari inti mungkin memerlukan versi baru dari ekstensi dan kulit, jadi Anda perlu pergi ke setiap direktori ekstensi dan kulit lalu memperbaruinya menggunakan perintah seperti.

Anda juga perlu memperbarui  dengan versi baru dari pustaka yang diperlukan. Ini biasanya dilakukan dengan menjalankan perintah Composer berikut, tapi lihat #Mengambil pustaka luar di atas untuk detail lebih lanjut:

Setelah memperbarui/meningkatkan kode dan pustaka yang diperlukan, sebaiknya Anda menjalankan skrip baris perintah  MediaWiki untuk memperbarui tabel basis data sesuai kebutuhan:

Jika Anda menggunakan, tersedia sebuah perintah, , yang menjalankan semua tahap tersebut.



Berpindah ke versi lainnya
Setiap versi kami dilacak sebagai cabang atau tag. Untuk berganti ke versi yang lain (misalnya dari cabang  ke cabang atau tag yang lain), checkout cabang atau tag yang Anda inginkan dari dalam direktori klon MediaWiki Anda:

atau

Seluruh perubahan akan diterapkan secara otomatis dan Anda akan disiapkan untuk menggunakannya.



Menggunakan Git untuk mengunduh ekstensi MediaWiki

 * Daftar ekstensi pada git



Unduh sebuah ekstensi

 * Dalam perintah-perintah berikutnya, harus diisi dengan nama ekstensi yang ingin Anda unduh, tanpa spasi. Sebagai contoh, harus menjadi TitleKey. (huruf besar kecil berpengaruh!)

Unduh dan menduplikat ekstensi dari Git:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

Anda bisa melihat kode sumber ekstensi di aplikasi gitiles Gerrit, dan di URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master



Unduh semua ekstensi
Jika anda berkeinginan untuk memiliki semua ekstensi MediaWiki di gerrit.wikimedia.org tersimpan di mesin anda, lakukan langkah berikut:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

Untuk memperbaharui ekstensi ke versi terbaru, lakukan hal berikut:

Untuk melihat versi lain, misalnya setelah rilis baru:

Ingatlah bahwa Anda sebaiknya hanya menggunakan versi ekstensi dari rilis yang sama dengan MediaWiki versi tersebut dan sebaliknya.

Untuk melacak cabang master:

Tolong perhatikan bahwa Anda sebaiknya tidak menggunakan kode master untuk produksi dalam keadaan apapun karena kode tersebut tidak dinilai stabil.

Jika Anda hanya memerlukan checkout read-only (misalnya untuk grep atau menganalisa seluruh kode MediaWiki), Anda bisa menggunakan checkout MediaWiki yang dibagikan di Labs, tanpa mengunduh apapun ke mesin Anda.



Menghapus sebuah ekstensi

 * 1) Hapus "$code" atau "$code2" dari $LocalSettings
 * 2) Hapus semua baris yang mengacu pada ekstensi tersebut di   (biasanya di bagian "extra → merge-plugin → include")
 * 3) Hapus direktori ekstensi di



Gunakan Git untuk mengunduh tampilan MediaWiki

 * Daftar kulit di git

MediaWiki 1.24 dan seterusnya tidak menyertakan skins pada unduhan Git

Ikuti prosedur yang sama dengan prosedur untuk ekstensi (dijelaskan di bagian sebelumnya), tapi menggunakan  bukannya   di semua URL dan path.

Petunjuk pemasangan yang terperinci tersedia di laman setiap kulit di sini di MediaWiki.org, misalnya lihat Skin:Vector#Pemasangan. Petunjuk untuk kulit yang lain tidak jauh berbeda.



Lihat pula

 * Intranet/Intranet Installation, bagian dari serangkaian artikel yang menggunakan Git untuk penggunaan MediaWiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki