Criação de sites com IA e publicação do site
Publique HTML criado com IA no GitHub Pages: arquivos, caminhos e erros 404
Publique um site estático pessoal no GitHub Pages, organize HTML e recursos, selecione a branch e resolva imagens ausentes, erros 404 e atualizações que não aparecem.

Se uma ferramenta de IA já criou uma página HTML, o GitHub Pages pode transformá-la em um endereço que você compartilha com outras pessoas. Para um portfólio pessoal, anotações de estudo ou uma demonstração simples, comece reunindo a página inicial e os arquivos usados por ela, envie tudo para seu repositório e ative o Pages.
Este guia usa um repositório chamado ai-website e o envio pelo navegador. O endereço final normalmente segue https://你的用户名.github.io/ai-website/: substitua o marcador de usuário pelo nome da sua conta. A gratuidade se refere ao Pages publicado a partir de repositórios públicos no GitHub Free. Domínio próprio e serviços externos podem ter custos separados.
O GitHub Pages hospeda arquivos estáticos. Texto, imagens, links e interações executadas no navegador podem funcionar aqui. Desenhar uma tela de login em HTML não cria um banco de contas nem um serviço de autenticação.
| O que a IA entregou | Serve para este procedimento? | O que conferir primeiro |
|---|---|---|
index.html com estilos e scripts no próprio arquivo | Sim | Imagens externas e links |
| HTML, CSS, JavaScript e pastas de imagens | Sim | Relação entre os caminhos dos arquivos |
| Captura de tela ou layout | Ainda faltam arquivos web | Peça o HTML de verdade |
| Código React ou Next.js que exige instalar dependências | Precisa de compilação e implantação próprias | Confira se pode gerar uma exportação estática |
| Aplicação com banco de dados, pagamentos ou tarefas no servidor | Exige avaliar outra hospedagem | Identifique o backend e o tratamento dos dados |
O Pages não executa PHP, Python ou outras linguagens no servidor. O GitHub também proíbe usá-lo como hospedagem gratuita para operar negócios online, realizar transações de comércio eletrônico ou oferecer SaaS comercial. Avalie a finalidade e as funções do projeto nos limites do Pages. Para uma aplicação completa, consulte as opções de hospedagem de sites criados com IA antes de escolher o caminho.
Crie uma pasta exclusiva com os arquivos que pretende tornar públicos. Use index.html em minúsculas como página inicial e mantenha junto dela imagens, estilos e scripts. Exemplo:
ai-website/
├── index.html
├── style.css
└── images/
└── cover.png
Se os estilos já estão dentro do HTML, não é necessário criar style.css. Descompacte um ZIP antes de enviar seu conteúdo; publicar o ZIP não o transforma em um site. Confira também se o editor não salvou index.html.txt por engano.
Você pode pedir à ferramenta de IA:
Organize esta página como arquivos HTML estáticos prontos para publicar. Nomeie a página inicial index.html e liste os arquivos CSS, JavaScript e imagens que precisam acompanhá-la. O site ficará no subdiretório /ai-website/. Confira os caminhos relativos dos recursos e links e informe quais funções ainda dependem de serviços externos.
Abra a página inicial no computador e teste textos, imagens e botões. Referências a C:\Users\..., file://... ou localhost não darão aos visitantes acesso aos arquivos do seu computador. Só inclua material público. Senhas e chaves de API ficam fora do HTML e dos scripts enviados ao repositório.
Entre na conta que usará para administrar o site. Clique em New repository, informe ai-website, selecione Public, ative Add README e crie o repositório.
O repositório é o espaço do projeto onde os arquivos ficam guardados. Este exemplo cria um site de projeto; não exige o nome especial 用户名.github.io, com o marcador substituído pelo seu usuário. Esse outro formato corresponde a um site de usuário e usa uma estrutura de endereço diferente, conforme os tipos de sites do Pages.
No GitHub Free, a origem do Pages precisa ser pública. Prepare tanto o código quanto a página para acesso público. Se precisa limitar o acesso a convidados, avalie os controles da página publicada e do repositório separadamente: marcar um repositório como privado não basta para concluir quem pode abrir o site. Veja a documentação de criação.
Na aba Code, abra Add file → Upload files e envie index.html com seus recursos. Escreva uma mensagem como “Publicar página inicial do portfólio” e confirme o commit.
Selecione a branch main e confira se os arquivos aparecem nela. Se o envio criou outra branch ou um pull request, incorpore as alterações em main; do contrário, a origem escolhida para publicação pode não receber os arquivos. Consulte as instruções de envio.
Nesta configuração, index.html deve aparecer diretamente na raiz do repositório. Se você só vê uma pasta ai-website com a página dentro dela, enviou um nível extra: mova os arquivos para a raiz que será publicada.
Reduza imagens grandes para dimensões adequadas à web antes do envio. O limite citado na documentação é de 25 MiB por arquivo no navegador e até 100 arquivos por envio. Vídeos grandes e fotos originais pesadas não são uma boa escolha para a primeira publicação de um site pequeno.
Abra Settings → Pages, encontre Build and deployment e configure:
| Campo | Valor deste exemplo | O que seleciona |
|---|---|---|
| Source | Deploy from a branch | Publicação a partir de uma branch |
| Branch | main | Branch que recebeu os arquivos |
| Folder | /(root) | Raiz do repositório |
Clique em Save. A opção /(root) deve corresponder à localização da página inicial. Se escolher /docs, o arquivo precisa ficar no topo da pasta docs da branch main. São duas opções válidas de origem; neste primeiro exemplo, mantenha a raiz para facilitar a conferência.

