Skip to main content

Sobre o GitHub Pages

Você pode usar GitHub Pages para hospedar um site sobre você, sua organização, ou seu projeto diretamente a partir de um repositório em GitHub.com.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para obter mais informações, consulte os "produtos do GitHub".

Sobre o GitHub Pages

O GitHub Pages é um serviço de hospedagem de site estático que usa arquivos HTML, CSS e JavaScript diretamente de um repositório no GitHub e, como opção, executa os arquivos por meio de um processo e publica um site. Você pode ver exemplos de sites do GitHub Pages na coleção de exemplos do GitHub Pages.

É possível hospedar seu site no domínio github.io do GitHub ou no seu próprio domínio personalizado. Para obter mais informações, consulte "Usar um domínio personalizado com o GitHub Pages".

You can create GitHub Pages sites that are publicly available on the internet. Organizations that use GitHub Enterprise Cloud can also publish sites privately by managing access control for the site. Para obter mais informações, consulte "Alterando a visibilidade do seu site de GitHub Pages" na documentação de GitHub Enterprise Cloud.

Para começar, consulte "Criar um site do GitHub Pages".

Os proprietários da organização podem desabilitar a publicação de sites do GitHub Pages nos repositórios da organização. Para obter mais informações, consulte "Gerenciar a publicação de sites de GitHub Pages para a sua organização".

Tipos de site do GitHub Pages

Há três tipos de site do GitHub Pages: projeto, usuário e organização. Os sites de projeto são conectados a um projeto específico hospedado no GitHub, como uma biblioteca do JavaScript ou um conjunto de receitas. Os sites de usuário e organização estão conectados a uma conta específica em GitHub.com.

Para publicar um site de usuário, você deve criar um repositório pertencente à sua conta pessoal denominada <username>. ithub.io. Para publicar um site de organização, você deve criar um repositório pertencente a uma organização que se chama <organization>.github.io. A menos que você esteja usando um domínio personalizado, os sites de usuário e organização estarão disponíveis em http(s)://<username>.github.io ou http(s)://<organization>.github.io.

Os arquivos de origem de um site de projeto são armazenados no mesmo repositório que o respectivo projeto. A menos que você esteja usando um domínio personalizado, os sites de projeto estão disponíveis em http(s)://<username>.github.io/<repository> ou http(s)://<organization>.github.io/<repository>.

Para obter mais informações sobre como os domínios personalizados afetam o URL do seu site, consulte "Sobre domínios personalizados e GitHub Pages".

Você só pode criar um site de usuário ou organização para cada conta em GitHub. Os sites de projeto, sejam eles de uma conta de organização ou pessoal , são ilimitados.

Publicar fontes para sites do GitHub Pages

Aviso: GitHub Pages sites are publicly available on the internet, even if the repository for the site is private. If you have sensitive data in your site's repository, you may want to remove the data before publishing. Para obter mais informações, consulte "Sobre repositórios".

You can publish your site when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.

If you do not need any control over the build process for your site, we recommend that you publish your site when changes are pushed to a specific branch. You can specify which branch and folder to use as your publishing source. The source branch can be any branch in your repository, and the source folder can either be the root of the repository (/) on the source branch or a /docs folder on the source branch. Whenever changes are pushed to the source branch, the changes in the source folder will be published to your GitHub Pages site.

If you want to use a build process other than Jekyll or you do not want a dedicated branch to hold your compiled static files, we recommend that you write a GitHub Actions workflow to publish your site. GitHub provides starter workflows for common publishing scenarios to help you write your workflow.

For more information, see "Configuring a publishing source for your GitHub Pages site."

Geradores de site estáticos

O GitHub Pages publica qualquer arquivo estático do qual você faz push no repositório. É possível criar seus próprios arquivos estáticos ou usar um gerador de site estático para que ele crie o site para você. Também pode personalizar seu próprio processo de criação localmente ou em outro servidor.

