Jump to content

מרכז המפתחים

From mediawiki.org
This page is a translated version of the page Developer hub and the translation is 100% complete.
  • משתמשים
  • מנהלי מערכת
  • מפתחים
  • מתרגמים
מדריך טכני זה מיועד לעוסקים בפיתוח ובתרומה טכנית, ועשוי להיות קשה להבנה לקהל הרחב המשתמש במדיה־ויקי. להדרכה כללית על השימוש במדיה־ויקי, אפשר לעיין ב־`מדריך מדיה־ויקי `.

זוהי סקירה כללית של פיתוח מדיה־ויקי, הכוללת קישורים למסמכים, למשאבים ולכלים המרכזיים העומדים לרשות מפתחי מדיה־ויקי. הסקירה נכתבה למפתחי LAMP מיומנים בעלי ניסיון בשימוש במדיה־ויקי.

סקירה כללית

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

מדיה־ויקי כתובה בשפת התכנות PHP.[1] היא משתמשת ב־jQuery כספריית ה־JavaScript בצד הלקוח.

מדיה־ויקי נכתבה בעיקר עבור פלטפורמת LAMP[2] ופועלת ברוב מערכות ההפעלה. מדיה־ויקי משתמשת בעיקר בשרתי מסדי הנתונים MySQL ו־MariaDB.[3]

הפיתוח מתבצע במתכונת של קוד פתוח[4], מתואם ברובו ברשת וזוכה לתמיכתה של קרן ויקימדיה, אך גם למפתחים המתנדבים מהקהילה יש בו תפקיד מרכזי.

  • דיונים בנושאי פיתוח מתקיימים ברשימות תפוצה ובערוצי IRC שונים. רשימת התפוצה העיקרית למפתחים היא wikitech-l. ערוץ ה־IRC העיקרי למפתחים הוא #mediawiki connect.
  • קוד המקור מנוהל באמצעות מערכת בקרת הגרסאות Git.[5]
  • סקירת הקוד ברוב המיזמים מתבצעת ב־גריט . פעלו לפי מדריך זה כדי להגדיר את Git ואת Gerrit לצורך הגשת תיקונים.
  • דיווחי תקלות ומשימות ברוב המיזמים מנוהלים ב־Phabricator .
  • לרשות מפתחים המרחיבים את מדיה־ויקי או מתממשקים אליה (במקום לעבוד על קוד הליבה) עומדות כמה נקודות הרחבה נוחות לשימוש, ובהן ממשק ה־API ומערכת ה־Hooks.

מסמכים מרכזיים

קוד, פיתוח וסגנון כתיבה

ניפוי שגיאות ובדיקות

ארכיטקטורה

  • MediaWiki architecture – מבוא לארכיטקטורה של מדיה־ויקי.
  • Code – סקירה כללית של החלקים המרכזיים בקוד המקור של מדיה־ויקי.
  • Database layout – סקירה כללית של סכמות מסדי הנתונים של מדיה־ויקי.
  • Global object variables – רשימה חלקית של משתנים גלובליים מרכזיים.
  • לוקליזציה – למדו על מערכת הבינאום של מדיה־ויקי.
  • מרחב השם Manual באתר ויקי זה – תיעוד למפתחים.
  • תיעוד המחלקות של מדיה־ויקי – תיעוד טכני שנוצר מתוך קוד המקור של מדיה־ויקי. (הערה: דף תיעוד המחלקות גדול ונטען באיטיות.)

תת־מערכות

  • API – ממשק ה־API של מדיה־ויקי מספק גישה ישירה ברמת הפשטה גבוהה לנתונים השמורים במסדי הנתונים של מדיה־ויקי.
  • ContentHandler – התשתית של מדיה־ויקי לתמיכה בסוגים מותאמים אישית של תוכן דפים.
  • Database access – סקירה כללית של השימוש במסדי נתונים במדיה־ויקי, הכוללת מדריך קצר לשכבת ההפשטה של מסדי הנתונים.
  • Job queue – התשתית של מדיה־ויקי לביצוע אסינכרוני של משימות ממושכות.
  • Messages API – התשתית של מדיה־ויקי לאספקת הודעות ממשק מתורגמות באמצעות PHP או JavaScript.

הרחבת מדיה־ויקי

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

עזרה למפתחי הרחבות

עזרה למפתחי עיצובים

עזרה למפתחי גאדג'טים

  • Gadget kitchen – מדריך לפיתוח סקריפטים אישיים וגאדג'טים באתר ויקי.

עזרה למפתחי יחידות

הערות

  1. ↑ לא כל הקוד של מדיה־ויקי כתוב ב־PHP. חלק מכלי העזר כתובים בשפות אחרות, ובהן קובצי אצווה, תסריטי מעטפת, קובצי Makefile ו־פייתון.
  2. ↑ מדיה־ויקי פועלת ברוב הפלטפורמות שבהן ניתן להפעיל PHP. עם זאת, היעדר כלי עזר מסוימים או תכונות מסוימות של מערכת ההפעלה עלול להגביל את יכולותיה או לפגוע בביצועיה בפלטפורמות שאינן מבוססות על LAMP.
  3. ↑ מדיה־ויקי תומכת במערכות לניהול מסדי נתונים נוספות מלבד MySQL ו־MariaDB, ובהן PostgreSQL ו־SQLite.
  4. ↑ בין המפתחים יש מתנדבים לצד עובדים בשכר (או קבלנים) מטעם ארגונים שונים. לרשימה מלאה של העוסקים בפיתוח הקוד של מדיה־ויקי, קראו את המאמר מפתחים .
  5. ↑ עיינו בקוד המקור ובהיסטוריית הגרסאות של מאגרי הקוד ב־Gerrit, או הורידו את קוד המקור למערכת שלכם באמצעות גריט .