הורדה מ-Git

Git היא מערכת בקרת גרסאות מבוזרת. היא מאפשרת לכם להוריד את הגרסה העדכנית ביותר של קוד המקור, עם כל הענפים והגרסאות המתויגות העומדות לרשותכם.

עליכם להוריד מ-Git אם אתם מפתח ורוצים להגיש תיקונים.

אם אתם לא רוצים לפתח אלא רק להתקין את MediaWiki והרחבות, אז הורידו גרסאות tarball יציבות במקום זאת.

ראו את Git לפרטים נוספים, במיוחד עבור תרומות. להלן כמה הנחיות קצרות לכמה משימות נפוצות.

דרישות מקדימות

עליכם להתקין את Git לפני שתוכלו להשתמש בו. ישנן דרכים רבות לרכוש Git, בהתאם למערכת ההפעלה שלכם. עקבו אחר Gerrit/Tutorial#Set up Git, או השתמשו במנוע החיפוש המועדף עליכם.

מומלץ לכם להתקין את Composer כדי להוריד ולהתקין ספריות של צד שלישי, אך לא חובה.

שימוש ב-Git כדי להוריד את MediaWiki

הורדה

אתם יכולים להוריד את ליבת MediaWiki באמצעות Git, כמו גם את כל ההרחבות המותקנות כעת באשכול השרתים של Wikimedia Foundation והרחבות רבות אחרות המתארחות ב-גריט .

הצעד הראשון הוא שיבוט מאגר הליבה של MediaWiki. זה ייקח זמן מה.

הורדה לפיתוח

גרסת הפיתוח העדכנית ביותר של MediaWiki נמצאת במעקב בענף 'מאסטר'.

ראשית ודאו שיצרתם חשבון מפתח, כך שיהיה לכם שם משתמש SSH.

לאחר מכן, בחלון מסוף, הזינו את הפקודה הבאה כדי לשכפל את המאגר:

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

זה משבט את כל מאגר הליבה של MediaWiki, המסונכרן עם הענף הראשי, לתוך ספריית משנה בשם mediawiki.

