Download from Git/es

Git, sistema de control de versiones distribuido. It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

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. Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

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

Descarga
Puedes descargar el núcleo de MediaWiki usando Git, así como todas las extensiones instalada 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 de MediaWiki. Esto puede tardar un tiempo.

Descarga para desarrollo
La última versión de desarrollo de MediaWiki avanza en la rama 'master'.

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

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

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

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



Download a stable branch
Si no desea desarrollar parches de software, pero desea anónimamente clonar la rama deliberación estable, haga uso de este comando en su lugar.

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

Etiquetas de MediaWiki (versión estable)
Alternativamente, las versiones estables de MediaWiki se siguen usando las 'etiquetas', que son análogas a las versiones de tarball. Actualmente son estas (estable),  (LTS) y  (heredado).

Puedes ver todas las etiquetas disponibles con:

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

Update the Git submodules
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 Composer para administrar bibliotecas externas de PHP, todas las cuales terminan en la carpeta  de tu directorio de MediaWiki.

Para instalar estas bibliotecas necesarias, puedes elegir:


 * Descarga e instala composer PHAR, opcionalmente, cambia el nombre del archivo composer.phar como se indica para tu sistema operativo y luego ejecuta  desde tu directorio MediaWiki. Esta es la forma recomendada de hacerlo.
 * Si no quiere usar Composer, o si lo que desea es usar el mismo conjunto de bibliotecas de proveedores que se utiliza en el clúster de producción de la Fundación Wikimedia, puede en su lugar crear un directorio  dentro de la carpeta principal de su 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 Composer, entonces no puedes usar esta opción.

Antes de MediaWiki 1.25, las bibliotecas externas se guardaban en el repositorio principal y no se necesitaba ningún gestor de paquetes.

Cómo actualizar
Si estás usando una rama en particular o la versión de desarrollo (rama «master») de MediaWiki, obtener los últimos cambios es relativamente fácil. Cambia al directorio en el que clonaste MediaWiki y usa el comando siguiente:

Se aplicarán todos los cambios más recientes de la rama que estás usando.

Es posible que la nueva versión de núcleo requiera versiones más nuevas de extensiones y apariencias, lo que significa que deberás ir a ambos directorios y ejecutar ambas actualizaciones con un comando como.

También tendrás que actualizar  a cualquier versión más reciente de las bibliotecas necesarias. Esto a menudo significa ejecutar el siguiente comando de Composer, consulta #Obtener bibliotecas externas para más detalles:

Después de actualizar el código y las bibliotecas necesarias, 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, 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 para cambiar de la rama  a otra rama o etiqueta diferentes), checkout a la rama o etiqueta particularmente deseada, e introducirla en el directorio en el que clonaste MediaWiki.

o

Los cambios se aplicarán automáticamente y todo estará listo para trabajar.

Uso de Git para descargar extensiones de MediaWiki

 * Lista de extensiones en git

Descargar una extensión

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

Descarga y clonado de 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 gitiles de Gerrit y en la URL:

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

Descargar todas las extensiones
Si prefieres tener en tu máquina todas las extensiones de MediaWiki que hay en gerrit.wikimedia.org, ejecuta los siguientes comandos:

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 cuando hay una nueva versión:

Recuerda que solo debes usar la misma versión en las extensiones que la versión de MediaWiki.

Para seguir la rama principal:

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