Unduh dari Git
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 Composer untuk mengunduh dan memasang pustaka pihak ketiga, tapi tidak diharuskan.
Menggunakan Git untuk mengunduh MediaWiki
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 gerrit .
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 {{$1|USERNAME}}
Anda agar Anda bisa mengajukan tambalan untuk ditinjau.
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki
Ini mengklon seluruh repositori inti MediaWiki, disinkronkan dengan cabang master, ke dalam sebuah subdirektori yang bernama mediawiki
.
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, master
, 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 1.42 secara anonim, gunakan perintah ini:
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_42 mediawiki
Jika Anda memiliki koneksi internet yang lambat dan ingin mengurangi banyak revisi yang diklon, tambahkan --depth=1
ke perintah git clone
.
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 1.42.3 (stabil), 1.39.10 (LTS) dan 1.39.10 (warisan).
Anda bisa melihat semua tag yang tersedia menggunakan perintah:
git tag -l | sort -V
Untuk menggunakan tag tertentu, misalnya rilis stabil terbaru:
git checkout 1.42.3
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 master
tidak memiliki ini.
Untuk memperbarui submodul, jalankan:
cd mediawiki
git submodule update --init --recursive
Mengambil pustaka luar
MediaWiki menggunakan Composer untuk mengelola pustaka PHP luar, yang semuanya diletakkan di direktori vendor/
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
composer update --no-dev
dari direktori MediaWiki Anda. Ini adalah cara yang disarankan.- Jika versi CLI PHP bawaan tidak sesuai dengan versi PHP peladen web, sebutkan dengan, sebagai contoh,
php7.4 composer.phar update --no-dev
.
- Jika versi CLI PHP bawaan tidak sesuai dengan versi PHP peladen web, sebutkan dengan, sebagai contoh,
- 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
vendor/
di dalam folder inti pemasangan MediaWiki Anda:git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
- 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:
git pull
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 git pull --recurse-submodules
.
Anda juga perlu memperbarui vendor/
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:
composer update --no-dev
Setelah memperbarui/meningkatkan kode dan pustaka yang diperlukan, sebaiknya Anda menjalankan skrip baris perintah update.php
MediaWiki untuk memperbarui tabel basis data sesuai kebutuhan:
php maintenance/run.php update
Jika Anda menggunakan MediaWiki-Vagrant , tersedia sebuah perintah, vagrant git-update
, 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 master
ke cabang atau tag yang lain), checkout cabang atau tag yang Anda inginkan dari dalam direktori klon MediaWiki Anda:
git checkout <branch_name>
atau
git checkout <tag_name>
Seluruh perubahan akan diterapkan secara otomatis dan Anda akan disiapkan untuk menggunakannya.
Menggunakan Git untuk mengunduh ekstensi MediaWiki
Unduh sebuah ekstensi
- Dalam perintah-perintah berikutnya,
<EXT>
harus diisi dengan nama ekstensi yang ingin Anda unduh, tanpa spasi. Sebagai contoh Extension:TitleKey , 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:
cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT>
To clone and checkout a stable release branch instead, use these commands:
cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_42
Anda bisa melihat kode sumber ekstensi di aplikasi gitiles Gerrit, dan di URL:
https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD
Unduh semua ekstensi
Jika anda berkeinginan untuk memiliki semua ekstensi MediaWiki di gerrit.wikimedia.org tersimpan di mesin anda, lakukan langkah berikut:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions
Or, to checkout stable releases branch instead, use this command:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_42
After running the git clone
command, continue with these commands:
cd /path/to/extensions
git submodule update --init --recursive
Untuk memperbaharui ekstensi ke versi terbaru, lakukan hal berikut:
cd /path/to/extensions
git pull
git submodule update --init --recursive
Untuk melihat versi lain, misalnya setelah rilis baru:
git submodule foreach 'git checkout -b REL1_41 origin/REL1_41 || :'
Ingatlah bahwa Anda sebaiknya hanya menggunakan versi ekstensi dari rilis yang sama dengan MediaWiki versi tersebut dan sebaliknya.
Untuk melacak cabang master:
git submodule foreach 'git checkout -b origin/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
- Hapus "$code" atau "$code2" dari $LocalSettings
- Hapus semua baris yang mengacu pada ekstensi tersebut di
composer.local.json
(biasanya di bagian "extra → merge-plugin → include") - Hapus direktori ekstensi di
install-dir/extensions/
Gunakan Git untuk mengunduh tampilan MediaWiki
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 skins
bukannya extensions
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
Apendiks
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