Download from Git/pt-br


 * Desde o MediaWiki 1.19beta2, 1.18.2, 1.17.3, núcleo do MediaWiki e extensões use para controle de versão. Para versões, veja 

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.

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:

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

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, é 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  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:

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 "" para que você possa enviar alterações para revisão:

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



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 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  para criar uma pasta   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 (estável),  (LTS) and  (legado).

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

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

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

Ú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:

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

 * A marca  deve ser substituída pelo nome da extensão que você deseja fazer o download, sem espaços. Para, seria TitleKey. (case sensitive!)

Baixe e clone uma extensão do Git:

Clone de desenvolvedores com:

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:

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

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

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