A imagem vem da documentação oficial da origem de publicação. A interface atual pode ser diferente. Mesmo publicando por branch, o GitHub usa um workflow do Actions para compilar e implantar; este exemplo de HTML puro não exige escrever um workflow manualmente.
Se os arquivos estáticos incluem diretórios iniciados com sublinhado ou você precisa dispensar o processamento padrão do Jekyll, adicione um arquivo vazio .nojekyll na raiz publicada, conforme a documentação. Ele não compila um projeto React e não corrige caminhos errados de imagens.
Confira na aba Actions se a implantação do Pages terminou com sucesso. Volte a Settings → Pages e abra Visit site. Compartilhe esse endereço, não a página de código github.com/用户名/仓库名.
Sites de projeto normalmente mantêm o nome do repositório no endereço:
https://你的用户名.github.io/ai-website/
Substitua o marcador do usuário pelo nome real da conta. Segundo a documentação citada, as alterações podem levar até aproximadamente 10 minutos para aparecer. Enquanto o workflow executa, acompanhe seu estado. Se falhar, abra aquela execução e examine o erro; não recrie o repositório repetidamente. Veja como consultar a publicação.
Teste em um navegador sem login no GitHub e em um celular usando dados móveis. Confira página inicial, imagens, navegação e botões antes de colocar o endereço no currículo ou perfil social. Avalie também uma rede usada pelo público pretendido: hospedagem gratuita não garante a mesma qualidade de acesso em todas as regiões.
| Sintoma | Onde conferir | Como agir |
|---|---|---|
| Todo o site retorna 404 | Actions, Visit site e origem | Aguarde a implantação e confira branch e pasta |
| Só aparece o README | Arquivo de entrada da pasta publicada | Confira se a página foi enviada como index.html |
| Página inicial retorna 404, mas existe no repositório | Nível da pasta e letras maiúsculas | Coloque index.html em minúsculas na raiz publicada |
| Página abre, mas imagens ou estilos retornam 404 | Caminhos solicitados e arquivos enviados | Confira nomes e pastas e corrija caminhos relativos |
| Navegação abre uma página interna, mas atualizar retorna 404 | Existência de arquivo estático nessa rota | Use páginas HTML reais ou uma solução de rotas adequada ao projeto |
Index.html, index.HTML e index.html não são o mesmo nome de entrada. Comece conferindo nome e localização antes de investigar domínio e rede. Consulte o diagnóstico oficial de 404.
Em sites de projeto, uma / inicial pode retirar o nome do repositório do caminho. Para uma página em https://example-user.github.io/ai-website/, o navegador resolve:
| Caminho no HTML | Caminho solicitado |
|---|---|
./images/cover.png | /ai-website/images/cover.png |
/images/cover.png | /images/cover.png, sem o nome do repositório |
./about.html | /ai-website/about.html |
Para uma imagem dentro da pasta do projeto, a página inicial pode usar:
<img src="./images/cover.png" alt="作品展示图">
Esse exemplo demonstra a resolução de caminhos; não afirma que o domínio ilustrativo hospeda um site. Troque o texto alternativo da imagem por uma descrição útil em português. Ajuste os caminhos de páginas em subpastas e respeite os nomes reais: images/cover.png e images/Cover.png são diferentes. Não substitua todos os caminhos relativos por caminhos iniciados na raiz.
Peça à IA para alterar os arquivos locais e envie a versão atualizada ao mesmo repositório. Mantenha nomes e referências corretos e faça o commit na mesma branch de publicação. Depois da implantação, abra o endereço público original e confira um texto ou imagem que você alterou.
Se a página continua igual, confira se os arquivos chegaram a main e se a nova implantação terminou com sucesso. Só então investigue atualização da página e cache do navegador. Salvar um arquivo local ou enviar mudanças a outra branch não atualiza a origem publicada.
Para continuar, veja como conectar um domínio próprio, opções de formulários, login e backend e como verificar a indexação no Google. Escolha a próxima etapa conforme as funções de que seu site precisa.