diff --git a/cap02.Rmd b/cap02.Rmd index 3d5b425fa9139f4bdb6118f910e068b3ab38cd9e..c97b0996f2517208ce162d1f9465b96fcd4fb154 100644 --- a/cap02.Rmd +++ b/cap02.Rmd @@ -2,18 +2,165 @@ title: 'Capítulo 2: Instalação e Configuração' author: "Jhenifer" date: "29/10/2015" -output: html_document +output: + html_document: + keep_md: yes --- ```{r setup, include=FALSE} knitr::opts_chunk$set(echo = TRUE) ``` -1. Instalação: - - Escrever passo a passo a instalação do Git nos sistemas operacionais citados abaixo. -1.1 Windows -1.2 Linux -1.3 MacOS +## Instalação: + +#### Windows +Usuários Windows devem visitar [Git for Windows](https://git-for-windows.github.io/ "Git"), clicar em "Download" e baixar o arquivo ".exe". + +Após o download, execute o arquivo e você terá essa tela: + + + + + +Como de costume, clice em "Next". Para dar continuidade a instalação aceite a licença do Git. + +O diretório apresentado na figura a baixo vem como default, porém é possível alterar a instalação para um diretório de sua preferência. Depois de selecionado o caminho da instalação, clique em "Next" para prosseguir. + + + + + +Na tela de componentes podemos definir atalhos, integração ao menu de contexto do Windows Explorer, associação de arquivos e uso de font TrueType. O Git Bash é o prompt de comandos próprio, que além dos comandos Git também fornece alguns comandos Unix que podem ser bem úteis. E o Git GUI que é uma interface para trabalhar com Git. É recomendável a seleção de ambos os itens. Depois de selecionado os componentes de sua preferência, dê continuidade. + + + + + +Aqui, o instalador nos oferece a oportunidade de mudar o nome da pasta no menu iniciar, recomenda-se deixar o padrão para fácil localização posteriormente. + + + + + +Na tela de configuração "PATH environment", podemos escolher as formas de integração do Git em nosso sistema. +A primeira opção nos permite usar o Git apenas pelo "Git Bash" (é o prompt de comando do Git), a segunda opção nos possibilita executar os comandos no "Git Bash"" e no prompt de comando do Windows (cmd.exe), e a terceira opção é a junção das duas de cima, porém alguns comandos do Windows serão substituídos por comandos Unix com mesmo nome. +Essa última opção não é recomendada, portanto a primeira opção é a desejável. + + + + + +Abaixo, a configuração de quebra de linha. Windows e sistemas Unix (Linux, Mac) possuem formatos diferentes de quebra de linha em arquivos de texto. Se você escreve um código com quebras de linha no formato Windows, outra pessoa pode ter problemas ao abrir o mesmo arquivo em um Linux, e vice-versa. Esta opção, portanto, permite normalizar isso. +A primeira opção converte automaticamente os arquivos para padrão Windows quando receber algum arquivo e converterá para padrão Unix quando “comitar” (enviar alterações) no repositório. A segunda opção, não faz nenhuma conversão ao receber arquivos, mas convertem para padrão Unix ao “comitar”. Já a terceira opção, o Git não fará nenhuma conversão. +Recomenda-se a seleção da opção "Checkout Windows-style, commit Unix-Style line endings". + + + + + +Aqui, a configuração do emulador de terminal para usar com o Git Bash. +A primeira opção utiliza o terminal MSys2 (Shell), que permite utilizar comandos Unix no Windows. E a segunda opção, utiliza o terminal padrão do Windows. A melhor opção é a primeira. Feito isso, dê continuidade a instalação. + + + + +E por último, configurando ajustes de performance. Essa opção é para habilitar o sistema de cache de arquivo. + + + + +Feito isso, “Next”, “Finish” e o Git está instalado. + + +#### Linux + +Em qualquer sistema Linux, pode-se utilizar o gerenciador de pacotes da respectiva distribuição para instalar o Git. +Basta executar o código de instalação de sua respectiva distribuição. + + +**Debian** + +Em uma sessão de terminal Linux de distribuições Debian (Ubuntu, Mint), execute o código abaixo. +Adicione o ppa para obter a versão mais recente do Git. +```{r, engine="sh", eval=FALSE} +sudo add-apt-repository ppa:git-core/ppa +sudo apt-get update +``` + +Agora, execute o comando abaixo para instalação do Git. +Siga as instruções do prompt de comando, primeiro confirmando a instalação dos pacotes e suas dependências, depois confirmando a instalação do pacote git-core. +```{r, engine="sh", eval=FALSE} +sudo apt-get install git git-core git-man git-gui git-doc \ + ssh openssh-server openssh-client +git --version +``` + +Para adicionar ferramentas complementares, execute: +```{r, engine="sh", eval=FALSE} +sudo apt-get install gitk meld +``` + + +**Arch** + +```{r, engine="sh", eval=FALSE} +pacman -S git openssh meld +git --version +``` + + +**Fedora** + +```{r, engine="sh", eval=FALSE} +Yum install git +git --version +``` + +Usuários de outra versão do Linux dever visitar [Download for Linux](https://git-scm.com/download/linux). + + +#### MacOS +Exitem duas maneiras de instalar o Git no Mac, uma pelo instalador e outra através do MacPorts. + +**Utiizando o Instalador** + +O usuário deverá acessar [Download for Mac](http://git-scm.com/downloads), clicar em "Download" e baixar o arquivo ".dmg". + +Após o download, é necessário clicar duas vezes para ter acesso ao pacote de instalação. Dentro do arquivo ".dmg", execute o arquivo ".pkg" para iniciar a instalação. +Siga os passos até concluir a instalação. É recomendável utilizar a instalação padrão. + +Para testar a instalação, abra o terminal e digite o comando “git”. A saída deverá ser similar à imagem: + + + +**Utiizando o MacPorts** + +A maneira mais fácil de instalar Git no Mac é via [MacPorts](http://www.macports.org), para isso basta executar o seguinte comando: +```{r, engine="sh", eval=FALSE} +sudo port install git-core +``` + + +## Configurando Perfil +As configurações vão determinar algumas opções globais do Git e é necessário fazê-las apenas uma vez. + +Os comandos abaixo vão configurar o nome de usuário e endereço de e-mail. Esta informação é importante pois anexa os commits que você realiza, ou seja, as configurações ficarão associadas ao trabalho em desenvolvimento, permitindo que os colaboradores/gestores do projeto identifiquem suas contribuições. + +Caso o projeto seja individual, a importância de configurar usuário e e-mail se mantém, uma vez que se trabalha com duas máquinas, é possível a identificação no nome de usuário. + +Em um terminal Bash, execute o código abaixo: +```{r, engine="sh", eval=FALSE} +git config --global user.name "Knight Rider" +git config --global user.email "batman@justiceleague.org" +``` + +A opção `--global` usará essa informação para todo projeto Git da máquina. +É possível fazer definições para cada projeto, ou seja, não globais. Para isso é necessário executar o comando a seguir sem a opção `--global`. + +```{r, engine="sh", eval=FALSE} +git config user.name "Knight Rider" +git config user.email "batman@justiceleague.org" +``` + +Uma vez configurado o perfil, o Git está pronto para uso. -2. Configurando Perfil -- Comandos necessários para configurar nome de usuáro e email. diff --git a/cap02.md b/cap02.md new file mode 100644 index 0000000000000000000000000000000000000000..6c76951063e6582b7845e8087f82b3802f52e60e --- /dev/null +++ b/cap02.md @@ -0,0 +1,167 @@ +# Capítulo 2: Instalação e Configuração +Jhenifer +29/10/2015 + + + +## Instalação: + +#### Windows +Usuários Windows devem visitar [Git for Windows](https://git-for-windows.github.io/ "Git"), clicar em "Download" e baixar o arquivo ".exe". + +Após o download, execute o arquivo e você terá essa tela: + + + + + +Como de costume, clice em "Next". Para dar continuidade a instalação aceite a licença do Git. + +O diretório apresentado na figura a baixo vem como default, porém é possível alterar a instalação para um diretório de sua preferência. Depois de selecionado o caminho da instalação, clique em "Next" para prosseguir. + + + + + +Na tela de componentes podemos definir atalhos, integração ao menu de contexto do Windows Explorer, associação de arquivos e uso de font TrueType. O Git Bash é o prompt de comandos próprio, que além dos comandos Git também fornece alguns comandos Unix que podem ser bem úteis. E o Git GUI que é uma interface para trabalhar com Git. É recomendável a seleção de ambos os itens. Depois de selecionado os componentes de sua preferência, dê continuidade. + + + + + +Aqui, o instalador nos oferece a oportunidade de mudar o nome da pasta no menu iniciar, recomenda-se deixar o padrão para fácil localização posteriormente. + + + + + +Na tela de configuração "PATH environment", podemos escolher as formas de integração do Git em nosso sistema. +A primeira opção nos permite usar o Git apenas pelo "Git Bash" (é o prompt de comando do Git), a segunda opção nos possibilita executar os comandos no "Git Bash"" e no prompt de comando do Windows (cmd.exe), e a terceira opção é a junção das duas de cima, porém alguns comandos do Windows serão substituídos por comandos Unix com mesmo nome. +Essa última opção não é recomendada, portanto a primeira opção é a desejável. + + + + + +Abaixo, a configuração de quebra de linha. Windows e sistemas Unix (Linux, Mac) possuem formatos diferentes de quebra de linha em arquivos de texto. Se você escreve um código com quebras de linha no formato Windows, outra pessoa pode ter problemas ao abrir o mesmo arquivo em um Linux, e vice-versa. Esta opção, portanto, permite normalizar isso. +A primeira opção converte automaticamente os arquivos para padrão Windows quando receber algum arquivo e converterá para padrão Unix quando “comitar” (enviar alterações) no repositório. A segunda opção, não faz nenhuma conversão ao receber arquivos, mas convertem para padrão Unix ao “comitar”. Já a terceira opção, o Git não fará nenhuma conversão. +Recomenda-se a seleção da opção "Checkout Windows-style, commit Unix-Style line endings". + + + + + +Aqui, a configuração do emulador de terminal para usar com o Git Bash. +A primeira opção utiliza o terminal MSys2 (Shell), que permite utilizar comandos Unix no Windows. E a segunda opção, utiliza o terminal padrão do Windows. A melhor opção é a primeira. Feito isso, dê continuidade a instalação. + + + + +E por último, configurando ajustes de performance. Essa opção é para habilitar o sistema de cache de arquivo. + + + + +Feito isso, “Next”, “Finish” e o Git está instalado. + + +#### Linux + +Em qualquer sistema Linux, pode-se utilizar o gerenciador de pacotes da respectiva distribuição para instalar o Git. +Basta executar o código de instalação de sua respectiva distribuição. + + +**Debian** + +Em uma sessão de terminal Linux de distribuições Debian (Ubuntu, Mint), execute o código abaixo. +Adicione o ppa para obter a versão mais recente do Git. + +```sh +sudo add-apt-repository ppa:git-core/ppa +sudo apt-get update +``` + +Agora, execute o comando abaixo para instalação do Git. +Siga as instruções do prompt de comando, primeiro confirmando a instalação dos pacotes e suas dependências, depois confirmando a instalação do pacote git-core. + +```sh +sudo apt-get install git git-core git-man git-gui git-doc \ + ssh openssh-server openssh-client +git --version +``` + +Para adicionar ferramentas complementares, execute: + +```sh +sudo apt-get install gitk meld +``` + + +**Arch** + + +```sh +pacman -S git openssh meld +git --version +``` + + +**Fedora** + + +```sh +Yum install git +git --version +``` + +Usuários de outra versão do Linux dever visitar [Download for Linux](https://git-scm.com/download/linux). + + +#### MacOS +Exitem duas maneiras de instalar o Git no Mac, uma pelo instalador e outra através do MacPorts. + +**Utiizando o Instalador** + +O usuário deverá acessar [Download for Mac](http://git-scm.com/downloads), clicar em "Download" e baixar o arquivo ".dmg". + +Após o download, é necessário clicar duas vezes para ter acesso ao pacote de instalação. Dentro do arquivo ".dmg", execute o arquivo ".pkg" para iniciar a instalação. +Siga os passos até concluir a instalação. É recomendável utilizar a instalação padrão. + +Para testar a instalação, abra o terminal e digite o comando “git”. A saída deverá ser similar à imagem: + + + +**Utiizando o MacPorts** + +A maneira mais fácil de instalar Git no Mac é via [MacPorts](http://www.macports.org), para isso basta executar o seguinte comando: + +```sh +sudo port install git-core +``` + + +## Configurando Perfil +As configurações vão determinar algumas opções globais do Git e é necessário fazê-las apenas uma vez. + +Os comandos abaixo vão configurar o nome de usuário e endereço de e-mail. Esta informação é importante pois anexa os commits que você realiza, ou seja, as configurações ficarão associadas ao trabalho em desenvolvimento, permitindo que os colaboradores/gestores do projeto identifiquem suas contribuições. + +Caso o projeto seja individual, a importância de configurar usuário e e-mail se mantém, uma vez que se trabalha com duas máquinas, é possível a identificação no nome de usuário. + +Em um terminal Bash, execute o código abaixo: + +```sh +git config --global user.name "Knight Rider" +git config --global user.email "batman@justiceleague.org" +``` + +A opção `--global` usará essa informação para todo projeto Git da máquina. +É possível fazer definições para cada projeto, ou seja, não globais. Para isso é necessário executar o comando a seguir sem a opção `--global`. + + +```sh +git config user.name "Knight Rider" +git config user.email "batman@justiceleague.org" +``` + +Uma vez configurado o perfil, + diff --git a/images/inst01.png b/images/inst01.png new file mode 100644 index 0000000000000000000000000000000000000000..644047194c388427fb55b336fc728d890f46bfdd Binary files /dev/null and b/images/inst01.png differ diff --git a/images/inst02.png b/images/inst02.png new file mode 100644 index 0000000000000000000000000000000000000000..15bf989a939775f1e75dc67ee422c4de255e5468 Binary files /dev/null and b/images/inst02.png differ diff --git a/images/inst03.png b/images/inst03.png new file mode 100644 index 0000000000000000000000000000000000000000..c2f54df2b9551031f181559b1beab228de21e4b8 Binary files /dev/null and b/images/inst03.png differ diff --git a/images/inst04.png b/images/inst04.png new file mode 100644 index 0000000000000000000000000000000000000000..2bdd2a35c63c8903bef786dadcc8f85b593ff61c Binary files /dev/null and b/images/inst04.png differ diff --git a/images/inst05.png b/images/inst05.png new file mode 100644 index 0000000000000000000000000000000000000000..a9354105f0dc506e6f65e99b83f59d6c0af682bc Binary files /dev/null and b/images/inst05.png differ diff --git a/images/inst06.png b/images/inst06.png new file mode 100644 index 0000000000000000000000000000000000000000..f27b39ce48c3e8f843e3d8240746633de402c159 Binary files /dev/null and b/images/inst06.png differ diff --git a/images/inst07.png b/images/inst07.png new file mode 100644 index 0000000000000000000000000000000000000000..9044b57a2429e269ee23d31b7ac9cdd1bc3f920d Binary files /dev/null and b/images/inst07.png differ diff --git a/images/inst08.png b/images/inst08.png new file mode 100644 index 0000000000000000000000000000000000000000..2c02997e78a113db5dd978ec754ba8a99dc87049 Binary files /dev/null and b/images/inst08.png differ diff --git a/images/inst09.png b/images/inst09.png new file mode 100644 index 0000000000000000000000000000000000000000..d753c27d652595bb2b1c9767e09ed4a3a7e528cf Binary files /dev/null and b/images/inst09.png differ