Download from Git/es

Git, sistema de control de versiones distribuido. Te permite descargar la versión más actual del código Fuente, con todas las Ramas y lanzamientos etiquetados a tu disposición.

Tendrías que descargar de Git, si eres desarrollador y quieres enviar parches.

Si tu no deseas desarrollar, sino solamente instalar MediaWiki y extensiones, entonces descarga lanzamientos de tarball estables

Véase Git para más detalles, especialmente para hacer contribuciones. Debajo se muestran algunas indicaciones rápidas para un par de tareas comunes.

Requisitos previos
Debe tener Git instalado antes de poder usarlo. Hay muchas formas distintas de adquirir Git, dependiendo de tu sistema operativo. Sigue Gerrit/Tutorial#instalar Git, o usa tu motor de búsqueda favorito.

Es recomendable, aunque no un requisito, tener instalado para descargar e instalar bibliotecas de terceros.

Descarga
Puedes descargar el núcleo de MediaWiki usando Git, así como todas las extensiones instaladas actualmente en el clúster de servidores de la Fundación Wikimedia y otras tantas extensiones alojadas en.

El primer paso es clonar el repositorio del nucleo de MediaWiki. Esto puede tardar un tiempo.

Descarga para desarrollo
La última versión de desarrollo de MediaWiki está avanzada en la rama 'maestro'.

Primero, este seguro de tener creada unacuenta de desarrollador, de modo que tenga un nombre de usuario ssh.

Luego, en una ventana de terminal, introduce el siguiente comando para clonar tu nombre de usuario ssh, de esta manera podrás enviar parches para que los revisen.

Esto clona todo el repositorio principal de MediaWiki, desde la rama maestra, en un subdirectorio llamado.

Para instalar en un directorio diferente, cámbialo en la línea de comandos (para más información referido a estos documentos). Una vez que el repositorio sea clonado, puedes cambiar fácilmente a diferentes ramas o etiquetas. La rama de desarrollo,, es la versión de desarrollo más vanguardista de MediaWiki; no debes usar el código maestro en producción bajo ninguna circunstancia mientras no se considere estable.



Descarga una rama estable
Si no deseas desarrollar parches de software, pero deseas anónimamente clonar la rama estable liberada, haz uso de este comando en su lugar.

Si tu conexión a internet va lenta y deseas reducir el número de revisiones clonadas, añade  al comando.

Etiquetas de MediaWiki (versión estable)
Alternativamente, las versiones específicamente estables de MediaWiki son rastreadas usando 'etiquetas', estas son análogas a las liberaciones de tarball. Actualmente estas son, (estable),  (LTS) y  (legado).

Puedes ver todas las etiquetas disponibles con:

Para utilizar una etiqueta concreta, p. ej. la última liberación estable:

Actualización submódulos Git
Las ramas tienen un abanico de submódulos de Git en ellas, para extensiones y máscaras de uso común (la rama maestra no las tiene). Para actualizar los submódulos, ejecuta:

Obtener bibliotecas externas
MediaWiki utiliza para administrar bibliotecas externas PHP, todo lo cual termina en la carpeta   de tu directorio de MediaWiki.

Para instalar estos necesitaron bibliotecas, tienes una elección:


 * Descarga e instala compositor PHAR, opcionalmente cambie el nombre del archivo composer.phar como se indica para su sistema operativo y luego ejecute  desde su directorio MediaWiki. Este es el enfoque recomendado.
 * O si no quieres usar Composer, o si lo que quieres usar es exactamente el mismo conjunto de bibliotecas de proveedor como las utilizadas en el grupo de producción de la Fundación Wikimedia, puedes crear en su lugar un directorio  dentro de la carpeta principal de tu instalación MediaWiki.
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Ten en cuenta que si alguna de tus extensiones tiene sus propios requisitos de Compositor, entonces no puedes usar esta opción.

Con anterioridad a MediaWiki 1.25, las bibliotecas externas se guardaban en el repositorio principal y ningún gestor de paquetes fué requerido.

Manténte al día
Si estás usando una rama en particular o la versión de desarrollo (rama «maestra») de MediaWiki, obtener los últimos cambios es relativamente fácil. Cambia al directorio en el que clonaste MediaWiki y emite esta orden:

Se aplicarán todos los cambios más recientes a la rama que estás utilizando.

Puede que la nueva versión del núcleo requiera versiones más nuevas de extensiones y apariencias, por lo que deberás entrar en ambos directorios y descargar ambas actualizaciones con un comando como.

También necesitas actualizar  con la versión más reciente de las bibliotecas requeridas. Esto a menudo significa ejecutar el siguiente comando de Compositor, consulta #Obtener bibliotecas externas para más detalles:

Después de actualizar el código y las bibliotecas requeridas, debes ejecutar el script de línea de comandos de MediaWiki  para actualizar las tablas de la base de datos según sea necesario:

Si empleas MediaWiki-Vagrant, puedes usar su comando único $comando, que ejecuta todos estos pasos.

Cambiar a una versión distinta
Cada una de nuestras versiones son rastreadas como ramas o etiquetas. Para cambiar a una versión diferente (por ejemplo de la rama  a una rama o etiqueta diferente), checkout la rama o etiqueta particular que quieras en el directorio donde clonaste MediaWiki.

o

Los cambios serán aplicados automáticamente y estarás listo para trabajar.

Utilizando Git para descargar extensiones de MediaWiki

 * Lista de extensiones en git

Descarga una extensión

 * "En las próximas instrucciones, reemplaza por el nombre de la extensión que quieras descargar, sin espacios. Para, sería TitleKey. (¡respetando mayúsculas y minúsculas!)''

Descarga y clona una extensión desde Git:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

Puedes ver el código fuente de la extensión en la aplicación Gerrit's gitiles y en la URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

Descarga todas las extensiones
Si prefiere tener "todas" las extensiones de MediaWiki que están en gerrit.wikimedia.org desprotegidas en su máquina, ingrese lo siguiente:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

En cualquier momento, para actualizar todas las extensiones a las últimas versiones de esa rama, introduce:

Para cambiar a una rama diferente, como después de una liberación nueva:

Recuerda que solo debes usar versiones de extensiones de la misma liberación que esa versión de MediaWiki y entre sí.

Para seguir la rama maestra:

Ten en cuenta que no debes usar el código maestro en producción bajo ninguna circunstancia ya que no se considera estable.

Si solo necesitas un despliegue de solo lectura (por ejemplo, para grep o para analizar todo el código de MediaWiki), puedes usar el despliegue MediaWiki compartido en Labs sin tener que descargar nada en tu equipo.

Eliminar una extensión

 * 1) Borra « » o « » de
 * 2) Borra cualquier línea que haga referencia a la extensión en   (generalmente en le sección «extra → merge-plugin → include»)
 * 3) Borra el directorio de la extensión en

Usando Git para descargar temas/máscaras de MediaWiki

 * Lista de apariencias en git

MediaWiki 1.24 y posteriores no incluyen apariencias en la descarga por Git.

Sigue exactamente el mismo procedimiento que para las extensiones (descrito en la sección previa), pero usa  en vez de   en todas las URLs y rutas.

Hay instrucciones detalladas de instalación en las respectivas páginas de cada apariencia aquí en MediaWiki.org. Por ejemplo, véase Apariencia:Vector#Instalación. Las instrucciones para otras apariencias son análogas.

Véase también

 * Intranet/Intranet Installation, parte de una serie completamente trabajada de artículos que utiliza Git para el despliegue de MediaWiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki