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 • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎қазақша • ‎العربية • ‎سنڌي • ‎فارسی • ‎अवधी • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

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 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 tu nombre de usuario ssh, de esta manera podrás enviar parches para que los revisen.

git clone ssh://<NOMBRE DE USUARIO>@gerrit.wikimedia.org:29418/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.

Descarga una rama estable

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

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_34 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.34.1 (estable), 1.31.7 (LTS) y 1.33.3 (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.34.1

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:

cd mediawiki
git submodule update --init

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.
  • 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.
    • With your developer account, use this command: git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/vendor.git
    • For anonymous checkout, use this command: 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/update.php

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 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 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:

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

cd /path/to/extensions
git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>

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

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

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

git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions

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

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

After running the git clone command, continue with these commands:

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_33 origin/REL1_33 || :'

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.

Véase también