Descarga desde Git

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

Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎नेपाली • ‎Nederlands • ‎occitan • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎slovenčina • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
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.

Prerequisitos[edit]

Debes tener Git instalado antes de 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 motor de búsqueda 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[edit]

Descarga[edit]

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

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

En una ventana de terminal, ingresa el siguiente comando:

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

Esto clona todo el núcleo del repositorio MediaWiki a un subdirectorio llamado core. Para instalar en un directorio específico, inclúyelo en la línea de comandos (para más información consulta estos documentos). La «rama» predeterminada será master, la versión más avanzada de desarrollador de MediaWiki. Una vez que el repositorio es clonado, se puede saltar entre distintas ramas o tags (véase más abajo), incluyendo las revisiones y las versiones estables de MediaWiki.

Descarga para desarrollo[edit]

Si tienes acceso 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 revisión:

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

Obtener bibliotecas externas[edit]

Desde MediaWiki 1.25 algunas bibliotecas externas que MediaWiki necesita, ya no están en este repositorio "core" en git. Usamos composer para gestionarlas. Para instalar estas bibliotecas necesarias, puedes elegir:

  • Descargar e instalar 'composer', ir al directorio principal y luego ejecutar composer install --no-dev. Observa que si ya tienes un archivo composer.lock, en su lugar tendrás que ejecutar composer update --no-dev.
  • Si no quieres usar composer, o si quieres usar el mismo conjunto de bibliotecas de vendedor usado para los grupos de producción de la Fundación Wikimedia, puedes usar git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git en su lugar para crear un directorio vendor/ dentro de la carpeta central de instalación de tu MediaWiki. Asegúrate de emplear la rama correspondiente a tu versión de MediaWiki (por ejemplo, REL1_25 para 1.25).

Versiones específicas de MediaWiki[edit]

Ramas WMF[edit]

Las ramas remotas siguen las versiones de MediaWiki que se usan en el clúster de servidores de la Fundación Wikimedia. Puede que no sean completamente estables, pero los fallos se corrigen rápidamente y en general son suficientemente estables. Después de todo, son las que se usan en los grandes proyectos como Wikipedia. Una vez que una rama REL* se considera 'estable', la 'etiquetamos' y se convierten en un lanzamiento oficial en forma de tar.gz.

Para ver qué ramas hay disponibles, ve al directorio donde descargaste el código del núcleo de MediaWiki y ejecuta la siguiente orden:

git branch -r | sort -V

Los lanzamientos principales se denotan mediante "origin/REL<release number>", p.ej. "origin/REL1_29". Para cambiar a una rama de una versión particular:

git checkout -b REL<número de lanzamiento> origin/REL<número de lanzamiento>

Por ejemplo, para cambiar a la versión estable actual, 1.29.2, escribe:

git checkout -b REL1_29 origin/REL1_29
Tags de MediaWiki (versión estable)[edit]

Alternativamente, algunas versiones estables de MediaWiki se siguen mediante 'tags', que son análogas a los lanzamientos en tar.gz. Se pueden ver las versiones 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 usar un tag específico:

git checkout <Nombre de etiqueta>

Versión de desarrollo más reciente de MediaWiki[edit]

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[edit]

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

git pull

Se aplicarán todos los últimos cambios para 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.

Además, después de actualizar debes ejecutar el script de línea de comandos update.phpManual:update.php de MediaWiki para aplicar las actualizaciones que sean necesarias en las tablas de base de datos:

php maintenance/update.php

También tendrás que actualizar mediawiki/vendor a cualquier versión más nueva de las bibliotecas necesarias. Consulta #Obtener bibliotecas externas.

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

Cambiar a una versión distinta[edit]

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 tags. Para cambiar a una de ellas, todo lo que tienes que hacer es un checkout a la rama o tag deseada en el directorio en el que clonaste MediaWiki.

git checkout <branchname>

ó

git checkout <Nombre de etiqueta>

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

Uso de Git para descargar extensiones de MediaWiki[edit]

Lista de extensiones en git

Descargar una extensión[edit]

<EXT> debe reemplazarse por el nombre de la extensión que quieras descargar, sin espacios. Para Extensión:TitleKey, sería TitleKey. (¡respetando diferencias entre 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/p/mediawiki/extensions/<EXT>.git

Los Desarrolladores clonan con:

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

Puedes ver el código fuente de la extensión en la aplicación Difusión de Phabricator y en el URL:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

Descargar todas las extensiones[edit]

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/p/mediawiki/extensions.git
cd extensions
git submodule update --init --recursive

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

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

Para seguir una rama específica:

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

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[edit]

Simplemente borra el directorio de la extensión y borra "require_once …" de LocalSettings.php.

Usando Git para descargar temas/máscaras de MediaWiki[edit]

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[edit]