Download from Git/ar

غت هو نظام لإدارة المراجعات الموزعة. يتيح لك هذا البرنامج تنزيل أحدث إصدار من النص المصدري، وتكون أيضا كافة أفرع البرمجيات وإصداراتها الموسومة تحت تصرفك.

ننصحك أن تنزل البرمجيات من غت لو كنت أحد المطورين وترغب في إرسال تصحيحات برمجية.

إذا لم تكن ترغب في تطوير برمجيات ميدياويكي وامتداداتها ولكن ترغب في تنزيلها فحسب، إذًا نزّل إصدارات تار المستقرة بدلا من ذلك.

طالع غت لمزيد من التفاصيل، خاصة في شأن المساهمة. النقاط التالية هي بعض التوجيهات السريعة لبعض من المهام الشائعة.

المتطلبات
يتعين عليك أن تنصّب غت قبل استخدامه. توجد سبل عدة للحصول على غت، وذلك يعتمد على نظام التشغيل الذي تستخدمه. اتبع الخطوات المبينة في Gerrit/Tutorial#Set up Git، أو استخدم محرك بحثك المفضل.

نحبذ لك أن تنصب Composer كي يتسنى لك تنزيل مكتبات الغير وتنصيبها، إلا أن هذا الأمر ليس إلزاميا.

التنزيل
يمكنك تنزيل لب برمجيات ميدياويكي مستخدما غت، وكذلك كافة الامتدادات المنصبة في الوقت الراهن على مجموعة خوادم مؤسسة ويكيميديا وامتدادات أخرى عدة مستضافة على.

الخطوة الأولى هي استنساخ مستودع لب برمجيات ميدياويكي. سوف يستغرق هذا الأمر بعض الوقت.

التنزيل لأغراض تطوير البرمجيات
يجري تتبع أحدث إصدار تطويري من برمجيات ميدياويكي في الفرع 'الرئيسي'.

تأكد أولا أنك قد أنشأت حساب مطور برمجيات، حتى يتسنى لك الحصول على اسم مستخدم ssh.

بعد ذلك، ومن نافذة أوامر جهاز طرفي، أدخل الأمر التالي كي تستنسخ مستخدما  ذي صلاحية ssh حتى يتسنى لك إرسال التصحيحات البرمجية لمراجعتها:

هذا الأمر يستنسخ كامل مستودع لب برمجيات ميدياويكي، الذي يتزامن مع الفرع الرئيسي، إلى دليل فرعي يحمل اسم.

إن كنت ترغب في التنصيب داخل دليل مختلف، غيّر هذه القيمة من سطر الأوامر (لمزيد من المعلومات راجع مستندات التوثيق هذه). يمكنك مباشرة بعد الانتهاء من استنساخ المستودع الانتقال إلى أفرع ووسوم مختلفة. إن فرع التطوير البرمجي، ، هو أحدث وأفضل إصدار تطوير برمجي من برمجيات ميدياويكي؛ يتعين عليك ألا تستخدم الكود الرئيسي لأغراض الإنتاج تحت أي ظرف كان منذ أنه يعتبر إصدار مستقر.



حمّل فرع مستقر
إذا لم ترغب بتطوير تصحيحات البرنامج، ولكن عوضا عنه ترغب باسم مجهول أن تنسخ الإصدار المستقر من الفرع ، فاستخدم هذا الأمر:

إن كان ليك اتصال بطيء بالإنترنت وترغب في تقليل عدد المراجعات التي سوف يجري استنساخها، أضف  إلى أمر.

وسوم ميدياويكي (الإصدار المستقر)
عوضا عن ذلك، يجري متابعة إصدارات مستقرة بعينها من ميدياويكي باستخدام 'وسوم'. هذه الإصدارات موازية لإصدارات تار. في الوقت الحالي، هذه الوسوم هي (مستقر) و  (إصدار دعم طويل الأجل) و  (قديم).

يمكنك رؤية كل الوسوم المتاحة مع:

كي تستخدم وسم محدد، مثل أحدث إصدار مستقر (the latest stable release):

Update the Git submodules
تحتوي الأفرع على مجموعة من وحدات غت الفرعية داخلها، لأغراض الامتدادات والسمات شائعة الاستخدام (لا يحتوي الفرع الرئيسي على هذه الأمور). كي تحدث الوحدات الفرعية، نفذ الأمر التالي:

إحضار مكتبات خارجية
تستعين برمجيات ميدياويكي بخدمة Composer في التعامل مع مكتبات بي إتش بي الخارجية، والتي ينتهي بها الحال جميعا في دليل  داخل دليل ميدياويكي.

لتثبيت هذه المكتبات الضّروريّة، لديك خيارات:


 * تنزيل composer PHAR وتنصيبه، ولديك خيار إعادة تسمية ملف composer.phar حسب تعليمات نظام التشغيل لديك، ومن ثم تشغيل  من داخل دليل ميدياويكي لديك. هذا السبيل هو السبيل الذي نحبذه.
 * أو، لو لم تكن ترغب في استخدام Composer أو لو لم تكن ترغب في استخدام ذات المجموعة من مكتبات الباعة المستخدمة في عنقود إنتاج مؤسسة ويكيميديا، يمكن بدلا من ذلك إنشاء دليل  داخل المجلد المركزي في تنصيب ميدياويكي لديك:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * لاحظ أنه لو كانت أي من امتداداتك تحتوي على متطلبات Composer الخاصة بها، سوف لن يسعك استخدام هذا الخيار.

