Download from Git/gl

Git é distribuído en versión de software de control que permite os usuarios descargar a máis recente versión dunha rama, non tendo que agardar a que alguén se poña a empaquetalo. MediaWiki a ceibar máis axiña, e será máis doado para ti actualizar a túa instalación, reverter un troco de versión, ou [$bugzilla submit patches]. (Naturalmente, lembrar sempre que as versións estábeis oficiais teñen menos risco.) It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

Ver Git para máis detalles, particularmente para facer contribucións. Abaixo hai algunhas direccións rápidas para algunhas tarefas comúns.

Pre-requisitos
Debes ter instalado Git antes de que poidas utilizalo. Hai moitos xeitos diferentes para adquirir Git, dependendo do sistema operativo que teñas. Para código fonte e binarios oficiais, comproba [$link git-scm.com]. Para xeitos alternativos de intalación de Git, usa o teu favorito buscador e atopa instrucións para o teu sistema operativo. Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

Está recomendado que teñas instala o descargador e instala librarías de terceiras partes, pero non é requerido.



Descargar
Podes descargar o nucleo MediaWiki usando Git, así como todas as extensións actuais instaladas no grupo de servers da Fundación Wikimedia e calquera outra extensión hospedadas en.

O primeiro paso é a clonación do repositorio do núcleo MediaWiki. Esto levará un intre.



Descarga para desenvolvemento
A última versión de desenvolvemento de MediaWiki está ligada na rama 'master'. Isto é o que localmente se comproba por defecto cando se clona por primeira vez o repositorio MediaWiki. Se cambiaches a outra rama pode preferir volver cambiar e utilizar a de desenvolvemento da MediaWiki:

Se tes Developer access (o cal é fácil de acadar), entón en vez de clonar anónimamente con https ti podes clonar co teu ssh  tal que podes empregar trocos para revisión:

Nunha xanela do terminal, introduza o seguinte comando:

This clones the entire MediaWiki core repository, synced to the master branch, into a sub-directory named.

Para instalar nun directorio diferente, trocar a liña de comandos (para máis información refer to these docs). Unha vez pechado o repositorio, facilmente podes trocar corchetes ou etiquetas (ver embaixo), incluíndo aqueles seguindo versións inestables de MediaWiki. A rama de desenvolvemento,, en produción , versión desenvolta por MediaWiki; ti  non debes usar o código master para produción baixo calquera circunstancia como non é considerado estable.



Download a stable branch
Estes clons do núcleo enteiro do repositorio de MediaWiki, inicialmente sinalados na versión, un sub directorio chamado $dir.

Se queres reducir o número de versións que son clonadas, engade  ao comando superior.



Etiquetas MediaWiki (versión estable)
De maneira alternativa, a específica versión estable de MediaWiki seguindo utilizando 'tags'. Estes son análogos aos lanzados por tarball. Currently, these are (stable),  (LTS) and  (legacy LTS).

You can see all available tags with:

Usa a etiqueta específica:

Update the Git submodules
Aquelas ramas das versións teñen sub módulos de Git nelas, para empregar extensións cómodamente e interfaces (a rama master non ten estos). Para actualizar os submódulos, corre: The  branch does not have these. To update the submodules, run:



Vai buscar bibliotecas externas
MediaWiki uses to manage external PHP libraries, all of which end up in the   directory in your MediaWiki directory.

Para instalar estas librarias necesarias, podes elixir:


 * Download and install composer, trocando o directorio do core e correndo.
 * If the default PHP CLI version does not match the web server's PHP version, specify it with e.g..
 * Se ti non queres usar composer, ou se queres usar algun xogo de librarias de vendedor como as producidas por WMF, podemos instalar $git e crear un directorio  dentro da carpeta do core ou da túa instalación MediaWiki.
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Note that if any of your extensions have their own Composer requirements, then you cannot use this option.

Arrancando con MediaWiki 1.25, algunhas librarias externas que require MediaWiki están no "core" extendido do repositorio git.



Manter-se actualizado
Se estás utilizando unha rama particular da versión de desenvolvemento (rama "master") de MediaWiki, collendo os trocos da última versión é relativamente fácil. Cambiando no teu clon Mediawiki do directorio e emitindo o comando:

Tódolos últimos cambios para a rama usadas serán aplicadas.

A versión máis nova require versións de extensións e peles, así que tes que ir a cada extensión e directorio de pel e actualizalo cun comando coma.

You also need to update  with any newer versions of required libraries. This often means running the following Composer command, but see #Fetch external libraries above for more details:

Despois de actualizar/mellorar correa á actualización MediaWiki   script de actualización das bases de datos necesarias:

If you use, it offers a single command, , that performs all these steps.

Switching to a different version
Each of our versions are tracked as branches or tags. In order to switch to a different version (for example from the  branch to a different branch or tag), checkout the particular branch or tag you want from within your MediaWiki clone directory:

ou

The changes will be applied automatically and you will be all set to go.

Using Git to download MediaWiki extensions

 * List of extensions in git



Descargar unha extensión

 *  debe ser substituído polo nome da extensión que queres descargar, sen espazos. Para a, sería TitleKey. (Diferenciando maiúsculas-minúsculas!)

Descarga e clona unha extensión dende Git:

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

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

You can view extension source code in Gerrit's gitiles application, and at the URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master



Descargar todas as extensións
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

With your developer account, to get the master branch:

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

After running the  command, continue with these commands:

Despois, para actualizar tódalas extensións das súas versións máis novas daquela rama, só introducir:

Para trocar a unha rama diferente, tal como após da nova versión:

Remember that you should only use versions of extensions from the same release as that version of MediaWiki and each other.

To track the master branch:

Please note that you should not use master code for production under any circumstances as it is not considered stable.

Se só precisas dunha revisión de só lectura (por exemplo, para o comando grep ou para analizar todo o código MediaWiki), podes usar o shared MediaWiki checkout on Labs, sen baixar nada para as túas máquinas.



Desbotar unha extensión

 * 1) Remove the " " or " " from
 * 1) Remove any line referencing the extension in   (usually in the "extra → merge-plugin → include" section)
 * 1) Remove the extension's directory in

Using Git to download MediaWiki skins

 * List of skins in git

MediaWiki 1.24 and later don't include skins in the Git download.

Follow the exact same procedure as for extensions (described in the previous section), but using  rather than   in all URLs and paths.

Detailed installation instructions are available on each skin's page here on MediaWiki.org, for example see Skin:Vector#Installation. Instructions for all other skins are analogous.



Véxase tamén

 * Intranet/Intranet Installation, part of a fully worked series of articles that uses Git for MediaWiki deployment

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki