Download from Git/gl


 * Desde as versións 1.19beta2, 1.18.2, 1.17.3 de MediaWiki, tanto MediaWiki como as súas extensións utilizan para o control de versións. Para versións máis antigas, consulte 

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 submit patches. (Naturalmente, lembrar sempre que as versións estábeis oficiais teñen menos risco.)

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

Está recomendado que teñas composer 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.

Nunha xanela do terminal, introduza o seguinte comando:

Estes clons do núcleo enteiro do repositorio de MediaWiki, inicialmente sinalados na versión, un sub directorio chamado.

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.

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

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:

Descarga para desenvolvemento
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:



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

Utilizamos composer para xestionalas. Para instalar estas librarias necesarias, podes elixir:


 * Download and install composer, trocando o directorio do core e correndo  . Nota que se tes que  o arquivo existente necesitarás correr instalando  .


 * If you don't want to use composer, or if you want to use the same set of vendor libraries as used on the WMF production cluster, you can instead  to create a   directory inside the core folder of your MediaWiki installation.

MediaWiki tags (stable version)
Alternatively, specific stable versions of MediaWiki are tracked using 'tags'. These are analogous to the tarball releases. You can see the versions available with:

Using non GNU sort command, such as on Mac OS X, you have to rely on the good old separators:

To use a specific tag:

Latest development version of MediaWiki
The latest development version of MediaWiki is tracked in the 'master' branch. This is what is locally checked out by default when you first clone the MediaWiki repository. If you have switched to another branch but would like to switch back to using bleeding-edge MediaWiki, do:

Manter-se actualizado
If you're using a particular branch or the development version ("master" branch) of MediaWiki, picking up the latest changes is relatively easy. Change into your MediaWiki clone directory and issue the  command:

All of the latest changes for the branch you are using will be applied.

The new version of core may require newer versions of extensions and skins, so you must go into each extension and skin directory and update it with a command like.

After updating/upgrading you should run the MediaWiki  command-line script to update database tables as needed:

You also need to update  to any newer versions of required libraries, see.

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

Switching to a different version
Switching to a different version of MediaWiki is far simpler with Git than with SVN. Each of our versions are tracked as branches or tags. In order to switch to one of these, all you have to do is 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 extensión:titlekey, sería TitleKey. (Diferenciando maiúsculas-minúsculas!)''

Descarga e clona unha extensión dende Git:

Desenvolvedores clonar con:

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:

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
Just remove the extension folder and remove the " " or " " from.

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

 * Migrating from SVN to Git
 * Nightlies, an alternate to downloading from Git
 * Intranet/Intranet Installation, part of a fully worked series of articles that uses Git for Mediawiki deployment