Git es un sistema de control de versiones distribuido . Te permite descargar la version mas actual del codigo Fuente , con todas las Ramas y lanzamientos etiquetados a tu disposicion.

Tendrias 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

Vease Git para mas detalles, especialmente para hacer contribuciones. Debajo se muestran algunas indicaciones rapidas para un par de tareas comunes.

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 busqueda favorito.

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

Descarga

Puedes descargar el nucleo de MediaWiki usando Git, asi como todas las extensiones instaladas actualmente en el cluster de servidores de la Fundacion Wikimedia y otras tantas extensiones alojadas en Gerrit .

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

Descarga para desarrollo

La ultima version de desarrollo de MediaWiki esta avanzada en la rama 'maestro'.

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

Luego, en una ventana de terminal, introduce el siguiente comando para clonar el repositorio:

git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/core.git
 mediawiki

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

Para instalar en un directorio diferente, cambialo en la linea de comandos (para mas informacion referido a estos documentos ). Una vez que el repositorio sea clonado, puedes cambiar facilmente a diferentes ramas o etiquetas . La rama de desarrollo, master , es la version de desarrollo mas vanguardista de MediaWiki; no debes usar el codigo maestro en produccion bajo ninguna circunstancia mientras no se considere estable.

• Ver el codigo fuente mas reciente

Descarga una rama estable

Si no deseas desarrollar parches de software, pero deseas anonimamente clonar la rama estable liberada 1.41, haz uso de este comando en su lugar.

git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/core.git
 --branch
 REL1_41
 mediawiki

Si tu conexion a internet va lenta y deseas reducir el numero de revisiones clonadas, anade --depth=1 al comando git clone .

Etiquetas de MediaWiki (version estable)

Alternativamente, las versiones especificamente estables de MediaWiki son rastreadas usando 'etiquetas', estas son analogas a las liberaciones de tarball. Actualmente estas son, 1.41.1 (estable), 1.39.7 ( LTS ) y 1.39.7 (legado).

Puedes ver todas las etiquetas disponibles con:

git
 tag
 -l
 |
 sort
 -V

Para utilizar una etiqueta concreta, p. ej. la ultima liberacion estable:

git
 checkout
 1
.41.1

Actualizacion submodulos Git

Las ramas y etiquetas tienen un monton de submodulos Git en ellos, para las extensiones y skins de uso comun y para el directorio vendor/ . La master rama no las tiene. Para actualizar los submodulos, ejecute:

cd
 mediawiki
git
 submodule
 update
 --init
 --recursive

Obtener bibliotecas externas

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

Para instalar estos necesitaron bibliotecas, tienes una eleccion:

• Descarga e instala compositor PHAR , opcionalmente cambie el nombre del archivo composer.phar como se indica para su sistema operativo y luego ejecute composer update --no-dev desde su directorio MediaWiki. Este es el enfoque recomendado .
  • Si la version de PHP CLI por defecto no coincide con la version de PHP del servidor web, especifiquela con, por ejemplo, php7.4 composer.phar update --no-dev .
• 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 produccion de la Fundacion Wikimedia, puedes crear en su lugar un directorio vendor/ dentro de la carpeta principal de tu instalacion MediaWiki.
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • Ten en cuenta que si alguna de tus extensiones tiene sus propios requisitos de Compositor, entonces no puedes usar esta opcion .

Con anterioridad a MediaWiki 1.25, las bibliotecas externas se guardaban en el repositorio principal y ningun gestor de paquetes fue requerido.

Si estas usando una rama en particular o la version de desarrollo (rama ≪maestra≫) de MediaWiki, obtener los ultimos cambios es relativamente facil. Cambia al directorio en el que clonaste MediaWiki y emite esta orden:

git
 pull

Se aplicaran todos los cambios mas recientes a la rama que estas utilizando.

