Descarga desde Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Desde las versiones 1.19beta2, 1.18.2, 1.17.3 de MediaWiki, tanto MediaWiki como sus extensiones utilizan Git para el control de versiones. Para versiones más antiguas, visita Subversión

Git es un sistema de control de versiones distribuido que permite a los usuarios descargar la versión más reciente de una rama sin tener que esperar a que alguien la empaquete. De esta forma MediaWiki será liberado rápidamente, y será más fácil actualizar su instalación, deshacer una actualización, o mandar parches. (Por supuesto, recuerda siempre que las liberaciones oficiales son menos arriesgadas.)

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

Debes tener Git instalado antes de poder usarlo. Hay muchas formas distintas de conseguir Git, dependiendo de tu sistema operativo. Para conseguir el código fuente y los ejecutables oficiales, visita git-scm.com. Para otras formas de instalar Git, utiliza tu buscador favorito para encontrar instrucciones para tu sistema operativo.

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 instalada 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 de MediaWiki. Esto puede tardar un tiempo.

En una ventana de terminal, introduce el siguiente comando:

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

Esto clona todo el núcleo del repositorio MediaWiki, que de forma predeterminada apunta a la rama 1.32, en un subdirectorio llamado mediawiki.

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 se clona el repositorio, puedes cambiar fácilmente a diferentes ramas o etiquetas (ver a continuación), incluyendo aquellas que siguen a las versiones inestables de MediaWiki. La rama de desarrollo, master, 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.

Si deseas reducir el número de revisiones clonadas, añade --depth=1 al comando anterior.

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

cd mediawiki
git submodule update --init

Descarga para desarrollo

Si tienes una cuenta de desarrollador (que es fácil de pedir), entonces en lugar de clonar anónimamente con https, puedes clonar con tu <USERNAME> de ssh para que puedas enviar cambios para su revisión:

git clone ssh://<NOMBRE DE USUARIO>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

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

Obtener bibliotecas externas

MediaWiki utiliza Composer para administrar bibliotecas externas de PHP, todas las cuales terminan en la carpeta vendor/ 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 composer update --no-dev desde tu directorio MediaWiki. Esta es la forma recomendada de hacerlo.
  • Si no quieres usar Composer, o si quieres usar el mismo conjunto de bibliotecas de proveedores que se utiliza en el clúster de producción de la Fundación Wikimedia, puedes usar git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git en su lugar para crear un directorio vendor/ dentro de la carpeta principal de la instalación de MediaWiki. 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.

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 1.32.2 (estable), 1.31.2 (LTS) y 1.31.2 (heredado).

Puedes ver todas las etiquetas disponibles con:

git tag -l | sort -V

Si se utiliza una orden sort que no sea la de GNU, como en Mac OS X, hay que utilizar los separadores de toda la vida:

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout 1.32.2

Versión de desarrollo más reciente de MediaWiki

La última versión de desarrollo de MediaWiki se sigue en la rama 'master'. Esta rama es la que se obtiene de forma predeterminada cuando se clona el repositorio de MediaWiki. Si has cambiado a otra rama pero te gustaría volver a usar la última versión de MediaWiki, haz esto:

git checkout master

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:

git pull

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

También tendrás que actualizar vendor/ 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:

composer update --no-dev

Después de actualizar el código y las bibliotecas necesarias, 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/update.php

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

Cambiar a una versión distinta

Cambiar a una versión distinta de MediaWiki es mucho más sencillo con Git que con SVN. Todas nuestras versiones son rastreadas como ramas o etiquetas. Para cambiar a una de ellas, todo lo que tienes que hacer es un checkout a la rama o etiqueta deseada en el directorio en el que clonaste MediaWiki.

git checkout <nombre de la rama>

o

git checkout <nombre de la etiqueta>

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

<EXT> debe reemplazarse por el nombre de la extensión que quieras descargar, sin espacios. Para la Extensión:TitleKey, sería TitleKey. (¡respetando mayúsculas y minúsculas!)

Descarga y clonado de una extensión desde Git:

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

Los desarrolladores clonan con:

git clone ssh://<NOMBRE DE USUARIO>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_32

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

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_32
cd extensions
git submodule update --init --recursive

Después de esto, para actualizar todas las extensiones a la última versión de esta rama, introduce este comando:

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

Para cambiar a una rama diferente, como cuando hay una nueva versión:

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

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

Para seguir la rama principal:

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.

Véase también