מרכז המפתחים
זוהי סקירה כללית של פיתוח מדיה־ויקי, הכוללת קישורים למסמכים, למשאבים ולכלים המרכזיים העומדים לרשות מפתחי מדיה־ויקי. הסקירה נכתבה למפתחי LAMP מיומנים בעלי ניסיון בשימוש במדיה־ויקי.
- אם ברצונכם להשתמש בממשקי ה־API המקוונים של ויקימדיה, בקרו בפורטל המפתחים.
- אם ברצונכם לתרום לפיתוח התוכנות של ויקימדיה, ראו מפתחים חדשים.
- להיכרות ראשונית עם פיתוח מדיה־ויקי והרחבותיה, קראו את המדריך כיצד להפוך למתכנת מדיה־ויקי.
- אם ברצונכם לשתף פעולה עם משתמשי מדיה־ויקי אחרים מחוץ לוויקימדיה, קבוצת בעלי העניין של מדיה-ויקי (MWStake) היא קבוצת משתמשים של מדיה־ויקי הכוללת מפתחי מדיה־ויקי, מנהלי מערכות, משתמשים, יועצים וספקי שירותי אחסון.
סקירה כללית
מדיה־ויקי היא התוכנה שמפעילה את ויקיפדיה, את מיזמי האחות שלה ואלפי אתרי ויקי ברחבי העולם.
מדיה־ויקי כתובה בשפת התכנות PHP.[1] היא משתמשת ב־jQuery כספריית ה־JavaScript בצד הלקוח.
מדיה־ויקי נכתבה בעיקר עבור פלטפורמת LAMP[2] ופועלת ברוב מערכות ההפעלה. מדיה־ויקי משתמשת בעיקר בשרתי מסדי הנתונים MySQL ו־MariaDB.[3]
הפיתוח מתבצע במתכונת של קוד פתוח[4], מתואם ברובו ברשת וזוכה לתמיכתה של קרן ויקימדיה, אך גם למפתחים המתנדבים מהקהילה יש בו תפקיד מרכזי.
- דיונים בנושאי פיתוח מתקיימים ברשימות תפוצה ובערוצי IRC שונים. רשימת התפוצה העיקרית למפתחים היא wikitech-l. ערוץ ה־IRC העיקרי למפתחים הוא #mediawiki connect.
- קוד המקור מנוהל באמצעות מערכת בקרת הגרסאות Git.[5]
- סקירת הקוד ברוב המיזמים מתבצעת ב־גריט. פעלו לפי מדריך זה כדי להגדיר את Git ואת Gerrit לצורך הגשת תיקונים.
- דיווחי תקלות ומשימות ברוב המיזמים מנוהלים ב־Phabricator.
- לרשות מפתחים המרחיבים את מדיה־ויקי או מתממשקים אליה (במקום לעבוד על קוד הליבה) עומדות כמה נקודות הרחבה נוחות לשימוש, ובהן ממשק ה־API ומערכת ה־Hooks.
מסמכים מרכזיים
קוד, פיתוח וסגנון כתיבה
- מדיניות הפיתוח – סקירה כללית של כללי המדיניות המרכזיים בתחום הפיתוח.
- מוסכמות לכתיבת קוד – למדו כיצד לכתוב קוד בסגנון הנהוג במדיה־ויקי.
- Security for developers – למדו כיצד לסייע בשמירה על אבטחת מדיה־ויקי.
- Pre-commit checklist – קראו את רשימת הבדיקה הזו לפני ביצוע commit של שינויים בקוד.
- מדריך לסקירת קוד – מדריך לסוקרי שינויים (commits) בקוד המקור של מדיה־ויקי.
- Technical Decision Making Process – קראו על תהליך קבלת ההחלטות בנוגע לביצוע שינויים טכניים נרחבים.
- Developing libraries – מדריך לאריזת ספריות צד שלישי לשימוש עם מדיה־ויקי.
ניפוי שגיאות ובדיקות
- כיצד לנפות שגיאות – מדריך לניפוי שגיאות במדיה־ויקי.
- Errors and symptoms – סקירה כללית של שגיאות נפוצות במדיה־ויקי ושל התסמינים הנלווים להן.
- בדיקות בדפדפן – למדו כיצד לכתוב בדיקות לממשק המשתמש של מדיה־ויקי באמצעות Selenium.
- בדיקות יחידה – למדו כיצד לכתוב בדיקות יחידה למדיה־ויקי באמצעות PHPUnit.
- בדיקות אינטגרציה של ה־API – למדו כיצד לכתוב בדיקות אינטגרציה של ה־API למדיה־ויקי באמצעות Mocha.
- Security for developers – למדו כיצד לכתוב קוד מאובטח.
ארכיטקטורה
- MediaWiki architecture – מבוא לארכיטקטורה של מדיה־ויקי.
- Code – סקירה כללית של החלקים המרכזיים בקוד המקור של מדיה־ויקי.
- Database layout – סקירה כללית של סכמות מסדי הנתונים של מדיה־ויקי.
- Global object variables – רשימה חלקית של משתנים גלובליים מרכזיים.
- לוקליזציה – למדו על מערכת הבינאום של מדיה־ויקי.
- מרחב השם Manual באתר ויקי זה – תיעוד למפתחים.
- תיעוד המחלקות של מדיה־ויקי – תיעוד טכני שנוצר מתוך קוד המקור של מדיה־ויקי. (הערה: דף תיעוד המחלקות גדול ונטען באיטיות.)
תת־מערכות
- API – ממשק ה־API של מדיה־ויקי מספק גישה ישירה ברמת הפשטה גבוהה לנתונים השמורים במסדי הנתונים של מדיה־ויקי.
- ContentHandler – התשתית של מדיה־ויקי לתמיכה בסוגים מותאמים אישית של תוכן דפים.
- Database access – סקירה כללית של השימוש במסדי נתונים במדיה־ויקי, הכוללת מדריך קצר לשכבת ההפשטה של מסדי הנתונים.
- Job queue – התשתית של מדיה־ויקי לביצוע אסינכרוני של משימות ממושכות.
- Messages API – התשתית של מדיה־ויקי לאספקת הודעות ממשק מתורגמות באמצעות PHP או JavaScript.
הרחבת מדיה־ויקי
מדיה־ויקי תוכננה לאפשר ביצוע התאמות ללא שינוי קוד הליבה. הדבר מקל על עדכון לגרסה חדשה של מדיה־ויקי, ללא צורך למזג ידנית שינויים קודמים בקוד ההרחבות. קיימות כמה נקודות הרחבה המאפשרות למפתחים לשנות או להרחיב את יכולותיה של מדיה־ויקי.
עזרה למפתחי הרחבות
- פיתוח הרחבות – מדריך לפיתוח הרחבות.
- Extensions FAQ
- לרשימת הרחבות, ראו קטגוריה:הרחבות.
- Extension:BoilerPlate – תבנית ריקה להרחבה.
עזרה למפתחי עיצובים
- איך ליצור מראה של מדיה-ויקי – הוראות ליצירת עיצוב למדיה־ויקי.
- תצורת ערכות עיצוב – מדריך להגדרת עיצובים באתר ויקי.
עזרה למפתחי גאדג'טים
- Gadget kitchen – מדריך לפיתוח סקריפטים אישיים וגאדג'טים באתר ויקי.
עזרה למפתחי יחידות
- הוראות הפעלה – תיעוד לפיתוח יחידות Lua באתר ויקי.
- Extension:Scribunto – על ההרחבה Scribunto.
הערות
- ↑ לא כל הקוד של מדיה־ויקי כתוב ב־PHP. חלק מכלי העזר כתובים בשפות אחרות, ובהן קובצי אצווה, תסריטי מעטפת, קובצי Makefile ו־פייתון.
- ↑ מדיה־ויקי פועלת ברוב הפלטפורמות שבהן ניתן להפעיל PHP. עם זאת, היעדר כלי עזר מסוימים או תכונות מסוימות של מערכת ההפעלה עלול להגביל את יכולותיה או לפגוע בביצועיה בפלטפורמות שאינן מבוססות על LAMP.
- ↑ מדיה־ויקי תומכת במערכות לניהול מסדי נתונים נוספות מלבד MySQL ו־MariaDB, ובהן PostgreSQL ו־SQLite.
- ↑ בין המפתחים יש מתנדבים לצד עובדים בשכר (או קבלנים) מטעם ארגונים שונים. לרשימה מלאה של העוסקים בפיתוח הקוד של מדיה־ויקי, קראו את המאמר מפתחים.
- ↑ עיינו בקוד המקור ובהיסטוריית הגרסאות של מאגרי הקוד ב־Gerrit, או הורידו את קוד המקור למערכת שלכם באמצעות גריט.