כדי להתקין בספריה אחרת, שנו זאת בשורת הפקודה (למידע נוסף [עיינו במסמכים אלה https://git-scm.com/docs/git-clone]). לאחר שיבוט המאגר, אתם יכולים לעבור לענפים או לתגים שונים. ענף הפיתוח, master, הוא גרסת המפתחים המתקדמת של MediaWiki; אתם לא אמורים להשתמש בקוד מאסטר לייצור בשום פנים ואופן מכיוון שהוא לא נחשב יציב.

• צפו בקוד המקור העדכני ביותר

הורדת ענף יציב

אם אינכם רוצים לפתח תיקוני תוכנה אך רוצים לשכפל באופן אנונימי את ענף המהדורה היציב 1.43, השתמשו בפקודה זו במקום זאת:

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

אם יש לכם חיבור איטי לאינטרנט ואתם רוצים להפחית את מספר הגרסאות המשובטות, הוסיפו --depth=1 לפקודה git clone.

תגי MediaWiki (גרסה יציבה)

לחלופין, מעקב אחר גרסאות יציבות ספציפיות של MediaWiki באמצעות 'תגים'. אלה מקבילים לשחרור ה-tarball. נכון לעכשיו, אלה הם 1.43.1 (יציבות), 1.43.1 (LTS) ו-1.39.12 (LTS מהדור הקודם).

אתם יכולים לראות את כל התגים הזמינים עם:

git tag -l | sort -V

כדי להשתמש בתג ספציפי, למשל. המהדורה היציבה האחרונה:

git checkout 1.43.1

עדכון תת-מודולי Git

הענפים והתגים כוללים חבורה של תת-מודולי Git, עבור הרחבות וגוונים נפוצים ועבור ספריית vendor/. בענף master אין את אלה. כדי לעדכן את תת-מודולי ההפעלה, הריצו:

cd mediawiki
git submodule update --init --recursive

אחזרת ספריות חיצוניות

MediaWiki משתמשת ב-Composer לניהול ספריות PHP חיצוניות, שכולן מגיעות לספריית vendor/ בספריית ה-MediaWiki שלכם.

כדי להתקין את הספריות הדרושות הללו, יש לכם בחירה:

• להוריד ולהתקין את ה-composer PHAR, באופן אופציונלי שנו את שם הקובץ composer.phar לפי ההוראות עבור מערכת ההפעלה שלכם, ולאחר מכן הפעילו את composer update --no-dev מספריית ה-MediaWiki שלכם. זו הגישה המומלצת.
  • אם גרסת ברירת המחדל של PHP CLI אינה תואמת את גרסת ה-PHP של שרת האינטרנט, ציינו אותה עם למשל. php7.4 composer.phar update --no-dev.
• לחלופין, אם אינכם רוצה להשתמש ב-Composer או אם ברצונכם להשתמש בדיוק באותה קבוצה של ספריות ספקים כמו שבה נעשה שימוש באשכול הייצור של WMF (קרן הויקימדיה), תוכלו במקום זאת ליצור ספריית vendor/ בתוך תיקיית הליבה של התקנת ה-MediaWiki שלכם:
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • שימו לב שאם לאחד מהתוספים שלכם יש דרישות משלהם ל-Composer, אז אינכם יכולים להשתמש באפשרות זו.

לפני MediaWiki 1.25, ספריות חיצוניות נשמרו במאגר הליבה, ולא נדרש מנהל חבילות.

התעדכנות

אם אתם משתמשים בענף מסוים או בגרסת הפיתוח ("ענף מאסטר") של MediaWiki, קל יחסית לאסוף את השינויים האחרונים. עברו לספריית השיבוט של MediaWiki שלכם והפיקו פקודה זו:

git pull

כל השינויים האחרונים עבור הסניף שבו אתם משתמשים יחולו.

הגרסה החדשה של core עשויה לדרוש גרסאות חדשות יותר של הרחבות וגוונים, לכן עליכם להיכנס לכל הרחבה וספריית גוון ולעדכן אותה בפקודה כמו git pull --recurse-submodules.

אתם גם צריכים לעדכן את vendor/ עם כל הגרסאות החדשות יותר של הספריות הנדרשות. לעתים קרובות משמעות הדבר היא להפעיל את פקודת ה-Composer הבאה, אך עיינו ב#הבאת ספריות חיצוניות למעלה לפרטים נוספים:

composer update --no-dev

לאחר עדכון/שדרוג הקוד והספריות הנדרשות, עליכם להפעיל את סקריפט שורת הפקודה update.php של מדיה-ויקי כדי לעדכן טבלאות מסד נתונים לפי הצורך:

php maintenance/run.php update

אם אתם משתמשים ב-MediaWiki-Vagrant , הוא מציע פקודה אחת, vagrant git-update, שמבצעת את כל השלבים האלה.

מעבר לגרסה אחרת

כל אחת מהגרסאות שלנו נמצאות במעקב כענפים או כתגים. על מנת לעבור לגרסה אחרת (למשל מענף master לענף או תג אחר), פנו את הענף או את התג הספציפיים שאתם רוצים מתוך ספריית השיבוט של ה-MediaWiki שלכם:

git checkout <שם_גרסה>

או

git checkout <שם_תג>

השינויים יחולו אוטומטית ותוכלו לצאת לדרך.

שימוש ב-Git להורדת הרחבות MediaWiki

רשימת הרחבות ב-git

הורדת הרחבה

בפקודות הבאות, החליפו את ‎<EXT> בשם התוסף שברצונכם להוריד, ללא רווחים. עברו אל Extension:TitleKey , זה יהיה TitleKey. (רגיש לאותיות גדולות!)

הורידו ושכפלו הרחבה מ-Git:

עם חשבון המפתח שלכם, השתמשו בפקודות הבאות כדי לקבל את הענף הראשי:

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

כדי לשכפל ולפנות ענף שחרור יציב במקום זאת, השתמשו בפקודות הבאות:

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

אתם יכולים להציג את קוד המקור של התוסף ביישום Gerrit's gitiles ובכתובת האתר:

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

הורדת כל ההרחבות

אם אתם מעדיפים שכל תוספי MediaWiki שנמצאים ב-gerrit.wikimedia.org יצאו למחשב שלכם, הזינו את הפרטים הבאים:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions

לחלופין, כדי לסגור ענף מהדורות יציבות במקום זאת, השתמשו בפקודה זו:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_43

לאחר הפעלת הפקודה git clone, המשיכו עם הפקודות הבאות:

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_42 origin/REL1_42 || :'

זכרו כי עליכם להשתמש רק בגרסאות של הרחבות מאותה מהדורה של אותה גרסה של MediaWiki וזו של זו.

כדי לעקוב אחר ענף המאסטר:

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

שים לב שאין להשתמש בקוד מאסטר לייצור בשום פנים ואופן מכיוון שהוא לא נחשב יציב.

אם אתם צריכים רק לפנות לקריאה בלבד (למשל כדי לתפוס או לנתח את כל הקוד של MediaWiki), אתם יכולים להשתמש בפינוי MediaWiki המשותפת ב-Labs, מבלי להוריד שום דבר במחשבים שלכם.

הסרת הרחבה

1. הסירו את ה-"require_once …" או "wfLoadExtension( … )" מ-LocalSettings.php
2. הסירו כל שורה המתייחסת לתוסף ב-composer.local.json (בדרך כלל בקטע "extra → merge-plugin → include")
3. הסירו את ספריית התוסף ב-install-dir/extensions/

שימוש ב-Git כדי להוריד גוונים של MediaWiki

רשימת גוונים (סקינים) ב-git

MediaWiki 1.24 ואילך אינם כוללים גוונים בהורדה של Git.

בצעו את אותו הליך בדיוק כמו עבור הרחבות (מתואר בסעיף הקודם), אך השתמשו ב-skins במקום extensions בכל כתובות האתרים והנתיבים.

הוראות התקנה מפורטות זמינות בדף של כל גוון כאן ב- MediaWiki.org, למשל ראו Skin:Vector#Installation. הוראות לכל שאר הגוונים הן מקבילות.

נספחים

העדכון נכון ל-14:26, 21 במרץ 2019 שינה את תקן הקישור אל gerrit.wikimedia.org:

מ:

gerrit.wikimedia.org/r/p/mediawiki

ל:

gerrit.wikimedia.org/r/mediawiki