If you use a custom build process or a static site generator other than Jekyll, you can write a GitHub Actions to build and publish your site. GitHub provides starter workflows for several static site generators. For more information, see "Configuring a publishing source for your GitHub Pages site."

If you publish your site from a source branch, GitHub Pages will use Jekyll to build your site by default. If you want to use a static site generator other than Jekyll, we recommend that you write a GitHub Actions to build and publish your site instead. Otherwise, disable the Jekyll build process by creating an empty file called .nojekyll in the root of your publishing source, then follow your static site generator's instructions to build your site locally.

O GitHub Pages não aceita linguagens de servidor como PHP, Ruby ou Python.

Limites para o uso de GitHub Pages

Os sites do GitHub Pages criados após 15 de junho e que usam domínios do github.io são disponibilizados por HTTPS. Se você criou seu site ante de 15 de junho de 2016, é possível habilitar o suporte ao HTTPS para tráfego no seu site. Para obter mais informações, consulte "Proteger seu GitHub Pages com HTTPS".

Usos proibidos

O GitHub Pages não foi projetado e nem tem permissão para ser usado como um serviço de hospedagem gratuita na web, capaz de administrar sua empresa online, seu site de comércio eletrônico ou qualquer outro site desenvolvido principalmente para facilitar transações comerciais ou fornecer software comercial como um serviço (SaaS). Os sites do GitHub Pages não devem ser usados para transações confidenciais, como envio de senhas ou números de cartão de crédito.

Além disso, seu uso de GitHub Pages está sujeito aos Termos de Serviço do GitHub, incluindo as restrições relativas a ricos esquemas rápidos, conteúdo sexualmente obsceno e conteúdo ou atividade violento ou ameaçador.

Limites de uso

Os sites do GitHub Pages estão sujeitos ao seguintes limites de uso:

  • Os repositórios de origem do GitHub Pages têm um limite recomendado de 1 GB. Para obter mais informações, consulte "Qual é a minha cota de disco?"

  • Os sites do GitHub Pages publicados não podem ter mais de 1 GB.

  • Sites de GitHub Pages têm um limite de banda larga flexível de 100 GB por mês.

  • GitHub Pages sites have a soft limit of 10 builds per hour. This limit does not apply if you build and publish your site with a custom GitHub Actions workflow

  • In order to provide consistent quality of service for all GitHub Pages sites, rate limits may apply. These rate limits are not intended to interfere with legitimate uses of GitHub Pages. If your request triggers rate limiting, you will receive an appropriate response with an HTTP status code of 429, along with an informative HTML body.

Se o seu site exceder essas cotas de uso, talvez não possamos atender a ele ou você receba um e-mail formal do GitHub Support sugerindo estratégias para reduzir o impacto do site em nossos servidores, como colocar uma rede de distribuição de conteúdo (CDN, Content Distribution Network) de terceiros na frente do site, usar outros recursos do GitHub, como versões, ou migrar para outro serviço de hospedagem que possa atender melhor às suas necessidades.

Tipos de MIME no GitHub Pages

Um tipo de MIME é um header que um servidor envia a um navegador, fornecendo informações sobre a natureza e o formato dos arquivos que o navegador solicitou. O GitHub Pages aceita mais de 750 tipos de MIME entre milhares de extensões de arquivo. A lista de tipos de MIME compatíveis é gerada do projeto mime-db.

Embora não seja possível especificar tipos de MIME personalizados por arquivo ou repositório, você pode adicionar ou modificar tipos de MIME para uso no GitHub Pages. Para obter mais informações, consulte as diretrizes de contribuição do mime-db.

Coleta de dados

Quando um site de GitHub Pages é acessado, o endereço IP do visitante é registrado e armazenado para fins de segurança, independentemente se o visitante efetuou o login em GitHub ou não. Para obter mais informações sobre as práticas de segurança de GitHub, consulte a declaração de privacidade de GitHub.

Leia mais