Developer hub/ca

Això és una vista general del desenvolupament de MediaWiki, amb enllaços cap als documents essencials, els recursos i les eines disponibles als desenvolupadors de MediaWiki. Està escrita per a desenvolupadors de LAMP experts que tenen experiència amb MediaWiki.


 * Si voleu utilitzar les APIs web de Wikimedia, visiteu el Centre d'APIs web (encara en desenvolupament).
 * If you want to contribute to developing Wikimedia software, see New Developers.
 * Per a una guia introductòria al desenvolupament de MediaWiki, llegiu Com esdevenir desenvolupador de MediaWiki.

Visió general
MediaWiki es desenvolupa en un estil de codi obert mitjançant el llenguatge de programació PHP principalment per a la plataforma LAMP. El desenvolupament del nucli es coordina en gran part en línia.


 * La discussió sobre el desenvolupament es realitza a diverses llistes de correu i canals d'IRC. La llista de correu principal és wikitech-l. Els canals d'IRC principals són #mediawiki i #wikimedia-dev.
 * El codi font es gestiona mitjançant el sistema de control de versions Git.


 * La revisió de codi es realitza a . Per configurar Git i Gerrit de manera que pugueu enviar pedaços, seguiu aquest tutorial.
 * Bug reports and tasks for most projects are managed on Phabricator.
 * Els desenvolupadors que creen extensions o utilitzen la interfície de MediaWiki (en comptes de treballar al codi del nucli) tenen disponibles diversos punts d'extensió molt pràctics: l'API, el sistema de hooks i les aparences – vegeu la secció #Estendre MediaWiki d'aquesta pàgina per fer-vos-en una idea.

Documents essencials


Codi, desenvolupament i estil

 * Normativa de desenvolupament – un resum de les normes de desenvolupament essencials.
 * Convencions de programació – apreneu a escriure el codi a l'estil de MediaWiki.
 * Seguretat per a desenvolupadors – apreneu com podeu col·laborar a mantenir segur MediaWiki.
 * Llista de comprovació pre-contribució – llegiu aquesta llista de comprovació abans de contribuir codi.
 * Guia de la revisió de codi – una guia per als revisors de les contribucions al codi font de MediaWiki.
 * Demandes de comentaris (RFC) – llegiu sobre les característiques noves de l'ecosistema de MediaWiki, o suggeriu-ne.

Depuració i verificació

 * Com depurar – una guia per depurar MediaWiki.
 * Manual:Errors i símptomes – un resum dels errors comuns de MediaWiki i els símptomes corresponents.
 *  – apreneu a escriure verificacions de la interfície d'usuari de MediaWiki mitjançant Selenium.
 * Verificació unitària – apreneu a escriure verificacions unitàries per a MediaWiki mitjançant PHPUnit.
 *  – apreneu a escriure codi segur.



Arquitectura

 * Manual:Codi – un resum de les parts essencials del codi font de MediaWiki.
 * Disposició de la base de dades – un resum dels esquemes de la base de dades de MediaWiki.
 * Variables d'objecte globals – una llista parcial de les variables globals essencials.
 * Localisation - Descripció tècnica de la internacionalització (I18N) de MediaWiki.
 * Espai de noms Manual d'aquest wiki – documentació per als desenvolupadors.
 * [//doc.wikimedia.org/mediawiki-core/master/php/ Documentació sobre les classes de MediaWiki] – documentació tècnica generada a partir del codi font de MediaWiki. (Nota: És una pàgina llarga i lenta de carregar.)
 *  – manuals, guies, col·leccions d'articles

Sub-sistemes

 * API – L'API de MediaWiki proporciona un accés directe i d'alt nivell a les dades que hi ha a les bases de dades de MediaWiki
 * ContentHandler – el marc de MediaWiki per admetre les pàgines amb tipus de contingut personalitzats.
 *  – un resum de l'ús de les bases de dades a MediaWiki, amb una breu guia sobre la capa d'abstracció de bases de dades.
 *  – el marc de MediaWiki per processar asíncronament tasques de llarga durada.
 *  – el marc de MediaWiki per proporcionar missatges d'aplicació traduïts, mitjançant PHP o JavaScript.

Estendre MediaWiki
MediaWiki ha estat dissenyat per a permetre una modificació sense canviar el "codi bàsic". Això fa molt fàcil l'actualització a una nova versió de MediaWiki sense haver de fusionar manualment les modificacions aportades. Hi ha 6 punts principals d'extensió que permeten als desenvolupadors afegir característiques i funcionalitats de MediaWiki o canviar les funcions existents. Aquests punts principals són :


 * API – per accedir a les dades i les metadades dels exemplars de MediaWiki a través de l'API web
 * Hooks – Cada cop que succeeix "X", aleshores realitza...
 * Parser Functions - Crea una nova ordre com:
 * Skins – Canvia l'aparença de MediaWiki
 * Special Pages - Crea una nova pàgina especial.
 * Tag Extensions – Crea una nova etiqueta com:

Ajuda per als autors d'extensions

 * Manual:Developing extensions – a guide to developing extensions.
 * Project:WikiProject Extensions
 * Extensions FAQ
 * Extension Matrix – Una llista millor, autogenerada. See also Category:Extensions, a less complete list of extensions.
 * Manual:$wgExtensionFunctions – use to defer setup (or run other callbacks) for extensions until after the MediaWiki core is setup.

Aparença

 * Manual:Skinning Part 1 – instruccions per crear una aparença de MediaWiki.
 * Manual:Skin configuration – una guia per configurar les aparences d'un wiki.

Ajuda per reutilitzar codi de biblioteques

 * – una guia per empaquetar llibreries de tercers per poder-les utilitzar amb MediaWiki

Ús en wikis de tercers

 * - Per a wikis d'empresa
 * - Per a wikis acadèmics