6.1. Requisitos mínimos

6.1.1. Criando conta de usuário no github

Para poder contribuir com alterações nos livros é necessário possuir uma conta no github, portanto, caso você não tenha um usuário crie sua conta agora.

[Importante]

Acesse agora https://github.com para criar uma conta de usuário para você, caso você ainda possua. OBS: No github a senha precisa conter pelo menos um número e uma letra.

6.1.2. Instalando git no Linux

O seguinte comando instala o git no linux:

sudo apt-get install git-core gitg
[Importante]

Na instalação do git, recomendamos a criação de uma chave ssh, conforme as instruções em https://help.github.com/articles/generating-ssh-keys.

[Cuidado]

Se a versão do git (git --version) for inferior a 1.7.10, o clone com https não irá funcionar. Neste caso você deve atualizar o git ou criar uma chave ssh e clonar o projeto com o endereço ssh. Detalhes do erro e da solução pode ser encontrados respectivamente em: https://help.github.com/articles/https-cloning-errors e https://help.github.com/articles/generating-ssh-keys.

6.1.3. Instalando git(hub) no Windows

[Dica]

Produzimos um vídeo demonstrando a instalação no windows:

As instruções de instalação do git no windows pode ser consultada em https://help.github.com/articles/getting-started-with-github-for-windows.

O binário do git pode ser baixado em http://github-windows.s3.amazonaws.com/GitHubSetup.exe.

[Nota]

No cliente do git no windows, uma chave ssh é automaticamente criada e adicionada ao git.

6.1.4. Instalando git no Mac

Para a instalação do git siga as intruções em http://mac.github.com.

6.1.5. Configurando sua identidade

Comando para configurar sua identidade. 

$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com

6.1.6. Editor de texto no Linux

No linux recomendamos utilização do vim ou gedit para instalação do plugin de highlight do asciidoc.

Plugin de highlight
https://launchpad.net/asciidoc-gtk-highlight ou https://launchpad.net/asciidoc-gtk-highlight/trunk/0.1/+download/asciidoc-gtk-highlight.tar.gz. O arquivo possui um arquivo README com as intruções de instalação.

Figura 6.1. Highlight do plugin no gedit

images/instalacao-ferramentas/highlight-gedit.png

6.1.7. Editor de texto no Windows

No window recomendamos utilizar o Notepad++ para edição. Baixe e instale a versão que desejar.

[Dica]

Criamos um plugin de highlight para o Notepad++, está disponível em https://github.com/edusantana/asciidoc-highlight. O seguinte vídeo ensina como instalar o plugin:

Figura 6.2. Highlight do plugin no Notepad++

images/instalacao-ferramentas/highlight-notepadpp.png