├── LICENSE
├── README.md
└── assets
├── clone.png
├── exemplo.png
├── logo_elas.png
├── opendevufcg_icon.png
├── repo-remoto.png
└── repositorio.png
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2020 Elas@Computação
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # 👩💻 Introdução a Git & Github
2 |
3 |
4 |
5 |
6 |
7 | ## Índice
8 |
9 | - [O que é Git? E Github?](#o-que-é-git?-e-github?)
10 | - [Git - Instalando](#instalando-o-git)
11 | - [Configurando o ambiente](#configuração-inicial-do-git)
12 | - [Criando um repositório. Fluxo do Local > Remoto](#criando-um-repositório-local-e-conectando-ele-com-um-repositório-remoto)
13 | - [Adicionando o primeiro arquivo](#adicionando-o-primeiro-arquivo)
14 | - [Commit e Push do arquivo](#commitando-e-enviando-a-primeira-alteração)
15 | - [Criando um repositório. Fluxo do Remoto > Local](#criando-um-repositório-remoto-e-trazendo-pro-seu-ambiente-local)
16 |
17 |
18 | ## O que é Git? E Github?
19 |
20 | Git é um sistema open-source de controle de versão que se tornou muito popular e hoje é amplamente utilizado por desenvolvedores ao redor do globo, oferecendo muitas funcionalidades. Mas, por que devemos nos preocupar em ter um controle de versão?
21 |
22 | Em resumo: se você vai desenvolver um sistema sozinho ou em equipe, o Git vai registrar as alterações do arquivo -ou conjunto de arquivos- ao longo do tempo, permitindo que você possa recuperar alguma versão específica. O git também permite que você divida as funcionalidades do sistema, podendo atribuí-las a diferentes pessoas e, ao final do projeto, você pode juntar todas essas funcionalidades em um único sistema.
23 |
24 | O Github é uma plataforma para hospedagem de código-fonte e repositórios Git, contendo ainda funcionalidades próprias e permitindo que pessoas acessem projetos privados ou Open Source de qualquer lugar do mundo.
25 |
26 |
27 | ## Instalando o Git
28 |
29 | #### Para começar, é preciso ter o Git instalado na sua máquina e também ter uma conta no Github
30 |
31 | - Para sistemas baseados em Debian/Ubuntu, execute o comando:
32 |
33 | ```$ apt-get install git```
34 |
35 | - Para o Ubuntu, esta PPA oferece a versão mais atual e estável do Git:
36 |
37 | ```
38 | $ add-apt-repository ppa:git-core/ppa
39 | $ apt update
40 | $ apt install git
41 | ```
42 | Assim que finalizar a instalação, utilize o comando ```git --version```para ter certeza de que tudo ocorreu bem.
43 |
44 | - Se você utiliza outro sistema (Linux/Unix, Windows ou MacOS), [clique neste link](https://git-scm.com/downloads).
45 |
46 | ## Configuração inicial do Git
47 |
48 | #### Para começar a utilizar o Git, é necessário que você configure os dados da sua conta do Github
49 |
50 | $ git config --global user.name "Seu UserName"
51 | $ git config --global user.email seuemail@exemplo.com
52 |
53 | Se você quiser checar todas as configurações possíveis, [clique neste link](https://www.git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup).
54 |
55 | ## Criando seu primeiro repositório
56 |
57 | ### Criando um repositório local e conectando ele com um repositório remoto
58 | 1. Primeiro, certifique-se de que você está no diretório desejado e então crie a pasta.
59 | Se você preferir, pode fazer isso pelo terminal, por exemplo:
60 | ```
61 | $ cd Documentos/
62 | $ mkdir minha-pasta
63 |
64 | # o comando *cd* te direciona a um diretório, o comando *mkdir* cria uma pasta
65 | ```
66 |
67 | 2. Depois de criar a pasta, você deve ir até ela e iniciá-la como um repositório:
68 | ```
69 | $ cd minha-pasta/
70 | $ git init
71 | ```
72 |
73 | Para se certificar de que tudo deu certo, digite:
74 | ```$ git status```
75 |
76 | Irá aparecer uma mensagem dizendo *No commits yet*. Isso quer dizer que seu repositório foi criado, mas ele ainda está vazio. Por enquanto deixaremos assim.
77 | 3. Agora, vá até sua página do Github e para criar um repositório remoto clique em **New**.
78 |
79 |
80 |
81 | Digite o nome do repositório (que deve ser igual ao nome da pasta criada). Apenas o nome já é suficiente pra criar o repositório. No final da página, clique em **CreateRepository**
82 |
83 |
84 |
85 | 4. Agora, é hora de conectar o repositório local ao repositório remoto!
86 |
87 | Vá até o seu repositório remoto, clique em **Code** e copie o link HTTPS.
88 |
89 |
90 |
91 | Agora, volte ao terminal e digite:
92 |
93 | ```$ git remote add origin https://github.com/seuuser/minha-pasta.git```
94 |
95 | #### Adicionando o primeiro arquivo
96 | 5. Como o seu repositório local ainda está vazio, vamos adicionar um arquivo nele. Você pode usar um editor de texto qualquer para criar um arquivo e salvar na sua pasta,
97 | ou pode executar o comando:
98 |
99 | ```$ echo "# minha-pasta" >> README.md ```
100 |
101 | 6. Depois, adicione essa alteração no seu repositório:
102 |
103 | ```$ git add README.md```
104 |
105 | **Obs**: se você tiver adicionado um arquivo na sua pasta de outra forma,
106 | digite apenas ```$ git add ```
107 |
108 | #### Commitando e enviando a primeira alteração
109 | 7. Commite a alteração para o seu repositório remoto:
110 |
111 | ```$ git commit -m "mensagem/palavra que faça sentido"```
112 |
113 | 8. Agora, você pode enviar todas as alterações do seu repositório local de vez para o repositório remoto:
114 |
115 | ```$ git push```
116 |
117 | Serão solicitados seu username e sua senha. Depois de digitá-los,
118 | uma mensagem parecida com esta deve aparecer:
119 |
120 | ```
121 | Total 3 (delta 0), reused 0 (delta 0)
122 | To https://github.com/seuuser/minha-pasta.git
123 | [new branch] master -> master
124 | ```
125 |
126 |
127 | Prontinho! Você criou seu primeiro repositório local e enviou todas as alterações feitas nele para um repositório remoto!
128 |
129 | ### Criando um repositório remoto e trazendo pro seu ambiente local
130 |
131 | 1. Vá ao Github e crie um repositório. Depois que criá-lo, copie o link HTTPS:
132 |
133 |
134 |
135 | 2. No seu terminal, certifique-se de que está no diretório desejado.
136 | Agora, é só digitar o comando
137 |
138 | ```git clone ```
139 |
140 | Serão solicitados seu username e senha, depois irá aparecer uma mensagem parecida com esta:
141 |
142 | ```
143 | remote: Enumerating objects: 3, done.
144 | remote: Counting objects: 100% (3/3), done.
145 | remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
146 | Unpacking objects: 100% (3/3), 597 bytes | 597.00 KiB/s, done.
147 | ```
148 | Agora, você pode adicionar arquivos e enviá-los para o repositório remoto :)
149 |
150 |
151 |