Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
World desk5 min

Tirando o projeto do localhost: como publicar sua primeira página web grátis no GitHub Pages

Aprenda a publicar uma página estática no GitHub Pages sem contratar hospedagem, usando uma branch e a raiz do repositório ou /docs.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Sim: você pode publicar uma página estática no GitHub Pages sem contratar hospedagem. Coloque HTML, CSS e JavaScript em um repositório e, para o caminho mais simples, configure a publicação a partir de uma branch e da pasta raiz — ou de /docs. O endereço gratuito termina em github.io. Este guia cobre o fluxo por branch, quando escolher GitHub Actions e o que revisar antes de tornar o site público.

O que o GitHub Pages publica — e o que não publica

GitHub Pages é um serviço de hospedagem estática: ele publica arquivos HTML, CSS e JavaScript de um repositório e pode, opcionalmente, executar um processo de build. Essa é a descrição da documentação do GitHub.

As an Amazon Associate I earn from qualifying purchases.

Isso atende páginas que podem ser entregues como arquivos estáticos. Não é um servidor de aplicação persistente: se o seu projeto depende de um backend que execute código no servidor, banco de dados próprio ou processamento contínuo, publicar os arquivos no Pages não substitui esse componente. Um projeto com etapa de compilação pode funcionar, desde que o build gere os arquivos do site e o processo de publicação esteja configurado.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Escolha a origem de publicação

Opção Quando usar Build e controle
Branch e pasta raiz ou /docs Os arquivos finais do site já estão prontos e ficam na raiz do repositório ou em /docs. Configuração inicial mais simples; escolha uma branch existente e a pasta de publicação.
GitHub Actions O projeto precisa de um build personalizado ou de um fluxo de publicação próprio. Permite definir o workflow; o processo documentado inclui checkout, build quando necessário, upload do artefato e deploy.

Para a primeira página estática, prefira branch e pasta. A documentação de origem de publicação descreve essas opções e os casos de uso.

Prepare o repositório e os arquivos

Decida que tipo de site é

Para um site pessoal ou de organização, o repositório precisa seguir o formato <owner>.github.io, substituindo <owner> pelo nome da conta. Para um site de projeto, use o repositório desse projeto; o endereço incluirá o nome do repositório no caminho. Os requisitos e formatos de endereço constam em What is GitHub Pages?

Coloque os arquivos no local de publicação

Crie um repositório ou escolha um existente e adicione os arquivos estáticos. No fluxo por branch, eles devem estar na raiz da branch escolhida ou dentro de /docs. Se você usa uma ferramenta que gera o site a partir de arquivos-fonte, confirme que o resultado do build está sendo publicado; não basta enviar arquivos que só funcionam no ambiente local.

Rank #2
Sale
HTML and CSS: Design and Build Websites
  • HTML CSS Design and Build Web Sites
  • Comes with secure packaging
  • It can be a gift option

Publique pelo GitHub

  1. Abra o repositório no GitHub e entre em Settings → Pages. Os rótulos e a organização da interface podem mudar; confirme as opções exibidas na página Pages do repositório.
  2. Em Build and deployment, escolha publicação a partir de uma branch, se essa opção estiver disponível para o repositório.
  3. Selecione a branch que contém os arquivos e a pasta /(root) ou /docs, conforme onde colocou o site.
  4. Salve a configuração. Depois disso, alterações enviadas à branch e pasta selecionadas alimentam o site publicado.
  5. Abra o endereço indicado pelo GitHub Pages. O quickstart informa que uma alteração pode levar até 10 minutos para aparecer; trate esse prazo como referência, não como garantia. Se a página ainda não carregar, confirme a origem configurada e o local dos arquivos antes de tentar novamente.

Se o projeto exigir uma etapa de build que o modo simples não cobre, configure GitHub Actions na seção Pages. O workflow precisa obter o código, produzir o site quando necessário, enviar o artefato e executar o deploy; consulte as instruções de configuração de origem e workflow.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use o endereço gratuito ou configure um domínio próprio

Endereço Custo e configuração Formato
Domínio github.io É suficiente para publicar sem comprar domínio. Não requer configuração DNS de domínio próprio. Site pessoal/organização usa o domínio do proprietário; site de projeto inclui o nome do repositório no caminho.
Domínio personalizado Opcional; exige configurar o domínio nas definições Pages e registros DNS no provedor. Alterações DNS podem levar até 24 horas para se propagar, segundo a documentação de domínio personalizado. Para domínio apex, a documentação descreve registros ALIAS, ANAME ou A; www normalmente usa CNAME apontando para o domínio padrão do site.

Se optar por domínio próprio, verifique sua propriedade antes de adicioná-lo ao repositório. O GitHub recomenda essa etapa para reduzir o risco de takeover; as regras de quais repositórios podem publicar no domínio ou em subdomínios imediatos dependem de a conta ser pessoal ou de organização. Veja Verifying your custom domain for GitHub Pages.

Confira o plano, a privacidade e a segurança

Repositório privado não significa site privado

Segundo a página de início do GitHub Pages, GitHub Free e Free para organizações permitem Pages em repositórios públicos. Pro, Team, Enterprise Cloud e Enterprise Server também permitem Pages em repositórios privados, conforme as condições do plano e da conta. Confira a página de início do GitHub Pages e as políticas atuais da sua conta antes de escolher a visibilidade.

Mesmo quando o plano permite publicar a partir de um repositório privado, o site publicado é público na internet. Revise os arquivos destinados à publicação e retire senhas, tokens, credenciais e dados pessoais que não devam ser expostos. A documentação de origem de publicação esclarece que o conteúdo publicado pode ser acessado publicamente.

Rank #4
Sale
Web Design with HTML, CSS, JavaScript and jQuery Set
  • Brand: Wiley
  • Set of 2 Volumes
  • A handy two-book set that uniquely combines related technologies Highly visual format and accessible language makes these books highly effective learning tools Perfect for beginning web designers and front-end developers

HTTPS protege a conexão, não torna o site adequado a transações sensíveis

GitHub Pages suporta HTTPS. A documentação informa que sites github.io criados depois de 15 de junho de 2016 são servidos automaticamente por HTTPS. Isso protege o transporte da conexão, mas o GitHub desaconselha usar Pages para enviar senhas ou dados de cartão. Consulte Securing your GitHub Pages site with HTTPS.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Considere a privacidade dos visitantes

O GitHub informa que registra e armazena endereços IP de visitantes para fins de segurança, inclusive de pessoas sem sessão iniciada no GitHub. Se o seu próprio site também coleta ou trata dados, avalie as obrigações de privacidade aplicáveis ao seu caso e descreva práticas reais do site, não as presuma a partir do uso de Pages. Essa informação consta em What is GitHub Pages?

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Limites e disponibilidade

Os limites de tamanho, tráfego e builds não estão especificados aqui; não assuma que o serviço é ilimitado. Consulte a documentação vigente do GitHub Pages antes de planejar um site cuja operação dependa desses limites. A disponibilidade de configurações também pode variar com o plano e mudar com o tempo, então confira a página Pages e a documentação atual da sua conta.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.