Se você ainda não tem o git no seu computador, instale-o aqui
Abra o terminal ou cmd e digite:
git config --global user.name "Seu Nome"
git config --global user.email "[email protected]"
Clique no botão "Fork" no canto superior direito da página, isto irá criar uma cópia deste repositório para a sua conta.
dica: Se você estiver na página do github.io acesse o repositório em github.com para criar o fork.
Clone o seu Fork para a sua máquina, este comando irá relizar o "donwload" do repositório, assim você poderá editar os arquivos localmente para depois enviá-los de volta para o GitHub.
dica: observe se o seu nome de usuário está na url a ser clonada
dica: navege para o Desktop ou para alguma pasta do seu computador em que você queira baixar os arquivos antes de clonar
Para clonar digite em seu terminal:
git clone https://github.com/seuUsuario/WorkshopGit.git
Então vá para a pasta "WorkshopGit" e edite o arquivo README.md, você pode utilizar qualquer editor de texto a sua escolha, como por exemplo o bloco de notas ou o VSCode
Note que no arquivo README.md existe um template, mas fique livre para modificar o template da forma que preferir, o arquivo agora é seu!
Volte para as instruções quando tiver terminado de editar o arquivo README.md da forma que você gostaria
Nem sempre você irá querer "salvar" todos os arquivos que foram modificados naquele momento no git, apenas os arquivos adicionados à zona de stage são commitados, você pode especificar arquivo por arquivo a ser adicionado, digitando os seus nomes, ou utilizar o símbolo: .
para indicar todos os arquivos da pasta, assim:
dica: utilize o comando git status
a cada mudança, bem como antes e depois do comando git add.
dica: experimente criar um novo arquivo na pasta, com o nome de "localNotes.md" por exemplo, na qual você não quer compartilhar por exemplo
git add .
-
Assim você irá salvar suas modificações no repositório local
-
Dê um "Push" para que as modificações sejam enviadas para o servidor do GitHub!
git commit -m 'mensagem legal explicando o voce mudou'
git push
Agora se tudo deu certo até então, você poderá ver as suas mudanças no seu repositório no servidor do GitHub.
Na aba de Settings desça até encontrar a parte de GitHub Pages, utilize o Theme Chooser para escolher um dos templates para o seu site clicando no botão Choose a theme
Pronto agora você já tem sua própria página online através do GitHub Pages, e a url está disponível em Settings > GitHub Pages, se você renomear o repositório para "seunomedeusuario.github.io", essa será a url do seu site.
dica: além dos templates disponíveis no Theme Chooser que são configuráveis em um clique, você também pode configurar manualmente outros templates depois se achar interessante, aqui você encontra uma lista mais completa. Você também pode criar seus próprios templates Jekyll.
Este tutorial foi criado com ❤️ por Otacilio Maia, sinta-se à vontade para tirar dúvidas através do email [email protected] ou através de redes sociais.
Aproveite e confira a sessão de indo além logo abaixo para conhecer mais conceitos de Git.
git branch
Retorna uma lista com os branches, o item marcado com um asterisco é o branch atual.
Um dos conceitos mais interessantes de git é o de branch, por padrão todo repositório começa com um branch master, onde no branch master deve conter a versão mais estável do seu código, que é entregue aos seus usuários.
Justamente para evitar quebrar o código principal enqunto o desenvolvimento acontece, é muito comum criar-se pelo menos mais um branch, chamado develop, que é usado durante o desenvolvimento, e uma vez que a versão está estável o suficiente para um release, enviamos o código para o master.
Uma das técnicas mais comuns de gerenciamento de repositório é o git flow, este artigo explica com detalhes
git branch nome-do-branch
Cria um novo branch, note que ao criar um novo branch com git branch você continua no branch atual.
git pull
Obtém as mudanças do seu servidor remoto (No caso do repositório do GitHub), para o seu servidor local (No caso o seu computador), se não houver mudanças é exibida a mensagem Already up to date.
git checkout nome-do-branch
Muda para o branch selecionado, também é possível criar um novo branch e mudar para o branch utilizando o comando git checkout -b "nome-do-branch"
git stash
Adiciona as mudanças não commitadas em uma pilha temporária. Muito últil quando você não quer mais continuar um certo trabalho no momento, ou para evitar conflitos momentaneamente.
git stash pop
Recupe os arquivos do topo da pilha temporária de stash
git log
Lista o histórico de versionamento do branch atual.