GitHub Pages: Minimal Mistakes

O GitHub é uma plataforma de hospedagem de código-fonte com controle de versão usando o Git. Ele permite que programadores, utilitários ou qualquer usuário cadastrado na plataforma contribuam em projetos privados e/ou Open Source de qualquer lugar do mundo.

• https://www.cross-validated.com/Personal-website-with-Minimal-Mistakes-Jekyll-Theme-HOWTO-Part-II/
• http://prettyquestions.com
• https://mmistakes.github.io/minimal-mistakes
• https://github.com/mmistakes/minimal-mistakes
• https://medium.com/@tienduy/build-your-personal-website-without-spending-any-money-30e6b2264e08
• https://zenglix.github.io/personal_website/
• https://copdips.com/2018/05/setting-up-jekyll-with-minimal-mistakes-theme-on-windows.html

Sendo possível hospedar arquivos, é possivel também hospedar páginas na internet por meio do GitHub Pages. Essas páginas podem servir para divulgar exemplos, demos, documentações e qualquer outro tipo de informação sobre o seu projeto.

Aviso: Esse post tem a finalidade de armazenar os comandos e procedimentos que executei durante aprendizado e desenvolvimento do MichelMetran.github.io.

Recomenda-se adicionar uma chave SSH na conta do GitHub. Com isso, não será mais necessário digitar o usuário/senha a cada commit, ou seja, a cada atualização do repositório. Fiz isso seguindo o procedimento apresentado aqui.

Nota: Lembrando que para todas as alterações futuras faz-se necessário estar, no terminal, dentro da pasta para dar os comandos add, commit e push. No meu caso é o seguinte comando: cd /home/michel/Documents/GitRepo/michelmetran.github.io

Criando o site no GitHub Pages

O repositório do site

Inicialmente é necessário criar um repositório, por meio da interface gráfica mesmo, no seu GitHub. Esse repositório deve, obrigatoriamente, ter o mesmo nome do seu usuário.

Após isso basta ir até o diretório local que você deseja armazenar os arquivos do seu repositório e dar o comando abaixo. O comando clone copia o conjunto de arquivos de um repositório do GitHub para o diretório local do computador.

cd /home/michel/Documents/GitRepo
git clone [email protected]:michelmetran/michelmetran.github.io.git

Acesse o diretório e crie o primeiro arquivo que será inserido na página index.html

cd michelmetran.github.io
echo "Hello World" > index.html

Agora é necessário fazer o upload de tais alterações para o GitHub.

git add --all
git commit -m "Initial commit"
git push -u origin master

Nota: Com isso já foi possível subir um arquivo simples com extensão .html. Agora dá pra pensar em diversas possibilidades…

Para sites com maior detalhamento, excluí esse repositório por meio da interface gráfica e fiz o Fork de um template, conforme apresento no tópico abaixo, sobre Meu site….

Meu site MichelMetran.github.io

Fiz meu site usando o template Beautiful Jekyll, conforme as instruções fornecidas pelo site. Basicamente dei um Fork no repositório do template, ou seja, copiei o template para mim.

Após isso, clonei os arquivos para o meu computador.

cd /home/michel/Documents/GitRepo
git clone [email protected]:michelmetran/michelmetran.github.io.git

Fiz as alterações nos arquivos locais e fiz o upload de tais alterações para o GitHub.

git add --all
git commit -m "Initial commit"
git push -u origin master