كان تحفظ المكتبات الخارجية قبل نسخة ميدياويكي 1.25 في المستودع المركزي، ولم يتطلب الأمر الاستعانة بمدير حزمة.

التحديث
لو كنت تستخدم فرع محدد أو إصدار تطوير برمجيات (فرع «رئيسي») من برمجيات ميدياويكي، سيكون اختيار آخر التغييرات أمر يسير. اذهب إلى دليل ميدياويكي المنسوخ لديك وأصدر الأمر التالي:

سوف تنفذ كافة التغييرات الأخيرة التي جرت على الفرع الذي تستخدمه.

قد تتطلب النسخة الجديدة من اللب البرمجي نسخ جديدة من الامتدادات والسمات، لذا سوف يتعين عليك أن تذهب إلى كل دليل امتداد وسمة وتحديثها مستخدم أمر مثل.

سوف تحتاج أيضا إلى تحديث  مستخدما أية إصدارات أحدث من المكتبات المطلوبة. يعني هذا غالبا تشغيل أمر Composer التالي، لكن عليك أن تطالع فقرة إحضار مكتبات خارجية السالفة لتتعرف على المزيد من التفاصيل.

بعد تحديث أو ترقية النص المصدري والمكتبات المطلوبة سيتعين عليك تشغيل النص البرمجي المخصص لسطر أوامر ميدياويكي  كي تحدث جداول قاعدة البيانات حسب الحاجة:

لو كنت تستخدم MediaWiki-Vagrant، فهو يقدم لك أمر واحد فقط، ، يتولى القيام بكل تلك الخطوات.

التبديل إلى نسخة أخرى
كل من نسخنا يجري متابعتها بصفة أفرع أو وسوم. كي تبدل إلى نسخة أخرى (على سبيل المثال من الفرع  إلى فرع أو وسم آخر)، تحقق أولا من الفرع أو الوسم الذي ترغب فيه من داخل دليل ميدياويكي المنسوخ لديك:

أو

هذه التغييرات سوف تطبق آليا وسوف تكون جاهزا لبدء العمل.

استخدام غت لتنزيل امتدادات ميدياويكي

 * قائمة بالامتدادات الموجودة في غت

تنزيل امتداد

 * في الأوامر التالية، ضع محل  اسم الامتداد الذي ترغب في تنزيله دون مسافات. من أجل ، سوف تكون TitleKey. (تأكد من أن كافة الحروف تحافظ على حالتها!)

تنزيل امتداد واستنساخه من غت:

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

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

يمكنك الاطلاع على النص المصدري للامتداد في تطبيق gitiles من غيريت وكذلك على الوصلة الشبكية:

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

تنزيل كافة الامتدادات
إن كنت تفضل الحصول على كافة امتدادات ميدياويكي الموجودة في gerrit.wikimedia.org على جهازك، أدخل ما يلي:

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:

كي تحدث كافة الامتدادات إلى أحدث نسخها من ذلك الفرع في أي وقت كان، أدخل:

كي تغير إلى فرع آخر، مثل تلك الحالات بعد نشر إصدار جديد:

تذكر أنه يتعين عليك أن تستخدم فقط نسخ الامتدادات من ذات الإصدار الخاص بتلك النسخة من برمجيات ميدياويكي وغيرها.

كي تتابع الفرع الرئيسي:

يرجى ملاحظة أنه يتعين عليك ألا تستخدم الكود البرمجي الرئيسي في أغراض الإنتاج بأي حال من الأحوال منذ أنه يعد غير مستقر.

لو كنت ترغب فقط في الحصول على نسخة للقراءة فقط (على سبيل المثال لأجل grep أو تحليل كافة كود ميدياويكي البرمجي)، يمكنك استخدام ميدياويكي المشترك من Labs، دون تنزيل أي شيء على أي من أجهزتك.

إزالة امتداد

 * 1) أزل " " أو " " من
 * 2) أزل أي سطر يذكر الامتداد في   (عادة في قسم "extra → merge-plugin → include")
 * 3) أزل دليل الامتداد في

استخدام غت لتنزيل سمات ميدياويكي

 * قائمة بالسمات الموجودة في غت

لا يضم إصدار ميدياويكي 1.24 وما بعده السمات في تنزيل غت.

اتبع ذات الخطوات المتبعة في تنزيل الامتدادات (المبينة في القسم السالف)، ولكن استخدم  بدلا من   في كافة الوصلات الشبكية ومسارات المجلدات والملفات.

تعليمات التثبيت المفصلة متاحة على صفحة كل سمة على موقع MediaWiki.org هنا، على سبيل المثال طالع Skin:Vector#Installation. التعليمات الخاصة بكافة السمات الأخرى مشابهة لهذه.

انظر أيضا

 * إنترانت/التثبيت في شبكة إنترنت داخلية، جزء من سلسلة مفصلة من المقالات تستعين بغت في نشر برمجيات ميدياويكي