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.

• Lihat source code terbaru

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.
• 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

Daftar ekstensi pada git

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

1. Hapus "$code" atau "$code2" dari $LocalSettings
2. Hapus semua baris yang mengacu pada ekstensi tersebut di composer.local.json (biasanya di bagian "extra → merge-plugin → include")
3. Hapus direktori ekstensi di install-dir/extensions/

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 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.

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