Download do 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 91% 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 o MediaWiki 1.19beta2, 1.18.2, 1.17.3, núcleo do MediaWiki e extensões use GitGit para controle de versão. Para versões, veja SubversionSubversion

O Git é um software de controle de versão distribuído, que permite aos usuários fazer o download da versão mais recente de um pacote, sem ter que esperar que alguém faça o seu empacotamento. O MediaWiki será liberado mais rapidamente e ficará mais fácil para você atualizar sua instalação, reverter uma atualização, ou submeter correções. (Claro, lembre-se sempre que lançamentos oficiais estáveis ​​são menos arriscados.)

Veja Git para mais detalhes, especialmente para fazer um contribuição. Abaixo estão algumas orientações rápidas para tarefas comuns de uso casual.

Pré-Requisitos

Você deve ter o Git instalado antes de poder utilizá-lo. Existem muitas maneiras de adquirir o Git, dependendo do seu sistema operacional. Para o código-fonte e arquivos binários oficiais, entre no git-scm.com. Para maneiras alternativas de instalar o Git, use o seu buscador favorito para localizar instruções de como instalá-lo no seu sistema operacional.

É recomendado que você tenha o Composer instalado para baixar e instalar bibliotecas de terceiros, mas não é obrigatório.

Usando o Git para baixar o MediaWiki

Baixar

Você pode baixar o MediaWiki mais recente (phase3 no SVN) usando Git, e também algumas extensões recentemente instaladas no servidor alocado da Fundação WikiMedia.

O primeiro passo é clonar o repositório do MediaWiki. isso vai levar algum tempo.

Em uma janela de terminal, digite o seguinte comando:

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

Isso clona todo o repositório do núcleo do MediaWiki, inicialmente apontado para a versão de lançamento 1.31, em uma subpasta chamada mediawiki.

Para instalar em uma pasta diferente, mude pela linha de comando (para mais informações olhe esses documentos). Uma vez que o repositório seja clonado, você pode facilmente mudar para versões ou tags diferentes (veja abaixo), incluindo aquelas versões instáveis do MediaWiki. A versão de desenvolvimento master , é a versão de ponta e de desenvolvedor da MediaWiki; você ""não deve usar o código master para produção"" sob nenhuma circunstância, já que não é considerado estável.

Se você quiser reduzir o número de revisões que é clonado, adicione --depth=1 para o comando acima.

As versões de lançamento possuem vários submódulos do Git inseridas, para extensões e temas constantemente usados (a versão master não possui esses submódulos). Para atualizar esses submódulos, execute:

cd mediawiki
git submodule update --init

Download for development

Se você tem Acesso para desenvolvedores (o que é fácil de solicitar), em vez de clonar anonimamente com https, você deve clonar com o seu ssh "<USERNAME>" para que você possa enviar alterações para revisão:

git clone ssh://<USUÁRIO>@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.

Fetch external libraries

Nós usamos composer para gerenciá-los.

Para instalar essas bibliotecas se necessárias, você pode escolher:

  • Ou, se você não quiser usar o composer, ou se você quiser usar o mesmo conjunto de bibliotecas vendor usadas no cluster de produção da WMF, você pode git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git para criar uma pasta vendor/ dentro da pasta core da sua instalação da MediaWiki. Observe que se qualquer uma de suas extensões tiver seus próprios requisitos, então você "'não pode usar essa opção'".

Até o MediaWiki 1.25, bibliotecas externas eram mantidas no repositório núcleo, e nenhum gerenciador de pacotes era necessário.

MediaWiki tags (versão estável)

Alternativamente, versões estáveis ​​específicas de MediaWiki são rastreados usando 'tags'. Estes são análogos aos lançamentos tarball. Atualmente, essas são 1.31.1 (estável), 1.27.5 ((LTS)) and 1.30.1 (legado).

Você pode ver todas as tags disponíveis com:

git tag -l | sort -V

