Download do Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 67% 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 • ‎Հայերեն • ‎interlingua • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎kurdî • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎norsk bokmål • ‎नेपाली • ‎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 --branch REL1_31 install-dir

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.

To install into different directory, change that in the command line (for more info refer to these docs). Once the repository is cloned, you can easily switch to different branches or tags (see below), including those tracking unstable versions of MediaWiki. The development branch, master, is the cutting-edge, developer version of MediaWiki; you should not use master code for production under any circumstances as it is not considered stable.

If you want to reduce the number of revisions that are cloned, add --depth=1 to the above command.

That the release branches have a bunch of Git submodules in them, for commonly-used extensions and skins (the master branch does not have these). To update the submodules, run:

cd install-dir
git submodule update --init

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 --branch REL1_31 install-dir

Fetch external libraries

Nós usamos composer para gerenciá-los.

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

  • Se você não quiser usar o composer, ou se você quiser usar o mesmo conjunto de vendor libraries usadas no cluster de produção da WMF, você pode git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git para criar uma pasta vendor/ dentro da pasta core da sua instalação da MediaWiki.

Starting with MediaWiki 1.25, some external libraries that MediaWiki requires are no longer in this "core" git repository.

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:

You can see all available tags with:

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 1.31.0


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

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-submódulos.

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

composer update --no-dev

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


Se você usa MediaWiki-Vagrant, ele 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 --branch REL1_31

Clone de desenvolvedores com:

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

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

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

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions.git --branch REL1_31
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 || :'

Remember that you should only use versions of extensions from the same release as that version of MediaWiki and each other.

To track the master branch:

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

Please note that you should not use master code for production under any circumstances as it is not considered stable.

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

Basta remover a pasta da extensão e remover "require_once …" ou wfLoadExtension( … ) de 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.

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