Download from Git/pt-br

Git é um sistema de controle de versão distribuído. Este permite-lhe transferir a versão mais recente do código fonte, com todos os ramos e lançamentos etiquetados à sua disposição.

Deveria baixar do Git se for um programador e se pretender submeter correções (patches).

Se não deseja programar, mas só pretende instalar o MediaWiki e as extensões, então transfira as versões de "tarball" estáveis

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. Siga Gerrit/Tutorial#Configurar Git, ou utilize o seu motor de pesquisa favorito.

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



Baixar ramificação estável
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:

Atualizar os submódulos Git
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  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

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   ou   do
 * 2) Remova qualquer linha referente à extensão em   (geralmente na seção "extra → merge-plugin → include")
 * 3) 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