Descarga desde Git

Git es un 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 Composer para descargar e instalar bibliotecas de terceros.

Usando Git para descargar MediaWiki

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 Gerrit .

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 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, 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, master, 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.

• Ver el código fuente más reciente

Descarga una rama estable

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

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

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

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, 1.42.4 (estable), 1.39.11 (LTS) y 1.39.11 (legado).

Puedes ver todas las etiquetas disponibles con:

git tag -l | sort -V

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

git checkout 1.42.4

Actualización submódulos Git

Las ramas y etiquetas tienen un montón de submódulos Git en ellos, para las extensiones y skins de uso común y para el directorio vendor/. La master rama no las tiene. Para actualizar los submódulos, 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 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 composer update --no-dev desde su directorio MediaWiki. Este es el enfoque recomendado.
  • Si la versión de PHP CLI por defecto no coincide con la versión de PHP del servidor web, especifíquela 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 producción de la Fundación Wikimedia, puedes crear en su lugar un directorio vendor/ dentro de la carpeta principal de tu instalación 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 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:

git pull

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 git pull --recurse-submodules.

También necesitas actualizar vendor/ 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:

composer update --no-dev

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

php maintenance/run.php update

Si empleas MediaWiki-Vagrant , puedes usar su comando único vagrant git-update, 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 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 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 ‎<EXT> por el nombre de la extensión que quieras descargar, sin espacios. Para Extension:TitleKey , sería TitleKey (¡respetando mayúsculas y minúsculas!).

Descarga y clona una extensión 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 versión estable, use estos comandos:

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

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/<EXT>/+/HEAD

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:

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_42

Después de ejecutar el comando git clone, continúe con estos comandos:

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

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

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

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

git submodule foreach 'git checkout -b REL1_41 origin/REL1_41 || :'

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:

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

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 «require_once …» o «wfLoadExtension( … )» de LocalSettings.php
2. Borra cualquier línea que haga referencia a la extensión en composer.local.json (generalmente en le sección «extra → merge-plugin → include»)
3. Borra el directorio de la extensión en install-dir/extensions/

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 skins en vez de extensions 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.

Apéndice

La Revisión a partir de las 14:26, 21 de marzo de 2019 cambió el estándar de enlace a gerrit.wikimedia.org:

de:

gerrit.wikimedia.org/r/p/mediawiki

a:

gerrit.wikimedia.org/r/mediawiki