ดาวน์โหลดจาก Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 97% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
เนื่องจาก MediaWiki 1.19beta2, 1.18.2, 1.17.3, ส่วนขยายและส่วนขยาย MediaWiki ใช้ Git สำหรับการควบคุมเวอร์ชัน สำหรับเวอร์ชันที่เก่ากว่าโปรดดูที่ Subversion

Gitเป็นซอฟต์แวร์แจกจ่ายเวอร์ชันที่อนุญาตให้ผู้ใช้ดาวน์โหลดเวอร์ชันล่าสุดของสาขาโดยไม่ต้องรอให้ใครสักคนมาบรรจุข้อมูลดังกล่าว MediaWiki จะเปิดตัวได้เร็วขึ้นและคุณจะสามารถอัปเดตการติดตั้งของคุณได้ง่ายขึ้นย้อนกลับการอัปเกรดหรือ submit patches (แน่นอนว่าอย่าลืมว่ารุ่นที่มีเสถียรภาพอย่างเป็นทางการมีความเสี่ยงน้อยกว่า)

ดู Git สำหรับรายละเอียดเพิ่มเติมโดยเฉพาะอย่างยิ่งสำหรับการบริจาค ต่อไปนี้คือคำแนะนำสั้น ๆ สำหรับงานทั่วไป 2 อย่าง

ข้อกำหนดเบื้องต้น

คุณต้องติดตั้ง Git ไว้ก่อนจึงจะสามารถใช้งานได้ มีหลายวิธีที่จะได้รับ Git ขึ้นอยู่กับระบบปฏิบัติการของคุณ สำหรับแหล่งข้อมูลและไบนารีที่เป็นทางการโปรดดูที่git-scm.comสำหรับวิธีอื่นในการติดตั้ง Git ให้ใช้เครื่องมือค้นหาที่คุณชื่นชอบเพื่อดูคำแนะนำสำหรับระบบปฏิบัติการของคุณ

ขอแนะนำให้คุณติดตั้งเครื่องแต่งเพลงไว้เพื่อดาวน์โหลดและติดตั้งไลบรารีของ บริษัท อื่น แต่ไม่จำเป็นต้องใช้

ใช้ Git เพื่อดาวน์โหลด MediaWiki

ดาวน์โหลด

คุณสามารถดาวน์โหลด MediaWiki core โดยใช้ Git รวมถึงส่วนขยายทั้งหมดที่ติดตั้งอยู่ในกลุ่มเซิร์ฟเวอร์ของมูลนิธิวิกิมีเดียและส่วนขยายอื่น ๆ ที่โฮสต์บน gerrit ไว้ด้วย

ขั้นตอนแรกคือการโคลนที่เก็บข้อมูลหลักของ MediaWiki ขั้นตอนนี้จะใช้เวลาสักครู่

ในหน้าต่างเทอร์มินัลให้ป้อนคำสั่งต่อไปนี้:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git --branch REL1_31 mediawiki

นี่เป็นส่วนสำคัญของพื้นที่เก็บข้อมูลหลักของ MediaWiki โดยชี้ไปที่สาขาย่อย 1.31, ลงในไดเร็กทอรีย่อยชื่อ mediawiki

เมื่อต้องการติดตั้งลงในไดเร็กทอรีอื่นให้เปลี่ยนที่ในบรรทัดคำสั่ง (สำหรับข้อมูลเพิ่มเติม อ้างถึงเอกสารเหล่านี้) เมื่อพื้นที่เก็บข้อมูลถูกโคลนแล้วคุณสามารถเปลี่ยนไปใช้สาขาหรือแท็กต่างๆ (ดูด้านล่าง) รวมทั้งผู้ติดตามเวอร์ชันที่ไม่เสถียรของ MediaWiki สาขาการพัฒนา master เป็นผู้พัฒนาเวอร์ชันล่าสุดของ MediaWiki; คุณ ไม่ควรใช้รหัสหลักสำหรับการผลิต ภายใต้สถานการณ์ใด ๆ เนื่องจากไม่ถือว่ามีเสถียรภาพ

ถ้าคุณต้องการลดจำนวนของการแก้ไขที่ถูกโคลนเพิ่ม --depth=1 ไปยังคำสั่งดังกล่าว

สาขาที่ปล่อยมีพ็อกเก็ต Git อยู่ในนั้นสำหรับส่วนขยายและสกินที่ใช้โดยทั่วไป (สาขาหลักไม่ได้มี) หากต้องการอัปเดตไฟล์ย่อยให้เรียกใช้

cd mediawiki
git submodule update --init

ดาวน์โหลดเพื่อการพัฒนา

ถ้าคุณมี developer account (ซึ่งง่ายต่อการร้องขอ) จากนั้นแทนที่จะใช้โคลนแบบไม่ระบุตัวตนกับ https คุณควรทำสำเนากับ ssh <USERNAME> เพื่อให้คุณสามารถส่งการเปลี่ยนแปลงเพื่อรับการตรวจทาน:

