Descargar desde Git

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

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Desde as versións 1.19beta2, 1.18.2, 1.17.3 de MediaWiki, tanto MediaWiki como as súas extensións utilizan GitGit para o control de versións. Para versións máis antigas, consulte SubversionSubversion

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.

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

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

Nunha xanela do terminal, introduza o seguinte comando:

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

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

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.

Se queres reducir o número de versións que son clonadas, engade --depth=1 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:

cd mediawiki
git submodule update --init

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

git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

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

Vai buscar bibliotecas externas

Utilizamos composer para xestionalas.

Para instalar estas librarias necesarias, podes elixir:

  • Se ti non queres usar composer, ou se queres usar algun xogo de librarias de vendedor como as producidas por WMF, podemos instalar git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git e crear un directorio vendor/ dentro da carpeta do core ou da túa instalación MediaWiki.

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

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. Podes ver as versións dispoñibles con:

You can see all available tags with:

git tag -l | sort -V

Utilizando un comando tipo non GNU , tal como en Mac OS X, ti tes que confiar non bos e vellos separadores:

git tag -l | sort -n -t. -k1 -k2 -k3

Usa a etiqueta específica:

git checkout 1.31.1


Versión de desenvolvemento máis actual de MediaWiki

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:

git checkout master


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:

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.phpManual:update.php script de actualización das bases de datos necesarias:

php maintenance/update.php


If you use MediaWiki-Vagrant, it offers a single command, vagrant git-update, 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:

git checkout <branchname>

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 extensión:titlekey, sería TitleKey. (Diferenciando maiúsculas-minúsculas!)

Descarga e clona unha extensión dende Git:

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

Desenvolvedores clonar con:

git clone ssh://<NOME DE USUARIO>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/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:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
cd 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_30 origin/REL1_30 || :'

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
  2. Remove any line referencing the extension in composer.local.json (usually in the "extra → merge-plugin → include" section)
  3. 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