Baixar do Git
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 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.
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 o repositório:
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki
Isto clona todo o repositório principal da MediaWiki, sincronizado com o ramo principal em um subdiretório chamado mediawiki.
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 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.
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 1.42, use este comando no lugar:
git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_42 mediawiki
Se você possui uma conexão de internet lenta e deseja reduzir o número de revisões clonadas, adicione --depth=1 ao comando git clone.
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 1.42.3 (estável), 1.39.10 (LTS) and 1.39.10 (legado).
Você pode ver todas as etiquetas disponíveis com:
git tag -l | sort -V
Para usar uma etiqueta especifica, por exemplo, a mais recente versão lançada:
git checkout 1.42.3
Atualizar os submódulos Git
The branches and tags have a bunch of Git submodules in them, for commonly-used extensions and skins and for the vendor/ directory.
A ramificação master não possui estes.
Para atualizar os submódulos, execute:
cd mediawiki
git submodule update --init --recursive
Fetch external libraries
MediaWiki usa vendor/ para gerenciar bibliotecas PHP externas, todos os quais acabam no diretório Composer 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
composer update --no-devdo seu diretório MediaWiki. "Esta é a abordagem recomendada.- Se a versão padrão da CLI do PHP não corresponder à versão do PHP do servidor web, especifique-a com, por exemplo,
php7.4 composer.phar update --no-dev.
- Se a versão padrão da CLI do PHP não corresponder à versão do PHP do servidor web, especifique-a com, por exemplo,
- 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:
git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git- 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:
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 vendor/ com qualquer versão mais nova das bibliotecas requisitadas.
Frequentemente isto significa rodar o comando Compositor, veja abaixo #Fetch external libraries para mais detalhes
composer update --no-dev
Após a atualização/upgrade do código e das bibliotecas necessárias você deve executar o MediaWiki update.php script na linha de comando para atualizar as tabelas do banco de dados conforme necessário:
php maintenance/run.php update
Se você usa MediaWiki-Vagrant, ele oferece um único comando, vagrant git-update, 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 (por exemplo, a partir do ramo master para um ramo ou tag diferente), faça o checkout do ramo ou tag em particular que deseja dentro do seu diretório de clone do MediaWiki:
git checkout <nome_do_ramo>
ou
git checkout <nome de 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
Baixar uma extensão
- In the next commands, replace
<EXT>with the name of the extension you want to download, without spaces. For Extension:TitleKey, it would be TitleKey. (case sensitive!)
Baixe e clone uma extensão do Git:
Com sua conta de desenvolvedor, use esses comandos para pegar a branch master:
cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT>
Para copiar e verificar uma versão estável no lugar, use esses comandos:
cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_42
Você pode visualizar o código-fonte da extensão no aplicativo gitiles de Gerrit, e no URL:
https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD
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
Ou, para testar uma versão estável da branch no lugar, use esse comando:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_42
Depois de rodar o comando git clone, continue com esses comandos:
cd /path/to/extensions
git submodule update --init --recursive
A qualquer momento, para atualizar todas as extensões para as versões mais recentes dessa ramificação, digite:
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_41 origin/REL1_41 || :'
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:
git submodule foreach 'git checkout -b origin/master || :'
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
- Remova o “
require_once …” ou “wfLoadExtension( … )” doLocalSettings.php - Remova qualquer linha referente à extensão em
composer.local.json(geralmente na seção “extra → merge-plugin → include”) - Remova os diretórios de extensão em
install-dir/extensions/
Usando o Git para baixar aparências do MediaWiki
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
Apêndice
O Revisão de 14:26, 21 de março de 2019 mudou o padrão de conexão com gerrit.wikimedia.org:
De:
- gerrit.wikimedia.org/r/p/mediawiki
Para:
- gerrit.wikimedia.org/r/mediawiki