ดาวน์โหลดจาก Git
Git is a distributed version control system. It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.
You should download from Git if you are a developer and want to submit patches.
If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.
ดู Git สำหรับรายละเอียดเพิ่มเติมโดยเฉพาะการเข้ามามีส่วนร่วม ด้านล่างนี้คือแนวทางแบบรวบรัดสำหรับบุคคลทั่วไป
ข้อกำหนดเบื้องต้น
คุณต้องติดตั้ง Git ไว้ก่อนจึงจะสามารถใช้งานได้ มีหลายวิธีที่จะได้รับ Git ขึ้นอยู่กับระบบปฏิบัติการของคุณ สำหรับแหล่งข้อมูลและไบนารีที่เป็นทางการโปรดดูที่[$link git-scm.com]สำหรับวิธีอื่นในการติดตั้ง Git ให้ใช้เครื่องมือค้นหาที่คุณชื่นชอบเพื่อดูคำแนะนำสำหรับระบบปฏิบัติการของคุณ Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.
ขอแนะนำให้คุณติดตั้งเครื่องแต่งเพลงไว้เพื่อดาวน์โหลดและติดตั้งไลบรารีของ บริษัท อื่น แต่ไม่จำเป็นต้องใช้
ใช้ Git เพื่อดาวน์โหลด MediaWiki
ดาวน์โหลด
คุณสามารถดาวน์โหลด MediaWiki core โดยใช้ Git รวมถึงส่วนขยายทั้งหมดที่ติดตั้งอยู่ในกลุ่มเซิร์ฟเวอร์ของมูลนิธิวิกิมีเดียและส่วนขยายอื่น ๆ ที่โฮสต์บน gerrit ไว้ด้วย
ขั้นตอนแรกคือการโคลนที่เก็บข้อมูลหลักของ MediaWiki ขั้นตอนนี้จะใช้เวลาสักครู่
ดาวน์โหลดเพื่อการพัฒนา
มีการติดตามเวอร์ชันล่าสุดของ MediaWiki ในสาขา 'master'
ถ้าคุณมี developer account (ซึ่งง่ายต่อการร้องขอ) จากนั้นแทนที่จะใช้โคลนแบบไม่ระบุตัวตนกับ https คุณควรทำสำเนากับ ssh <USERNAME> เพื่อให้คุณสามารถส่งการเปลี่ยนแปลงเพื่อรับการตรวจทาน:
ในหน้าต่างเทอร์มินัลให้ป้อนคำสั่งต่อไปนี้ไปยังโคลนที่อยู่บน ssh {{$1|USERNAME}}
เพื่อทำการยืนยันการส่งสำหรับการรีวิว
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki
การจำลองนี้จะคัดลอกพื้นที่เก็บข้อมูลหลัก MediaWiki ทั้งหมดที่ซิงค์กับสาขาหลักลงในไดเรกทอรีย่อยชื่อว่า mediawiki
เมื่อต้องการติดตั้งลงในไดเร็กทอรีอื่นให้เปลี่ยนที่ในบรรทัดคำสั่ง (สำหรับข้อมูลเพิ่มเติม อ้างถึงเอกสารเหล่านี้)
เมื่อพื้นที่เก็บข้อมูลถูกโคลนแล้ว คุณสามารถเปลี่ยนไปใช้สาขาหรือแท็กอื่น ๆ
สาขาการพัฒนา master
เป็นผู้พัฒนาเวอร์ชันล่าสุดของ MediaWiki; คุณ ไม่ควรใช้รหัสหลักสำหรับการผลิต ภายใต้สถานการณ์ใด ๆ เนื่องจากไม่ถือว่ามีเสถียรภาพ
Download a stable branch
If you do not want to develop software patches but want to anonymously clone the stable release branch 1.42, use this command instead:
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_42 mediawiki
ถ้าคุณต้องการลดจำนวนของการแก้ไขที่ถูกโคลนเพิ่ม --depth=1
ไปยังคำสั่งดังกล่าว
แท็กมีเดียวิกิ (เวอร์ชั่นเสถียร)
หรือมีการใช้ MediaWiki เวอร์ชันที่มีความเสถียรเฉพาะเจาะจงโดยใช้ 'แท็ก' สิ่งเหล่านี้เหมือนกับการเผยแพร่ tarball ในปัจจุบัน เหล่านี้เป็น 1.42.3 (รุ่นที่เสถียร), 1.39.10 (LTS) และ 1.39.10 (legacy LTS)
คุณสามารถดูแท็กทั้งหมดที่มี:
git tag -l | sort -V
หากต้องการใช้แท็กเฉพาะเช่น รุ่นเสถียรล่าสุด:
git checkout 1.42.3
อัพเดท Git submodules
สาขาที่ปล่อยมีพ็อกเก็ต Git อยู่ในนั้นสำหรับส่วนขยายและสกินที่ใช้โดยทั่วไป (สาขาหลักไม่ได้มี) หากต้องการอัปเดตไฟล์ย่อยให้เรียกใช้
The master
branch does not have these.
To update the submodules, run:
cd mediawiki
git submodule update --init --recursive
เรียกไลบรารีภายนอก
MediaWiki ใช้ Composer เพื่อจัดการไลบรารี PHP ภายนอกซึ่งทั้งหมดจะลงท้ายด้วยไดเร็กทอรี vendor/
ในไดเร็กทอรี MediaWiki ของคุณ
ในการติดตั้งไลบรารีที่จำเป็นเหล่านี้คุณสามารถเลือกได้:
- Download and install the composer PHAR, optionally rename the composer.phar file as instructed for your OS, and then run
composer update --no-dev
from your MediaWiki directory. This is the recommended approach.
- If the default PHP CLI version does not match the web server's PHP version, specify it with e.g.
php7.4 composer.phar update --no-dev
.
- If the default PHP CLI version does not match the web server's PHP version, specify it with e.g.
- หรือถ้าคุณไม่ต้องการใช้ Composer หรือถ้าคุณต้องการใช้ชุดเดียวกันของไลบรารีผู้จัดจำหน่ายเดียวกันกับที่ใช้ในกลุ่มการผลิต WMF คุณสามารถแทน เพื่อสร้างไดเร็กทอรี
vendor/
ภายในโฟลเดอร์หลักของ การติดตั้ง MediaWikigit clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
- โปรดทราบว่าหากส่วนขยายใด ๆ ของคุณมีข้อกำหนดจาก Composer เอง คุณจะไม่สามารถใช้ตัวเลือกนี้ได้
ก่อน MediaWiki 1.25 ไลบรารีภายนอกถูกเก็บไว้ในที่เก็บข้อมูลหลักและไม่มีผู้จัดการแพ็กเกจถูกต้อง
การรักษาความทันสมัย
หากคุณกำลังใช้สาขาหรือเวอร์ชันพัฒนา (สาขา "หลัก") ของ MediaWiki การเลือกการเปลี่ยนแปลงล่าสุดเป็นเรื่องง่าย เปลี่ยนเป็นไดเร็กทอรีโคลน MediaWiki และออกคำสั่งนี้:
git pull
การเปลี่ยนแปลงล่าสุดทั้งหมดสำหรับสาขาที่คุณใช้จะถูกใช้
เวอร์ชั่นใหม่ของแกนอาจต้องใช้ส่วนขยายและสกินที่ใหม่กว่าดังนั้นคุณต้องเข้าไปที่ส่วนขยายและไดเร็กทอรี skin และอัปเดตด้วยคำสั่งเช่น git pull --recurse-submodules
นอกจากนี้คุณต้องอัปเดต vendor/
ด้วยไลบรารีที่ต้องการเวอร์ชันใหม่กว่า
ซึ่งมักจะหมายถึงการเรียกใช้คำสั่ง Composer ต่อไปนี้ แต่โปรดดูรายละเอียดเพิ่มเติมจาก #Fetch external libraries
composer update --no-dev
หลังจากอัปเดต / อัปเกรดโค้ดและไลบรารีที่จำเป็นแล้วคุณควรเรียกใช้สคริปต์บรรทัดคำสั่ง update ของ MediaWiki update.php
เพื่ออัพเดตตารางฐานข้อมูลตามต้องการ
php maintenance/run.php update
If you use MediaWiki-Vagrant , it offers a single command, vagrant git-update
, that performs all these steps.
เปลี่ยนเป็นเวอร์ชั่นอื่น
แต่ละเวอร์ชันของเรามีการติดตามเป็นสาขาหรือแท็ก เพื่อที่จะเปลี่ยนไปใช้อย่างใดอย่างหนึ่งสิ่งที่คุณต้องทำก็คือ checkout สาขาหรือแท็กที่คุณต้องการจากภายในไดเร็กทอรีโคลน MediaWiki ของคุณ:
git checkout <ชื่อ_สาขา>
หรือ
git checkout <ชื่อแท็ก>
การเปลี่ยนแปลงจะถูกนำไปใช้โดยอัตโนมัติและคุณจะพร้อมที่จะดำเนินการทั้งหมด
ใช้ Git เพื่อดาวน์โหลดส่วนขยาย MediaWiki
ดาวน์โหลดส่วนขยาย
- <EXT> ควรแทนที่ด้วยชื่อนามสกุลที่คุณต้องการดาวน์โหลดโดยไม่มีช่องว่าง สำหรับ Extension:TitleKey ก็คือ TitleKey (กรณีที่สำคัญ!)
ดาวน์โหลดและโคลนนามสกุลจาก 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
คุณสามารถดูซอร์สโค้ดส่วนขยายในแอ็พพลิเคชัน Gerrit's gitiles และที่ URL:
https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD
ดาวน์โหลดส่วนขยายทั้งหมด
หากคุณต้องการมีส่วนขยาย "MediaWiki ทั้งหมด" ที่อยู่ที่ gerrit.wikimedia.org ที่เช็คเอาท์ไปยังเครื่องของคุณให้ป้อนข้อมูลต่อไปนี้:
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
เพื่ออัพเดตส่วนขยายทั้งหมดไปยังเวอร์ชันล่าสุดของส่วนย่อยดังกล่าวในเวลาใด ๆ เพียงป้อน:
cd /path/to/extensions
git pull
git submodule update --init --recursive
หากต้องการเปลี่ยนเป็นสาขาอื่นเช่นหลังจากเปิดตัวใหม่:
git submodule foreach 'git checkout -b REL1_41 origin/REL1_41 || :'
โปรดจำไว้ว่าคุณควรใช้เฉพาะส่วนขยายรุ่นจากรุ่นเดียวกันกับ MediaWiki และแต่ละรุ่นเท่านั้น
ในการติดตามสาขาหลัก:
git submodule foreach 'git checkout -b origin/master || :'
โปรดทราบว่า คุณไม่ควรใช้รหัสหลักสำหรับการผลิต ภายใต้สถานการณ์ใด ๆ เนื่องจากไม่ถือว่ามีเสถียรภาพ
หากคุณต้องการเช็คเอาต์แบบอ่านอย่างเดียว (เช่นไปยัง grep หรือวิเคราะห์โค้ด MediaWiki ทั้งหมด) คุณสามารถใช้ แบ่งปันเช็คเอาต์ MediaWiki บน Labs โดยไม่ต้องดาวน์โหลดอะไรในเครื่องของคุณ
ลบส่วนขยาย
- ลบ "
require_once …
" หรือ "wfLoadExtension( … )
" จากLocalSettings.php
- ลบบรรทัดใด ๆ ที่อ้างถึงส่วนขยายใน
composer.local.json
(โดยปกติจะอยู่ในส่วน "เพิ่มเติม→รวม-ปลั๊กอิน→รวม") - ลบไดเร็กทอรีของส่วนขยายใน
install-dir/extensions/
ใช้ Git เพื่อดาวน์โหลดสกิน MediaWiki
MediaWiki 1.24 และใหม่กว่าไม่รวมสกินในการดาวน์โหลด Git
ทำตามขั้นตอนเดียวกันกับส่วนขยาย (อธิบายไว้ในส่วนก่อนหน้า) แต่ใช้ skins
แทน extensions
ใน URL และเส้นทางทั้งหมด
คำแนะนำในการติดตั้งโดยละเอียดมีอยู่ในหน้าสกินแต่ละหน้าที่นี่ที่ MediaWiki.org เช่นดู Skin:Vector#Installation คำแนะนำสำหรับสกินอื่น ๆ ทั้งหมดเป็นแบบเดียวกัน
ดูเพิ่ม
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