Skip to content
Tulio edited this page Dec 26, 2024 · 4 revisions

Instruções para clonar repositório

Pré-requisitos

Git

Windows

Instalar o Git no Windows tem vários métodos, escolha o de sua preferência

De acordo com a página oficial, há versão para 32 bits, 64 bits e com o winget, usando o comando winget install --id Git.Git -e --source winget.

Se não tem certeza qual utilizar, o mais provável é que a versão em 64 bits seja a correta.

Linux

É bastante provável que o git já esteja instalado ou que você saiba como fazer isso.

Terminal

Windows

O terminal é opcional, mas é bastante recomendado para uma experiência mais agradável. Ainda será possível utilizar o CMD (terminal padrão do Windows) ou o PowerShell (terminal mais atualizado do Windows e que aceita vários comandos em comum com os terminais Linux), mas ao instalar o Git ele disponibiliza outro terminal, o GitBash.

É possível acessar a pasta do projeto de duas principais maneiras, abrindo o programa GitBash e navegando até a pasta pelo próprio terminal ou abrindo o Windows Explorer, navegando até a pasta do projeto e clicando com o botão direito e abrindo a opção Open GitBash here, se a opção não estiver disponível, deve haver uma que mostre Mostrar mais opções, como na imagem abaixo.

imagem do windows explorer com opções padrão do botão direto do mouse

Uma alternativa mais simples de usar é instalar o programa Terminal do próprio Windows, que permite a utilização de todos os programas de terminal instalados no computador.

Chave SSH

  1. Se não tiver uma chave ssh de sua preferencia, crie uma chave seguindo as instruções em

https://www.ssh.com/academy/ssh/keygen#choosing-an-algorithm-and-key-size

Nota: As chaves SSH estão armazenadas na pasta $HOME/.ssh . De preferẽncia, não use outra pasta, a menos de uma necessidade absoluta.

  1. Carregue chave publica SSH no github. Ver https://github.com/settings/keys no seu login do github. Pode ser copiando e colando o texto da cave pública. Cole em
  • Authentication keys

  • Signing key.

Pode ser a mesma chave pública para as duas operações. Usei id_ed25519 que eu ja tinha para o gerrit.libreoffice.org.

Clonar o repositório.

Clonar manualmente

Clone o repositório numa pasta de trabalho. Por exemplo, $HOME/Documentos. Navegue até a pasta e comande

git clone ssh://git@github.com/LibreOffice/LOGuidesBR

A clonagem cria uma pasta de nome LOGuidesBR na pasta de trabalho (por exemplo, $HOME/Documentos )

Nota: NÃO clone o repositório com https://. Use sempre o ssh:// .

Se for pedida a chave SSH, informe a senha de sua chave privada.

Clonar no OmegaT

No OmegaT, abra o projeto de equipe. Preencha os campos da autenticação:

URL: ssh://git@github.com/LibreOffice/LOGuidesBR

Se for pedida a chave SSH, informe a senha de sua chave privada.

Pasta de destino: o OmegaT sugere uma pasta de nome LOGuidesBR na pasta raiz ($HOME) de seu usuário local. Pode ser colocada em $HOME/Documentos .

Considerações

No OmegaT, o processo de baixar e subir or arquivos para o github é transparente. As mudanças (push) são atualizadas automaticamente.

O emprego de https:// exige usuário e senha de acesso ao github, porém o github não dá acesso a um terminal. Evite https e use o ssh://