Download do Git

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Download from Git and the translation is 95% complete.

Outdated translations are marked like this.
Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎हिन्दी • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎Kurdî • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎नेपाली • ‎Nederlands • ‎occitan • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎slovenčina • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
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 para poder usar isso. Ha muitas maneiras de adquirir o Git, dependendo do seu sistema operacional. Para o Código-fonte e 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 instalar no seu sistema operacional.

It is recommended that you have composer installed to download and install third party libraries, but not required.composer

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

Isto clona todo o repositório do núcleo do MediaWiki. O pacote padrão será o de ponta, versão do desenvolvedor do MediaWiki. Uma vez que o repositório é clonado, você pode facilmente mudar para diferentes ramos ou tags (veja abaixo), incluindo as versões estáveis ​​de rastreamento do MediaWiki.

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

Fetch external libraries

Starting with MediaWiki 1.25, some external libraries that MediaWiki requires are no longer in this "core" git repository. Nós usamos composer para gerenciá-los. Para instalar essas bibliotecas se necessárias, você pode escolher:

  • Se você não quer usar o compositor ou se quiser usar o mesmo conjunto de bibliotecas de fornecedores, como usado no cluster de produção do WMF, você pode adicionar git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git para criar um diretório de vendor/$ dentro da pasta principal da sua instalação do MediaWiki . Certifique-se de usar o ramo direito para a sua versão MediaWiki (e.g. REL1_25 para 1.25).

Versões especificas do MediaWiki

Ramificações WMF

Os Pacotes remotos seguem as versões do MediaWiki usadas no cluster do servidor do Wikimedia Foundation. Estes podem não ser totalmente estáveis, mas eles recebem correções de erros muito rápidas e geralmente são bastante estáveis – Afinal, estes são os principais projetos como a Wikipedia estão usando. Uma vez que um REL* ramo é considerado 'estável', nós 'etiquetamos' e transformá-lo em um lançamento tarball.

Para ver quais ramos estão disponíveis, mude para o diretório principal do MediaWiki e digite o seguinte comando:

git branch -r | sort -V

Principais lançamentos são denotadas por "origin/REL<release number>", e.g. "2". Para mudar para uma ramificação especial:

git checkout -b REL<número de lançamento> origin/REL<número de lançamento>

Por exemplo, para alterar a versão estável atual, 1.30.0, digite:

git checkout -b REL1_30 origin/REL1_30

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. Você pode ver as versões 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:

git checkout <nome da etiqueta>

Ú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 ramo específico ou a versão de desenvolvimento (ramo "mestre") do MediaWiki, pegar as últimas mudanças é relativamente fácil. Mude para o seu diretório de clones MediaWiki e emita o git pull comando:

git pull

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

A nova versão do núcleo pode exigir versões mais recentes de extensões e skins, então você deve entrar em cada extensão e diretório de skin e atualizá-lo com um comando como git pull --recurse-submódulos.

Após a atualização, você deve executar o script de linha de comando MediaWiki update.phpManual:update.php para atualizar as tabelas do banco de dados conforme necessário:

php maintenance/update.php

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

Se você usar MediaWiki-Vagrant, 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>.git

Clone de desenvolvedores com:

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

Você pode visualizar o código fonte da extensão no aplicativo Difusão de Phabricator, e no URL:

https://phabricator.wikimedia.org/r/p/mediawiki/extensions/<EXT>;browse/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/p/mediawiki/extensions.git
cd extensions
git submodule update --init --recursive

Posteriormente, para atualizar todas as extensões para suas versões mais recentes, basta fazer o seguinte:

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

Para acompanhar um pacote específico:

git submodule foreach 'git checkout -b REL1_30 origin/REL1_30 || :'

If you only need a read-only checkout (for instance to grep or analyse all MediaWiki code), you can use the shared MediaWiki checkout on Labs, without downloading anything on your machines.

Remova uma extensão

Basta remover a pasta de extensão e remover a "require_once …" do 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.

Follow the exact same procedure as for extensions (described in the previous section), but using skins rather than extensions in all URLs and paths.

Detailed installation instructions are available on each skin's page here on MediaWiki.org, for example see Skin:Vector#Installation. Instructions for all other skins are analogous.

Ver também