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.
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
.
- 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
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
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
- Remove the "
require_once …
" or "wfLoadExtension( … )
" fromLocalSettings.php
- Remove any line referencing the extension in
composer.local.json
(usually in the "extra → merge-plugin → include" section)
- Remove the extension's directory in
install-dir/extensions/
Using Git to download MediaWiki skins
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