KO
|
EN
gitlite — search
Search
#python
#javascript
#android
#vue
#react
#java
#golang
#cli
#nodejs
#go
#mongodb
#python2
joaopauloaramuni.github.io
★ 26
Open GitHub ↗
João Paulo Aramuni
Download README (.md)
Explore Similar Repositories
chess-stats-action
:
♟️ Automatically update your README.md with Chess.com games and stats - fully customizable
working-stats
:
a repository that collects all avaliable URL's for project github-readme-stats.
github-readme-stats1
:
No description available.
Gityzer
:
Generates personalized image summarizing your GitHub stats making your readme standout
Rootme-readme-stats
:
⚡ Dynamically generated your Root-me.org stats for your github readmes
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
joaopauloaramuni.github.io
?
Download (.md)
----- <img alt="githubpages" src="https://joaopauloaramuni.github.io/image/githubpages2.png?raw=true"/> ----- # Repo GitHub Pages          ## :octocat: O que é o GitHub Pages? O **GitHub Pages** é um serviço gratuito oferecido pelo GitHub que permite que você hospede sites diretamente de um repositório. É amplamente utilizado para criar **portfólios, blogs, páginas de projetos** ou documentações de forma simples e integrada ao fluxo de versionamento. Os sites do GitHub Pages podem ser gerados a partir de arquivos HTML estáticos ou usando geradores de site como o **Jekyll**, que é suportado nativamente. - Endereço típico: `https://<usuário>.github.io/<repositório>/` - Pode ser ativado nas configurações do repositório (Settings > Pages) - Pode usar domínio personalizado ## 🧑💻 Por que usar o GitHub Pages para criar seu portfólio? O **GitHub Pages** é uma excelente opção para desenvolvedores que desejam criar um site de currículo ou portfólio técnico, porque: - ✅ É gratuito e fácil de configurar - 🔗 Se integra diretamente com seu repositório GitHub - 🧾 Permite publicar HTML, CSS e JS sem precisar de um servidor - 🌐 Gera uma URL estável e profissional: `https://seunome.github.io/` - 🖼️ Pode hospedar imagens, projetos, e exemplos de código Você pode construir sua página manualmente com HTML/CSS ou usar templates prontos com **Jekyll**. É uma forma prática de apresentar seus projetos, contatos e experiência diretamente a partir da plataforma onde você já colabora com código. --- ## 🖼️ Renderização de imagens no GitHub ### 📁 Como imagens são tratadas em repositórios comuns Ao armazenar imagens diretamente em um repositório (por exemplo, dentro da pasta `/images`), o GitHub exibe os arquivos de imagem com uma URL voltada para **visualização e controle de versão**, e não para **uso público direto**. Isso significa que: - As imagens são servidas com URLs longas, muitas vezes com tokens e hashes. - Elas podem ser instáveis e mudarem a cada push ou alteração de commit. - Não são otimizadas para uso em sites públicos (headers, cache, CDN). ### 🌐 Por que hospedar imagens no GitHub Pages? Quando você usa o GitHub Pages para hospedar imagens: - As imagens são servidas como **conteúdo estático puro**, ideal para sites. - Elas têm **URLs limpas e permanentes**, como: `https://<usuário>.github.io/<repositório>/images/foto.png` - São automaticamente servidas via **CDN do GitHub**, (Content Delivery Network - ou Rede de Distribuição de Conteúdo) com melhor desempenho. - Isso evita problemas de links quebrados ou bloqueios por CORS. 📌 **Dica**: Crie uma pasta chamada `assets` ou `images` e coloque suas imagens lá. No HTML/Markdown, use: ```markdown  ``` ## 📦 O que é uma CDN? CDN (**Content Delivery Network**) é uma rede de servidores distribuídos globalmente que entrega conteúdos da web de forma rápida e eficiente. Quando você acessa um site ou arquivo hospedado em uma CDN, a resposta vem do servidor mais próximo da sua localização, garantindo menor latência, maior velocidade de carregamento e mais confiabilidade. ### ✅ Vantagens: - 🚀 Carregamento mais rápido de arquivos estáticos (imagens, CSS, JS etc.) - 🌍 Melhor desempenho global - 📉 Redução de carga no servidor principal - 🔐 Mais segurança contra ataques como DDoS - 📦 Otimização de cache e entrega de conteúdo O GitHub Pages usa uma CDN para distribuir os arquivos dos seus sites, o que melhora a performance significativamente — especialmente para imagens e recursos estáticos. --- ## 📚 Documentação e links úteis ### 🧾 Documentação oficial - [GitHub Pages - Documentação](https://docs.github.com/pt/pages) - [Configurar um site com Jekyll](https://docs.github.com/pt/pages/setting-up-a-github-pages-site-with-jekyll) - [GitHub Pages + Domínio personalizado](https://docs.github.com/pt/pages/configuring-a-custom-domain-for-your-github-pages-site) ### 🛠️ Tutoriais e recursos extras - [Guia Completo do GitHub Pages (em inglês)](https://pages.github.com/) - [Jekyll - Gerador de sites estáticos](https://jekyllrb.com/) - [Markdown Cheatsheet](https://www.markdownguide.org/cheat-sheet/) - [Exemplo de repositório com GitHub Pages](https://github.com/daattali/beautiful-jekyll) ### 🌟 Exemplos de uso do GitHub Pages: - [Comunidade Python-MG](https://pythonmg.github.io/) - [Repositório com o conteúdo das disciplinas GPP e MDS do curso Engenharia de Software da Universidade de Brasília](https://fga-eps-mds.github.io/A-Disciplina-MDS-EPS/) --- ## 🗂️ Exemplo de estrutura de diretório ``` meu-site/ ├── index.html ├── about.html ├── images/ │ └── foto-perfil.png ├── css/ │ └── estilo.css └── CNAME (opcional, para domínio próprio) ``` --- ## 🌐 Usando um domínio personalizado com GitHub Pages Este repositório está configurado para ser publicado via **GitHub Pages** com um **domínio personalizado** usando um arquivo `CNAME`. --- ### 📄 O que é o arquivo `CNAME` O arquivo `CNAME` é um arquivo de texto simples que contém apenas o nome de domínio personalizado que você deseja usar com seu site do GitHub Pages. #### 📌 Exemplo de conteúdo do arquivo `CNAME`: ``` www.exemplo.com ``` --- ### 📁 Onde colocar o arquivo `CNAME` O arquivo deve estar na **raiz do repositório** que está configurado para ser servido pelo GitHub Pages. ### 🛠️ Como configurar seu domínio personalizado 1. Crie um arquivo chamado `CNAME` (sem extensão) na raiz do seu repositório. 2. Insira seu domínio personalizado no arquivo (por exemplo, `www.exemplo.com`). 3. Salve e envie o arquivo para o GitHub. 4. No painel do seu provedor de domínio (como Registro.br, GoDaddy, Cloudflare etc.), adicione um registro **CNAME** apontando `www` para `seunome.github.io`. ### 🔒 HTTPS gratuito O GitHub Pages oferece **HTTPS gratuito** com Let's Encrypt. Certifique-se de marcar a opção **"Enforce HTTPS"** nas configurações do GitHub Pages após o domínio ser configurado corretamente. ### 🧪 Verificando Após a propagação do DNS (pode levar algumas horas), acesse seu domínio personalizado para verificar se ele redireciona corretamente para seu site hospedado no GitHub Pages. ### ✅ Exemplo - Repositório: `https://github.com/usuario/portfolio` - Site no GitHub Pages: `https://usuario.github.io/portfolio` - Domínio personalizado: `www.seusite.com` - Arquivo `CNAME`: ``` www.seusite.com ``` - Registro DNS: | Tipo | Nome | Valor | |-------|------|------------------------| | CNAME | www | usuario.github.io | --- ## 🧪 Faça o teste O GitHub Pages é uma solução prática, gratuita e poderosa para quem deseja criar um site estático com facilidade. E quando usado corretamente, pode inclusive funcionar como um **CDN gratuito para imagens e outros recursos estáticos**. -----