Ao usar um tipo de comando não GNU, como no Mac OS X, você dependerá dos bons e velhos separadores:

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

Para usar uma tag especifica, por exemplo, a mais recente versão lançada:

git checkout 1.31.1


Última versão de desenvolvimento do MediaWiki

A última versão de desenvolvimento do MediaWiki é rastreado no pacote 'mestre'. Isto é o que é verificado localmente por padrão quando você clonar o repositório do MediaWiki. Se você tiver alternado para outro pacote, mas gostaria de voltar a usar a versão de última geração do MediaWiki, faça o seguinte:

git checkout master


Mantenha atualizado

Se você estiver usando um branch específico ou a versão de desenvolvimento (branch "master") do MediaWiki, baixar as últimas mudanças é relativamente fácil. Navegue para sua pasta clonada MediaWiki e execute o comando:

git pull

Todas as últimas alterações para o pacote que você está usando serão aplicadas.

A nova versão do core pode exigir versões mais recentes de extensões e skins, então você deve entrar na pasta de cada extensão e skin e atualizá-las com um comando como git pull --recurse-submodules.

Você também precisa atualizar mediawiki/vendor para todas as versões mais recentes das bibliotecas necessárias, veja #Fetch bibliotecas externas.

composer update --no-dev

Após a atualização/upgrade do código e das bibliotecas necessárias você deve executar o MediaWiki update.phpManual:update.php script na linha de comando para atualizar as tabelas do banco de dados conforme necessário:

php maintenance/update.php


Se você usa MediaWiki-Vagrant, ele oferece um único comando, vagrant git-update, que executa todas essas etapas.

Mudando para uma versão diferente

Alternar para uma versão diferente do MediaWiki é muito mais simples com o Git do que com o SVN. Cada uma de nossas versões são rastreadas como ramos ou tags. Para mudar para um desses, tudo o que você precisa fazer é url checkout o ramo particular ou tag que deseja dentro do seu diretório de clones MediaWiki:

git checkout <nome do ramo>

ou

git checkout <nome da etiqueta>

As alterações serão aplicadas automaticamente e você vai estar pronto para ir adiante.

Usando o Git para baixar extensões do MediaWiki

Lista de extensões em git

Baixar uma extensão

[$url Lista de extensões no Git]
A marca <EXT> deve ser substituída pelo nome da extensão que você deseja fazer o download, sem espaços. Para Extensão:TitleKey, seria TitleKey. (case sensitive!)

Baixe e clone uma extensão do Git:

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

Clone de desenvolvedores com:

git clone ssh://<USUÁRIO>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

Você pode visualizar o código fonte da extensão no aplicativo diffusion gitiles, e no URL:

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

Baixar todas extensões

Se você preferir ter todas as extensões do MediaWiki que estão em gerrit.wikimedia.org verficadas em sua máquina, faça o seguinte:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
cd extensions
git submodule update --init --recursive

Posteriormente, para atualizar todas as extensões para suas versões mais recentes (da versão correspondente), basta fazer o seguinte:

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

Para mudar para uma versão diferente, como depois de um novo lançamento:

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 você usa um checkout read-only(por exemplo para usar grep ou analisar todo o código da MediaWiki), você pode usar checkout compartilhado MediaWiki em Labs, sem baixar nada nas suas máquinas.

Remova uma extensão

Basta remover a pasta da extensão e remover "require_once …" ou wfLoadExtension( … ) de LocalSettings.php.

Usando o Git para baixar aparências do MediaWiki

Lista de skins em git

O MediaWiki 1.24 e posterior não incluem skins no download do Git.

Siga exatamente o mesmo procedimento para extensões(descrito na seção anterior), mas usando skins ao invés de extensions em todas as URLs e caminhos.

Instruções detalhadas de instalação estão disponíveis na página de cada skin aqui em MediaWiki.org, para um exemplo veja Skin:Vector#Installation. Instruções para todas as outras skins são análogas.

Ver também