git clone ssh://<ชื่อผู้ใช้>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

การจำลองนี้จะคัดลอกพื้นที่เก็บข้อมูลหลัก MediaWiki ทั้งหมดที่ซิงค์กับสาขาหลักลงในไดเรกทอรีย่อยชื่อว่า mediawiki

เรียกไลบรารีภายนอก

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.
  • หรือถ้าคุณไม่ต้องการใช้ Composer หรือถ้าคุณต้องการใช้ชุดเดียวกันของไลบรารีผู้จัดจำหน่ายเดียวกันกับที่ใช้ในกลุ่มการผลิต WMF คุณสามารถแทน git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git เพื่อสร้างไดเร็กทอรี vendor/ ภายในโฟลเดอร์หลักของ การติดตั้ง MediaWiki โปรดทราบว่าหากส่วนขยายใด ๆ ของคุณมีข้อกำหนดจากผู้แต่งเอง 'คุณจะไม่สามารถใช้ตัวเลือกนี้ได้'

ก่อน MediaWiki 1.25 ไลบรารีภายนอกถูกเก็บไว้ในที่เก็บข้อมูลหลักและไม่มีผู้จัดการแพ็กเกจถูกต้อง

แท็กมีเดียวิกิ (เวอร์ชั่นเสถียร)

หรือมีการใช้ MediaWiki เวอร์ชันที่มีความเสถียรเฉพาะเจาะจงโดยใช้ 'แท็ก' สิ่งเหล่านี้เหมือนกับการเผยแพร่ tarball ปัจจุบันมีจำนวน Template:จำนวนการออกจำหน่ายที่มีเสถียรภาพของจำนวน (มีเสถียรภาพ), Template:เลขที่ใบอนุญาตต่ออายุ MW เดิม (LTS) และ Template:เลขที่รุ่นเก่าของ MW (เดิม)

คุณสามารถดูแท็กทั้งหมดที่มี:

git tag -l | sort -V

การใช้คำสั่ง sort GNU ไม่ใช่เช่นบน Mac OS X คุณต้องพึ่งพาตัวคั่นเก่าที่ดี:

git tag -l | sort -n -t. -k1 -k2 -k3

หากต้องการใช้แท็กเฉพาะเช่น รุ่นเสถียรล่าสุด:

git checkout 1.31.1

รุ่นล่าสุดของ MediaWiki

มีการติดตามเวอร์ชันล่าสุดของ MediaWiki ในสาขา 'ต้นแบบ' นี่คือสิ่งที่ได้รับการตรวจสอบเฉพาะที่ออกโดยค่าเริ่มต้นเมื่อคุณลอกข้อมูลที่เก็บ MediaWiki เป็นครั้งแรก หากคุณได้เปลี่ยนไปใช้สาขาอื่น แต่ต้องการเปลี่ยนกลับไปใช้ MediaWiki ที่มีเลือดออกทำ:

git checkout master

การรักษาความทันสมัย

หากคุณกำลังใช้สาขาหรือเวอร์ชันพัฒนา (สาขา "หลัก") ของ MediaWiki การเลือกการเปลี่ยนแปลงล่าสุดเป็นเรื่องง่าย เปลี่ยนเป็นไดเร็กทอรีโคลน MediaWiki และออกคำสั่งนี้:

git pull

การเปลี่ยนแปลงล่าสุดทั้งหมดสำหรับสาขาที่คุณใช้จะถูกใช้

เวอร์ชั่นใหม่ของแกนอาจต้องใช้ส่วนขยายและสกินที่ใหม่กว่าดังนั้นคุณต้องเข้าไปที่ส่วนขยายและไดเร็กทอรี skin และอัปเดตด้วยคำสั่งเช่น git pull --recurse-submodules

