Developer hub/es



Esta es una descripción de alto nivel del desarrollo de MediaWiki que incluye enlaces a los documentos relevantes, recursos y herramientas disponibles a los desarrolladores de MediaWiki. Está escrito para desarrolladores especializados en LAMP con experiencia en el uso de MediaWiki.

Como guía introductoria al desarrollo de MediaWiki, lee how to become a MediaWiki hacker.

Puedes encontrar ayuda para la instalación o personalización de MediaWiki en Sysadmin hub y para la utilización de MediaWiki en User hub.

Descripción
MediaWiki está desarrollado al estilo código abierto usando el lenguaje de programación PHP principalmente para la plataforma LAMP. El desarrollo principal se coordina en gran parte online.


 * La discusión sobre el desarrollo se realiza en varias mailing lists y canales IRC. La principal lista del desarrollador es wikitech-l. Los canales del desarrollador son #mediawiki y #wikimedia-dev. Lee el artículo Developers para hacerte una idea de quien es la gente de las listas y los canales IRC.


 * El código fuente se gestiona mediante el sistema de control de revisiones Git. Lee el artículo Git para hacerte una idea de cómo utilizan Git los desarrolladores de MediaWiki. Lee el artículo [wikitech:Help:Access#Access FAQ] si quieres obtener acceso.


 * La revisión del código se realiza en Gerrit. Consulta este tutorial para ponerte en marcha con git y gerrit y poder someter parches.


 * Developers extending or interfacing with MediaWiki (instead working on the core code) have several convenient extension points, including the API, the Hooks system and Skins – see the #Extending MediaWiki section of this page for an overview.

Documentos relevantes


Código, desarrollo y estilo

 * Development policy: descripción de las principales políticas de desarrollo.


 * Coding conventions: aprende a escribir el código PHP al estilo de MediaWiki.


 * Security for developers: aprende a que MediaWiki esté segura.


 * Pre-commit checklist: lee esta lista de verificación antes de confirmar código.


 * Code review guide: guía para revisores de commits en el código fuente de MediaWiki.


 * Requests for Comment (RfC): para leer o sugerir nuevas funciones para el ecosistema de MediaWiki.

Depuración y pruebas

 * Bugs: una descripción del seguimiento de errores en el proyecto MediaWiki.


 * How to debug: guía para depurar MediaWiki.


 * Manual:Errors and Symptoms: una descripción de errores más comunes en MediaWiki y los síntomas relacionados.


 * Selenium Framework: aprende a escribir pruebas de usabilidad para MediaWiki con Selenium.


 * Unit testing: aprende a escribir pruebas unitarias para MediaWiki con PHPUnit.


 * Security: los problemas de seguridad se notifican en [mailto:security@wikimedia.org security@wikimedia.org].



Arquitectura

 * Manual:Code: una descripción de las partes principales en el código fuente de MediaWiki.


 * Database layout: una descripción de los esquemas en las bases de datos de MediaWiki.


 * Global object variables: una lista de las principales variables globales.


 * Localisation: aprende el sistema de internacionalización de MediaWiki.


 * Manual namespace en esta wiki: documentación para desarrolladores.


 * MediaWiki Class Reference: documentación técnica generada del código fuente de MediaWiki. (Nota: La referencia de clase es un página de carga lenta.)


 * MediaWiki Virtual Library: manuales, guías, colecciones de artículos seleccionados.

Subsistemas

 * API: la API de MediaWiki provee un acceso directo de alto nivel a los datos en las bases de datos de MediaWiki


 * ContentHandler: la infraestructura de MediaWiki para soportar tipos personalizados de contenido de página.


 * Database access: descripción de la utilización de las bases de datos en MediaWiki. Se incluye una guía breve de la capa de abstracción.


 * Job queue: infraestructura de MediaWiki para procesar tareas largas asincrónicamente.


 * Messages API: infraestructura de MediaWiki para proveer mensajes localizados de la aplicación con PHP o JavaScript.

Ampliación de MediaWiki
MediaWiki ha sido diseñada para permitir modificaciones sin cambiar el "código del núcleo". Así se facilita la actualización a una nueva versión sin necesidad de fusionar manualmente en cambios del código anteriores. Hay varios puntos principales por extender que permiten cambiar o expandir lo que hace MediaWiki. Los puntos por extender son:


 * API: para acceder a los datos y metadatos de instancias de MediaWiki por medio de una potente API de web


 * Hooks: cada vez que un determinado event ocurre haz algo.


 * Parser Functions: para crear un nuevo comando como:


 * Skins: para cambiar la apariencia y la sensación de MediaWiki.


 * Special Pages: para añadir una página especial nueva.


 * Tag Extensions: para crear una nueva etiqueta como:

Ayuda para programadores de extensiones

 * Manual:Developing extensions: guía para desarrollar extensiones.
 * Project:WikiProject Extensions
 * Extensions FAQ
 * Consulta la lista de Category:Extensions.
 * Manual:$wgExtensionFunctions: para retrasar la instalación de extensiones (o ejecutar otras callbacks) para después de que el núcleo de MediaWiki esté preparado.
 * Extension:BoilerPlate: una plantilla de extensión en blanco.

Ayuda para los desarrolladores de la skin

 * Manual:Skinning: instrucciones para crear una skin de MediaWiki.
 * Manual:Skin configuration: guía para configurar una skin en una wiki.

Usos de Third-party wiki

 * Enterprise hub: para Enterprise wikis
 * Academic hub: para Academic wikis