|
|
| Ligne 1 : |
Ligne 1 : |
| <languages/>
| | [[file:essai.pdf]] |
| {{TOCright}}
| |
| {{Hubs|none|dev=y}}
| |
| | |
| <translate>
| |
| <!--T:1-->
| |
| '''This is a high-level overview of MediaWiki development''', including links to the key documents, resources and tools available to MediaWiki developers. It is written '''for skilled [[w:LAMP (software bundle)|LAMP]] developers who have experience using MediaWiki'''.
| |
| </translate>
| |
| | |
| * <translate><!--T:62--> If you want to ''use'' Wikimedia web APIs, visit [<tvar name=url>https://developer.wikimedia.org/use-content/</tvar> the Developer Portal].</translate>
| |
| * <translate><!--T:67--> If you want to contribute to developing Wikimedia software, see <tvar name=1>{{ll|New Developers}}</tvar>.</translate>
| |
| * <translate><!--T:2--> For an introductory guide to developing MediaWiki and MediaWiki extensions, read <tvar name=1>{{ll|How to become a MediaWiki hacker}}</tvar>.</translate>
| |
| * <translate><!--T:73--> If you want to collaborate with other third-party MediaWiki users, the <tvar name=1>{{ll|MediaWiki Stakeholders' Group}}</tvar> (MWStake) is a MediaWiki [[<tvar name=2>Special:MyLanguage/Groups</tvar>|user group]] consisting of MediaWiki developers, system administrators, users, consultants, and hosting providers.</translate>
| |
| | |
| <translate>
| |
| ==Overview== <!--T:4-->
| |
| | |
| <!--T:68-->
| |
| MediaWiki is the software that powers Wikipedia, its sister projects and thousands of wikis all over the world.
| |
| </translate>
| |
| | |
| <translate><!--T:69--> MediaWiki is written in the [<tvar name=url>https://php.net</tvar> PHP] programming language.<ref>Not all of MediaWiki is written in PHP. Some supporting tools are written in other languages, including [[w:Batch files|batch files]], [[w:Shell script|shell scripts]], [[w:Makefile|makefiles]] and [[w:Python (programming language)|Python]].</ref></translate>
| |
| <translate><!--T:70--> It uses jQuery as the client JavaScript library.</translate>
| |
| | |
| <translate><!--T:71--> MediaWiki is primarily written for the [[w:LAMP_(software_bundle)|LAMP platform]]<ref>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.</ref> and runs on most operating systems.</translate>
| |
| <translate><!--T:76--> MediaWiki primarily uses the MySQL and MariaDB database servers.<ref>MediaWiki has support for [[w:DBMS|DBMS]] other than [[w:MySQL|MySQL]] and [[w:MariaDB|MariaDB]], including [[w:PostgreSQL|PostgreSQL]] and [[w:SQLite|SQLite]].</ref></translate>
| |
| | |
| <translate>
| |
| <!--T:5-->
| |
| Development happens in an [[w:Open Source|open source]] style<ref>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 <tvar name=1>{{ll|Developers}}</tvar> article.</ref>, is largely coordinated online, and supported by the Wikimedia Foundation, though volunteer community developers play a huge part as well.
| |
| | |
| <!--T:6-->
| |
| * '''Development discussion''' happens on various [[<tvar name=1>Special:MyLanguage/Mailing lists</tvar>|mailing lists]] and [[<tvar name=2>Special:MyLanguage/MediaWiki on IRC</tvar>|IRC channels]].</translate> <translate><!--T:58--> The main developer list is <tvar name=1>[[mail:wikitech-l|wikitech-l]]</tvar>. The main developer IRC channel is <tvar name=2>{{irc|mediawiki}}</tvar>.</translate>
| |
| <translate>
| |
| <!--T:8-->
| |
| * '''Source code''' is managed using the [[w:Git (software)|Git]] version control system.</translate><ref>
| |
| <translate><!--T:66--> Browse the source code and revisions of code repositories in [<tvar name=url>https://gerrit.wikimedia.org/g/</tvar> Gerrit] or download the source code to your system by using <tvar name=2>{{ll|Gerrit}}</tvar>.</translate>
| |
| </ref>
| |
| <translate>
| |
| <!--T:9-->
| |
| * '''Code review''' for most projects is performed on <tvar name=2>{{ll|Gerrit}}</tvar>. [[<tvar name=1>Gerrit/Tutorial</tvar>|Follow this tutorial]] to set up Git and Gerrit in order to submit patches.</translate>
| |
| <translate>
| |
| <!--T:74-->
| |
| * '''Bug reports''' and tasks for most projects are managed on <tvar name=1>{{ll|Phabricator}}</tvar>.</translate>
| |
| <translate>
| |
| <!--T:10-->
| |
| * Developers '''extending''' or '''interfacing''' with MediaWiki (instead of working on the core code) have several convenient extension points, including the '''[[<tvar name=2>Special:MyLanguage/API:Main page</tvar>|API]]''', the '''[[<tvar name=1>Special:MyLanguage/Manual:Hooks</tvar>|Hooks]]''' system and '''[[<tvar name=3>Special:MyLanguage/Manual:Skins</tvar>|Skins]]''' – see the [[<tvar name=4>#Extending MediaWiki</tvar>|#Extending MediaWiki]] section of this page for an overview.
| |
| | |
| ==Key documents== <!--T:11-->
| |
| </translate>
| |
| | |
| {{ContentGrid
| |
| |content=
| |
| <!--
| |
| nowiki markers are added so the first bullet in the list are rendered correctly!
| |
| please don't remove those markers, thank you
| |
| -->
| |
| {{InfoCard
| |
| |heading = <translate><!--T:12--> Code, development and style</translate>
| |
| |content=<nowiki/>
| |
| * '''{{ll|Development policy}}''' – <translate><!--T:13--> an overview of key development policies.</translate>
| |
| <translate>
| |
| <!--T:14-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/Manual:Coding conventions</tvar>|Coding conventions]]''' – learn how to write code in the MediaWiki style.
| |
| </translate>
| |
| * '''{{ll|Security for developers}}''' – <translate><!--T:15--> learn how to help keep MediaWiki secure.</translate>
| |
| * '''{{ll|Manual:Pre-commit checklist}}''' – <translate><!--T:16--> read this checklist before committing code.</translate>
| |
| <translate>
| |
| <!--T:17-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/Gerrit/Code review</tvar>|Code review guide]]''' – a guide for reviewers of commits to the MediaWiki source code.</translate>
| |
| * '''{{ll|Technical Decision Making Process}}''' – <translate><!--T:84--> read about the process to decide on making larger technical changes.</translate>
| |
| }}
| |
| | |
| {{InfoCard
| |
| |heading = <translate><!--T:19--> Debugging and testing</translate>
| |
| |content =<nowiki/>
| |
| <translate>
| |
| <!--T:21-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/Manual:How to debug</tvar>|How to debug]]''' – a guide to debugging MediaWiki.
| |
| </translate>
| |
| * '''{{ll|Manual:Errors and symptoms}}''' – <translate><!--T:22--> an overview of common MediaWiki errors and their correlating symptoms.</translate>
| |
| * '''{{ll|Selenium|2=<translate><!--T:64--> Browser testing</translate>}}''' – <translate><!--T:23--> learn to write UI tests for MediaWiki using Selenium.</translate>
| |
| <translate>
| |
| <!--T:24-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/Manual:Unit testing</tvar>|Unit testing]]''' – learn to write unit tests for MediaWiki using PHPUnit.
| |
| </translate>
| |
| * '''{{ll|MediaWiki API Integration Tests|2=<translate><!--T:79--> API integration tests</translate>}}''' – <translate><!--T:80--> learn to write API integration tests for MediaWiki using Mocha.</translate>
| |
| * '''{{ll|Security for developers}}''' – <translate><!--T:25--> learn how to write secure code.</translate>
| |
| }}
| |
| | |
| {{InfoCard
| |
| |heading=<translate><!--T:26--> Architecture</translate>
| |
| |content=<nowiki/>
| |
| * '''{{ll|Manual:MediaWiki architecture|nsp=0}}''' – <translate><!--T:85--> an introduction to MediaWiki's architecture.</translate>
| |
| * '''{{ll|Manual:Code}}''' – <translate><!--T:27--> an overview of the key parts of MediaWiki's source code.</translate>
| |
| * '''{{ll|Manual:Database layout}}''' – <translate><!--T:28--> an overview of MediaWiki's database schemas.</translate>
| |
| * '''{{ll|Manual:Global object variables}}''' – <translate><!--T:29--> a partial list of key global variables.</translate>
| |
| * '''{{ll|Localisation}}''' – <translate><!--T:30--> learn about MediaWiki's internationalisation system.</translate>
| |
| <translate>
| |
| <!--T:31-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/Manual:Contents</tvar>|Manual]]''' namespace on this wiki – documentation for developers.</translate>
| |
| <translate>
| |
| <!--T:32-->
| |
| * '''[<tvar name=url>https://doc.wikimedia.org/mediawiki-core/master/php/</tvar> MediaWiki Class Reference]''' – technical documentation generated from the MediaWiki source code. ('''Note:''' The class reference is a large, slow-to-load page.)
| |
| </translate>
| |
| }}
| |
| | |
| {{InfoCard
| |
| |heading =<translate><!--T:34--> Sub-systems</translate>
| |
| |content=<nowiki/>
| |
| <translate>
| |
| <!--T:35-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/API:Main page</tvar>|API]]''' – MediaWiki's API provides direct, high-level access to the data contained in the MediaWiki databases.</translate>
| |
| * '''{{ll|Manual:ContentHandler|nsp=0}}''' – <translate><!--T:36--> MediaWiki's framework for supporting custom types of page content.</translate>
| |
| * '''{{ll|Manual:Database access|nsp=0}}''' – <translate><!--T:37--> an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.</translate>
| |
| * '''{{ll|Manual:Job queue|nsp=0}}''' – <translate><!--T:38--> MediaWiki's framework for processing long-running tasks asynchronously.</translate>
| |
| * '''{{ll|Manual:Messages API|nsp=0}}''' – <translate><!--T:39--> MediaWiki's framework for providing localized application messages with PHP or JavaScript.</translate>
| |
| | |
| }}
| |
| }}
| |
| | |
| <translate>
| |
| == Extending MediaWiki == <!--T:40-->
| |
| | |
| <!--T:41-->
| |
| 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 six main extension points that allow developers to change or extend what MediaWiki can do. The extension points are:
| |
| | |
| <!--T:42-->
| |
| * '''[[<tvar name=1>Special:MyLanguage/API:Action API</tvar>|API]]''' – access the data and metadata of MediaWiki instances through its web API.
| |
| </translate>
| |
| * '''{{ll|Manual:Hooks|nsp=0}}''' – <translate><!--T:43--> every time a given event happens, do something.</translate>
| |
| * '''{{ll|Manual:Parser functions|nsp=0}}''' – <translate><!--T:44--> create a new command like: <tvar name=1><code><nowiki>{{#if:...|...|...}}</nowiki></code></tvar>.</translate>
| |
| * '''{{ll|Manual:Skins|nsp=0}}''' – <translate><!--T:45--> change the look and feel of MediaWiki.</translate>
| |
| * '''{{ll|Manual:Special pages|nsp=0}}''' – <translate><!--T:46--> add a new special page.</translate>
| |
| * '''{{ll|Manual:Tag extensions|nsp=0}}''' – <translate><!--T:47--> create a new tag like: <tvar name=1>{{tag|newtag}}</tvar>.</translate>
| |
| * '''{{ll|Manual:Extending wiki markup|nsp=0}}''' – <translate><!--T:75--> add a parser hook to modify the content of wikitext.</translate>
| |
| | |
| {{ContentGrid
| |
| |content =
| |
| | |
| {{InfoCard
| |
| |heading=<translate><!--T:48--> Help for extension developers</translate>
| |
| |content=<nowiki/>
| |
| * '''{{ll|Manual:Developing extensions}}''' – <translate><!--T:49--> a guide to developing extensions.</translate>
| |
| * '''{{ll|Extensions FAQ}}'''
| |
| * <translate><!--T:81--> See <tvar name=1>{{ll|Category:Extensions}}</tvar>, for a list of extensions.</translate>
| |
| * '''{{ll|Extension:BoilerPlate}}''' - <translate><!--T:83--> a blank extension template.</translate>
| |
| }}
| |
| | |
| {{InfoCard
| |
| |heading=<translate><!--T:50--> Help for skin developers</translate>
| |
| |content=<nowiki/>
| |
| * '''{{ll|Manual:How to make a MediaWiki skin}}''' – <translate><!--T:51--> instructions on how to create a skin for MediaWiki.</translate>
| |
| * '''{{ll|Manual:Skin configuration}}''' – <translate><!--T:86--> a guide to configuring skins for a wiki.</translate>
| |
| }}
| |
| | |
| {{InfoCard
| |
| |heading=<translate><!--T:56--> Help for library code reuse</translate>
| |
| |content=<nowiki/>
| |
| * {{ll|Manual:Developing libraries}} – <translate><!--T:57--> a guide to packaging third-party libraries for use with MediaWiki</translate>
| |
| }}
| |
| | |
| }}
| |
| <translate>
| |
| ==Notes== <!--T:54-->
| |
| </translate>
| |
| <references />
| |
| | |
| [[Category:MediaWiki development{{#translation:}}|*Developer hub]]
| |
| [[Category:New contributors{{#translation:}}]]
| |
