webPageGitHub

webPageGitHub

How to create a webpage using GitHub and Jekyll

Trabalhando com Github Pages

Passo 1 - Faça um Fork

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.

Atenção Se você estiver na página do github.io acesse o repositório em github.com para criar o fork

Passo 2 - Clone o seu fork

Clone o seu Fork para a sua máquina, este comando irá criar uma cópia local do repositório, assim você poderá editar os arquivos no seu PC para depois enviá-los de volta para o repositório no GitHub.

Dica 1: observe se o seu nome de usuário está na url a ser clonada

Dica 2: Usando o bash do GIT ou o Terminal do Ubuntu, 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/webPageGitHub.git

Passo 3 - Edite o arquivo README.md na sua máquina

Então vá para a pasta "webPageGitHub" 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

Passo 4 - Adicione os arquivos modificados a zona de stage

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 .

Passo 6 - Faça um "Commit"

  • 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.

Passo 7 - Gerando um site com GitHub Pages

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.