Puede que la nueva version del nucleo requiera versiones mas nuevas de extensiones y apariencias, por lo que deberas entrar en ambos directorios y descargar ambas actualizaciones con un comando como git pull --recurse-submodules .

Tambien necesitas actualizar vendor/ con la version mas reciente de las bibliotecas requeridas. Esto a menudo significa ejecutar el siguiente comando de Compositor, consulta #Obtener bibliotecas externas para mas detalles:

composer
 update
 --no-dev

Despues de actualizar el codigo y las bibliotecas requeridas, debes ejecutar el script de linea de comandos de MediaWiki update.php para actualizar las tablas de la base de datos segun sea necesario:

php
 maintenance/update.php

Si empleas MediaWiki-Vagrant , puedes usar su comando unico vagrant git-update , que ejecuta todos estos pasos.

Cambiar a una version distinta

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

git
 checkout
 <Nombre_de_rama>

o

git
 checkout
 <nombre_de_etiqueta>

Los cambios seran aplicados automaticamente y estaras listo para trabajar.

Lista de extensiones en git

Descarga una extension

En las proximas instrucciones, reemplaza ?< EXT > por el nombre de la extension que quieras descargar, sin espacios. Para Extension:TitleKey , seria TitleKey (¡respetando mayusculas y minusculas!) .

Descarga y clona una extension desde Git:

Con su cuenta de desarrollador, use estos comandos para obtener la rama maestra:

cd
 /path/to/extensions
git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT>

Para clonar y verificar una rama de version estable, use estos comandos:

cd
 /path/to/extensions
git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT>
 --branch
 REL1_41

Puedes ver el codigo fuente de la extension en la aplicacion Gerrit's gitiles y en la URL:

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

Descarga todas las extensiones

Si prefiere tener "todas" las extensiones de MediaWiki que estan en gerrit.wikimedia.org desprotegidas en su maquina, ingrese lo siguiente:

git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/extensions

O, para verificar la rama de versiones estables, use este comando:

git
 clone
 https://gerrit.wikimedia.org/r/mediawiki/extensions
 --branch
 REL1_41

Despues de ejecutar el comando git clone , continue con estos comandos:

cd
 /path/to/extensions
git
 submodule
 update
 --init
 --recursive

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

cd
 /path/to/extensions
git
 pull
git
 submodule
 update
 --init
 --recursive

Para cambiar a una rama diferente, como despues de una liberacion nueva:

git
 submodule
 foreach
 'git checkout -b REL1_40 origin/REL1_40 ||?:'

Recuerda que solo debes usar versiones de extensiones de la misma liberacion que esa version de MediaWiki y entre si.

Para seguir la rama maestra:

git
 submodule
 foreach
 'git checkout -b origin/master ||?:'

Ten en cuenta que no debes usar el codigo maestro en produccion 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 codigo de MediaWiki), puedes usar el despliegue MediaWiki compartido en Labs sin tener que descargar nada en tu equipo.

Eliminar una extension

1. Borra ≪ require_once … ≫ o ≪ wfLoadExtension( … ) ≫ de LocalSettings.php
2. Borra cualquier linea que haga referencia a la extension en composer.local.json (generalmente en le seccion ≪extra → merge-plugin → include≫)
3. Borra el directorio de la extension en install-dir/extensions/

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 seccion previa), pero usa skins en vez de extensions en todas las URLs y rutas.

Hay instrucciones detalladas de instalacion en las respectivas paginas de cada apariencia aqui en MediaWiki.org. Por ejemplo, vease Apariencia:Vector#Instalacion . Las instrucciones para otras apariencias son analogas.

• Intranet/Intranet Installation , parte de una serie completamente trabajada de articulos que utiliza Git para el despliegue de MediaWiki

La Revision a partir de las 14:26, 21 de marzo de 2019 cambio el estandar de enlace a gerrit.wikimedia.org:

from:

gerrit.wikimedia.org/r/ p /mediawiki

to:

gerrit.wikimedia.org/r/mediawiki