Descargar desde Git

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 Composer instala o descargador e instala librarías de terceiras partes, pero non é requerido.

Utilizando Git para descargar MediaWiki

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

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 <USERNAME> tal que podes empregar trocos para revisión:

Nunha xanela do terminal, introduza o seguinte comando:

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

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

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

• Vista do último código fonte

Download a stable branch

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

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

Se queres reducir o número de versións que son clonadas, engade --depth=1 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 1.42.3 (stable), 1.39.10 (LTS) and 1.39.10 (legacy LTS).

You can see all available tags with:

git tag -l | sort -V

Usa a etiqueta específica:

git checkout 1.42.3

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 master branch does not have these. To update the submodules, run:

cd mediawiki
git submodule update --init --recursive

Vai buscar bibliotecas externas

MediaWiki uses Composer to manage external PHP libraries, all of which end up in the vendor/ directory in your MediaWiki directory.

Para instalar estas librarias necesarias, podes elixir:

• Download and install composer, trocando o directorio do core e correndo composer update --no-dev.

• • If the default PHP CLI version does not match the web server's PHP version, specify it with e.g. php7.4 composer.phar update --no-dev.

• 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 vendor/ dentro da carpeta do core ou da túa instalación MediaWiki.

git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git

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

git pull

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

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

composer update --no-dev

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

php maintenance/run.php update

If you use MediaWiki-Vagrant , it offers a single command, vagrant git-update, 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 master branch to a different branch or tag), checkout the particular branch or tag you want from within your MediaWiki clone directory:

git checkout <branch_name>

ou

git checkout <tag_name>

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

<EXT> debe ser substituído polo nome da extensión que queres descargar, sen espazos. Para a Extension:TitleKey , 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:

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

To clone and checkout a stable release branch instead, use these commands:

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

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

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:

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

Or, to checkout stable releases branch instead, use this command:

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

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

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

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

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

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

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

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:

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

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 "require_once …" or "wfLoadExtension( … )" from LocalSettings.php

1. Remove any line referencing the extension in composer.local.json (usually in the "extra → merge-plugin → include" section)

1. Remove the extension's directory in install-dir/extensions/

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 skins rather than extensions 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

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