Download from Git/pt-br

Git é um sistema de controle de versão distribuído. 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.

Consulte Git para mais detalhes, particularmente para contribuir. Em baixo estão algumas instruções rápidas para algumas tarefas comuns.

Pré-Requisitos
Você deve ter o Git instalado antes de poder utilizá-lo. Existem muitas maneiras diferentes de adquirir o Git, dependendo do seu sistema operacional. Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

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

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.

Download for development
A versão mais recente de desenvolvimento do MediaWiki é rastreada no ramo 'mestre'.

Primeiro, verifique se você criou uma conta de desenvolvedor, para ter um nome de usuário ssh.

Em uma janela do terminal, digite o seguinte comando para clonar com seu ssh , para que você possa enviar correções para revisão:

Isto clona todo o repositório principal da MediaWiki, sincronizado com o ramo principal em um subdiretório chamado.

Para instalar em uma pasta diferente, mude pela linha de comando (para mais informações olhe esses documentos). Depois que o repositório é clonado, você pode alternar para diferentes ramificações ou etiquetas. A versão de desenvolvimento, é 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.



Download a stable branch
Se você não deseja desenvolver patches de software, mas deseja clonar anonimamente o ramo de liberação estável, use este comando no lugar:

Se você possui uma conexão de internet lenta e deseja reduzir o número de revisões clonadas, adicione  ao comando.

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

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

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

Update the Git submodules
As ramificações têm vários sub-módulos Git, para extensões e skins comumente usadas (a ramificação principal não possui essas). Para atualizar os submódulos, execute:

Fetch external libraries
MediaWiki usa composer para gerenciar bibliotecas PHP externas, todos os quais acabam no diretório  em seu diretório MediaWiki.

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


 * Baixe e instale o compositor PHAR, se quiser, renomeie o arquivo composer.phar como o instruído para seu sistema operacional, então rode  do seu diretório MediaWiki. "Esta é a abordagem recomendada.
 * Ou, se você não deseja usar o Compositor ou se deseja usar exatamente o mesmo conjunto de bibliotecas de fornecedores usado no grupo de produção WMF, você pode criar um diretório $fornecedor dentro da pasta principal da sua instalação do MediaWiki:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * 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.

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:

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.

Você também precisa atualizar  com qualquer versão mais nova das bibliotecas requisitadas. Frequentemente isto significa rodar o comando Compositor, veja abaixo #Fetch external libraries para mais detalhes This often means running the following Composer command, but see #Fetch external libraries above for more details:

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

Se você usa MediaWiki-Vagrant, ele oferece um único comando,, 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 é checkout o ramo particular ou tag que deseja dentro do seu diretório de clones MediaWiki:

ou

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

 * Nos próximos comandos, substitua  pelo nome da extensão que você deseja baixar, sem espaços. Por, seria TitleKey. (sensível a maiúsculas e minúsculas!)

Baixe e clone uma extensão do Git:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

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

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

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

A qualquer momento, para atualizar todas as extensões para as versões mais recentes dessa ramificação, digite:

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

Lembre-se que você deve usar apenas extensões compatíveis com a sua versão do MediaWiki e vise-versa.

Para acompanhar o ramo principal:

Por favor note que "você não deveria usar código mestre para produção" em qualquer circunstância a não ser que ela seja considerada estável.

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

 * 1) Remova o $code ou $code2 do $LocalSettings
 * 1) Remova qualquer linha referente à extensão em   (geralmente na seção "extra → merge-plugin → include")
 * 2) Remova os diretórios de extensão em

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  ao invés de   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

 * Intranet/Intranet Installation, parte de uma série completa de artigos que usam Git para a implantação da WikiMedia

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