นอกจากนี้คุณต้องอัปเดต vendor/ ด้วยไลบรารีที่ต้องการเวอร์ชันใหม่กว่า ซึ่งมักจะหมายถึงการเรียกใช้คำสั่ง Composer ต่อไปนี้ แต่โปรดดูรายละเอียดเพิ่มเติมจาก [#Fetch external libraries]

composer update --no-dev

หลังจากอัปเดต / อัปเกรดโค้ดและไลบรารีที่จำเป็นแล้วคุณควรเรียกใช้สคริปต์บรรทัดคำสั่ง update ของ MediaWiki update.php เพื่ออัพเดตตารางฐานข้อมูลตามต้องการ

php maintenance/update.php

ถ้าคุณใช้ MediaWiki-Vagrant, it offers a single command, vagrant git-update, that performs all these steps.

เปลี่ยนเป็นเวอร์ชั่นอื่น

การสลับไปใช้ MediaWiki เวอร์ชันอื่นทำได้ง่ายกว่า Git มากกว่ากับ SVN แต่ละเวอร์ชันของเรามีการติดตามเป็นสาขาหรือแท็ก เพื่อที่จะเปลี่ยนไปใช้อย่างใดอย่างหนึ่งสิ่งที่คุณต้องทำก็คือ [url checkout] สาขาหรือแท็กที่คุณต้องการจากภายในไดเร็กทอรีโคลน MediaWiki ของคุณ:

git checkout <ชื่อสาขา>

หรือ

git checkout <ชื่อแท็ก>

การเปลี่ยนแปลงจะถูกนำไปใช้โดยอัตโนมัติและคุณจะพร้อมที่จะดำเนินการทั้งหมด

ใช้ Git เพื่อดาวน์โหลดส่วนขยาย MediaWiki

รายชื่อส่วนขยายใน git

ดาวน์โหลดส่วนขยาย

<EXT> ควรแทนที่ด้วยชื่อนามสกุลที่คุณต้องการดาวน์โหลดโดยไม่มีช่องว่าง สำหรับ Extension:TitleKey ก็คือ TitleKey (กรณีที่สำคัญ!)

ดาวน์โหลดและโคลนนามสกุลจาก Git:

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/<EXT> --branch REL1_31

ผู้พัฒนา โคลนด้วย:

git clone ssh://<ชื่อผู้ใช้>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

คุณสามารถดูซอร์สโค้ดส่วนขยายในแอ็พพลิเคชัน Gerrit's gitiles และที่ URL:

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

ดาวน์โหลดส่วนขยายทั้งหมด

หากคุณต้องการมีส่วนขยาย "MediaWiki ทั้งหมด" ที่อยู่ที่ gerrit.wikimedia.org ที่เช็คเอาท์ไปยังเครื่องของคุณให้ป้อนข้อมูลต่อไปนี้:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
cd extensions
git submodule update --init --recursive

หลังจากนั้นเพื่ออัพเดตส่วนขยายทั้งหมดไปยังเวอร์ชันล่าสุดของสาขาดังกล่าวเพียงป้อน:

cd /path/to/extensions
git pull
git submodule update --init --recursive

หากต้องการเปลี่ยนเป็นสาขาอื่นเช่นหลังจากเปิดตัวใหม่:

git submodule foreach 'git checkout -b REL1_30 origin/REL1_30 || :'

โปรดจำไว้ว่าคุณควรใช้เฉพาะส่วนขยายรุ่นจากรุ่นเดียวกันกับ MediaWiki และแต่ละรุ่นเท่านั้น

ในการติดตามสาขาหลัก:

git submodule foreach 'git checkout -b origin/master || :'

โปรดทราบว่า คุณไม่ควรใช้รหัสหลักสำหรับการผลิต ภายใต้สถานการณ์ใด ๆ เนื่องจากไม่ถือว่ามีเสถียรภาพ

หากคุณต้องการเช็คเอาต์แบบอ่านอย่างเดียว (เช่นไปยัง grep หรือวิเคราะห์โค้ด MediaWiki ทั้งหมด) คุณสามารถใช้ แบ่งปันเช็คเอาต์ MediaWiki บน Labs โดยไม่ต้องดาวน์โหลดอะไรในเครื่องของคุณ

ลบส่วนขยาย

  1. ลบ "require_once …" หรือ "wfLoadExtension( … )" จาก LocalSettings.php
  2. ลบบรรทัดใด ๆ ที่อ้างถึงส่วนขยายใน composer.local.json (โดยปกติจะอยู่ในส่วน "เพิ่มเติม→รวม-ปลั๊กอิน→รวม")
  3. ลบไดเร็กทอรีของส่วนขยายใน install-dir/extensions/

ใช้ Git เพื่อดาวน์โหลดสกิน MediaWiki

รายชื่อสกินใน git

MediaWiki 1.24 และใหม่กว่าไม่รวมสกินในการดาวน์โหลด Git

ทำตามขั้นตอนเดียวกันกับส่วนขยาย (อธิบายไว้ในส่วนก่อนหน้า) แต่ใช้ skins แทน extensions ใน URL และเส้นทางทั้งหมด

คำแนะนำในการติดตั้งโดยละเอียดมีอยู่ในหน้าสกินแต่ละหน้าที่นี่ที่ MediaWiki.org เช่นดู Skin:Vector#Installation คำแนะนำสำหรับสกินอื่น ๆ ทั้งหมดเป็นแบบเดียวกัน

ดูเพิ่ม

  • Migrating from SVN to Git
  • Nightlies ซึ่งเป็นทางเลือกในการดาวน์โหลดจาก Git
  • Intranet/Intranet Installation,ซึ่งเป็นส่วนหนึ่งของชุดบทความที่ใช้ชุด Git สำหรับการใช้งาน MediaWiki