Developer hub/he
זוהי סקירה כללית של פיתוח מדיה-ויקי, הכוללת קישורים למסמכים, משאבים וכלים מרכזיים הזמינים למפתחי מדיה-ויקי. היא נכתבה למפתחי LAMP מיומנים בעלי ניסיון בשימוש במדיה-ויקי.
- אם ברצונך להשתמש בממשקי ה-API של ויקימדיה, בקר בפורטל המפתחים.
- אם ברצונך לתרום לפיתוח תוכנת ויקימדיה, ראה מפתחים חדשים.
- למדריך מבוא לפיתוח תוכנת מדיה-ויקי וההרחבות של מדיה-ויקי, קרא את כיצד להפוך למומחה תוכנת מדיה-ויקי.
- אם ברצונך לשתף פעולה עם משתמשי מדיה-ויקי חיצוניים אחרים, קבוצת בעלי העניין של מדיה-ויקי (קיצור באנגלית: MWStake) היא קבוצת משתמשים של מדיה-ויקי המורכבת ממפתחי מדיה-ויקי, מפעילי מערכת, משתמשים, יועצים וספקי שירותי אחסון.
מבט כללי
מדיה-ויקי היא התוכנה שמפעילה את ויקיפדיה, את המיזמים האחיים שלה ואת אלפי אתרי ויקי ברחבי העולם.
MediaWiki is written in the PHP programming language.[1] It uses jQuery as the client JavaScript library.
MediaWiki is primarily written for the LAMP platform[2] and runs on most operating systems. MediaWiki primarily uses the MySQL and MariaDB database servers.[3]
Development happens in an open source style[4], is largely coordinated online, and supported by the Wikimedia Foundation, though volunteer community developers play a huge part as well.
- Development discussion happens on various mailing lists and IRC channels.
The main developer list is wikitech-l. The main developer IRC channel is #mediawiki connect.
- Source code is managed using the Git version control system.
- Code review for most projects is performed on גריט. Follow this tutorial to set up Git and Gerrit in order to submit patches.
- Bug reports and tasks for most projects are managed on Phabricator.
- Developers extending or interfacing with MediaWiki (instead of working on the core code) have several convenient extension points, including the API and the Hooks system.
Key documents
Code, development and style
- Development policy – an overview of key development policies.
- Coding conventions – learn how to write code in the MediaWiki style.
- Security for developers – learn how to help keep MediaWiki secure.
- Pre-commit checklist – read this checklist before committing code.
- Code review guide – a guide for reviewers of commits to the MediaWiki source code.
- Technical Decision Making Process – read about the process to decide on making larger technical changes.
- Developing libraries – a guide to packaging third-party libraries for use with MediaWiki.
Debugging and testing
- How to debug – a guide to debugging MediaWiki.
- Errors and symptoms – an overview of common MediaWiki errors and their correlating symptoms.
- Browser testing – learn to write UI tests for MediaWiki using Selenium.
- Unit testing – learn to write unit tests for MediaWiki using PHPUnit.
- API integration tests – learn to write API integration tests for MediaWiki using Mocha.
- Security for developers – learn how to write secure code.
Architecture
- MediaWiki architecture – an introduction to MediaWiki's architecture.
- Code – an overview of the key parts of MediaWiki's source code.
- Database layout – an overview of MediaWiki's database schemas.
- Global object variables – a partial list of key global variables.
- לוקליזציה – learn about MediaWiki's internationalisation system.
- Manual namespace on this wiki – documentation for developers.
- MediaWiki Class Reference – technical documentation generated from the MediaWiki source code. (Note: The class reference is a large, slow-to-load page.)
Sub-systems
- API – MediaWiki's API provides direct, high-level access to the data contained in the MediaWiki databases.
- ContentHandler – MediaWiki's framework for supporting custom types of page content.
- Database access – an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.
- Job queue – MediaWiki's framework for processing long-running tasks asynchronously.
- Messages API – MediaWiki's framework for providing localized application messages with PHP or JavaScript.
Extending MediaWiki
MediaWiki has been designed to allow for modification without changing the core code. This makes it easy to update to a new version of MediaWiki without having to manually merge in old extension code changes. There are several extension points that allow developers to change or extend what MediaWiki can do.
Help for extension developers
- Developing extensions – a guide to developing extensions.
- Extensions FAQ
- See קטגוריה:הרחבות, for a list of extensions.
- Extension:BoilerPlate – a blank extension template.
Help for skin developers
- איך ליצור מראה של מדיה-ויקי – instructions on how to create a skin for MediaWiki.
- תצורת ערכות עיצוב – a guide to configuring skins for a wiki.
Help for gadget developers
- Gadget kitchen – a guide to developing user scripts and gadgets on wiki.
Help for module developers
- הוראות הפעלה – documentation for developing Lua modules on wiki.
- Extension:Scribunto – about the Scribunto extension.
Notes
- ↑ Not all of MediaWiki is written in PHP. Some supporting tools are written in other languages, including batch files, shell scripts, makefiles and Python.
- ↑ MediaWiki runs on most platforms that can support PHP, however, the lack of certain utilities or operating system features may limit the functionality or performance of MediaWiki on non-LAMP platforms.
- ↑ MediaWiki has support for DBMS other than MySQL and MariaDB, including PostgreSQL and SQLite.
- ↑ Developers are a mix of volunteers and paid staff (or contractors) for various organizations. For a full list of who works on the MediaWiki code, read the מפתחים article.
- ↑ Browse the source code and revisions of code repositories in Gerrit or download the source code to your system by using גריט.