Minilição · Português

Como criar seu primeiro site pessoal

Transforme o conteúdo de exemplo fornecido num pequeno site pessoal com um assistente de programação e depois teste-o como visitante.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem vai criar o primeiro site. Você escolhe o conteúdo e verifica o resultado; um assistente de programação pode editar os arquivos fornecidos. Não é preciso ter experiência com HTML, frameworks ou linha de comando.

Antes de começar

Você precisa de um navegador, de uma pasta que possa abrir em um assistente de programação e do material fornecido. Pode manter a identidade fictícia enquanto aprende; deixe isso claro. Antes de compartilhar sua própria página, use apenas informações que deseja tornar públicas. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.

Tempo estimado: 27–45 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. Estimativas para edição local. Publicar, comprar um domínio e escrever um estudo de caso completo de um projeto são tarefas separadas.

O que você vai aprender

  • Crie uma apresentação, uma seção de projetos e uma forma de contato a partir do modelo fornecido.
  • Verifique a página num celular e usando o teclado.
  • Faça uma melhoria pontual a partir de um problema observado.

Arquivos da oficina

Etapa 1

Escolha o que o visitante deve descobrir

Comece com uma pessoa e três coisas de que ela precisa na sua página.

Baixe o projeto inicial fornecido e abra starter/index.html. Alex Morgan e o projeto do clube de leitura são conteúdos fictícios de prática. Escolha um visitante, como alguém interessado em colaborar, e peça ao assistente que mantenha esse caráter de exercício claro enquanto você aprende.

O visitante deve conseguir entender a apresentação, encontrar um projeto e chegar à seção de contato. Não coloque dados privados na página.

Um exemplo concreto

Uma pessoa interessada em colaborar abre a página fornecida de Alex Morgan. A apresentação diz designer e desenvolvedor; o cartão do clube de leitura explica um projeto útil; Contact leva a Get in touch. São três elementos específicos que você pode pedir ao visitante para encontrar.

Abra a pasta do modelo fornecido. Ajude-me a criar uma apresentação simples, dois cartões de projetos e uma seção Contact usando os dados fictícios de prática fornecidos. Mantenha claros o aviso de conteúdo fictício e o contato ainda não configurado. Use o HTML/CSS existente em vez de adicionar um framework. Diga qual arquivo devo abrir e ajude-me a testar Projects, Contact e uma tela do tamanho de um celular.

MDN: seu primeiro site

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Crie seu primeiro site pessoal

Sua primeira página deve explicar quem você é, mostrar algo que você fez e oferecer uma forma de entrar em contato.

Um site pessoal é um documento que um navegador consegue exibir. O HTML dá estrutura, o CSS controla a aparência e o navegador transforma esses arquivos na página que o visitante vê.

Nossa primeira versão tem três seções: apresentação, projetos e contato. É um ponto de partida administrável porque você consegue testar se cada seção ajuda alguém a realizar uma tarefa real. Baixe os arquivos e leia project-brief.txt antes de editar.

Exemplo resolvido: um visitante com motivo para ficar

Uma pessoa interessada em colaborar quer saber se Alex já criou algo relevante. “Criativo. Apaixonado. Inovador.” oferece pouca evidência. “Criei uma página de clube de leitura que mostra o próximo encontro” apresenta algo que o visitante consegue entender.

MDN: seu primeiro site

Extra implementation exercise

Seu visitante está pensando em uma pequena colaboração. O que ele deve conseguir descobrir ou fazer na primeira versão da sua página?

Mostrar uma solução comentada

Ele deve entender o que você faz, encontrar um projeto relevante e acessar um link de contato que funcione. Repetiremos essas três verificações depois da edição.

  • Identifica a pessoa ou sua atuação e um projeto concreto.
  • Inclui uma forma de contato utilizável, em vez de um botão decorativo.

Etapa 2

Abra o site e siga seus links

Examine o modelo no navegador antes de pedir uma alteração.

Entregue a pasta do modelo ao seu assistente de programação. Pergunte qual arquivo abre o site, abra-o e siga Projects e Contact. O assistente pode corrigir um destino quebrado; você não precisa escrever a sintaxe dos links.

Um link do menu deve levar à seção indicada. Se falhar, diga ao assistente o que você clicou e onde esperava chegar, depois repita o mesmo clique após a correção.

Um exemplo concreto

Projects deve levar ao cartão do clube de leitura; Contact deve levar a Get in touch. O e-mail fornecido é alex@example.com. Chegar à seção testa a navegação, mas não prova que uma pessoa real consegue receber sua mensagem.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Abra os arquivos e examine a estrutura

Comece pela página fornecida para relacionar um elemento visível ao HTML que o cria.

Descompacte a oficina. Abra starter/index.html no navegador e depois abra o mesmo arquivo no editor. Mantenha as duas janelas disponíveis. Altere a frase de apresentação, salve e atualize o navegador.

Um título identifica uma seção. Um parágrafo a explica. Um elemento de âncora cria um link. O id de uma seção dá um destino a um link interno; ele não é texto visível. A página fornecida funciona sem JavaScript.

Mantenha o caminho exato do arquivo visível no editor e no navegador. Altere uma palavra, salve e atualize esse mesmo arquivo. Se a palavra não mudar, compare os dois caminhos antes de alterar o HTML. Esse teste de uma palavra distingue um engano na edição de um problema no código da página.

Exemplo resolvido: conectar um link do menu a uma seção

O link abaixo leva ao elemento cujo id é projects. As duas grafias precisam coincidir. O navegador não consegue deduzir que work e projects significam a mesma coisa.

<a href="#projects">Projects</a>
<section id="projects">
  <h2>Selected projects</h2>
</section>

Extra implementation exercise

Você muda o id da seção para work, mas deixa o link do menu como #projects. Qual alteração exata restaura o link?

Mostrar uma solução comentada

Altere o link do menu para href="#work" ou restaure o id da seção para projects. Depois de salvar, clique no link para verificar se ele chega à seção desejada.

  • Faz o fragmento do link corresponder ao id da seção.
  • Mantém um texto de link visível que faça sentido.

Etapa 3

Forneça descrições verdadeiras dos projetos

Deixe o assistente organizar seus fatos sem inventar seu histórico.

Use os dados dos projetos fornecidos ou escreva duas frases curtas sobre seu próprio trabalho: o que criou e o que alguém pode fazer com isso. Peça ao assistente para substituir apenas os textos dos projetos.

Leia o resultado por conta própria. Mantenha protótipos identificados como protótipos, preserve o aviso de conteúdo fictício nos exemplos e não invente clientes ou conquistas.

Um exemplo concreto

“Uma página simples que ajuda os vizinhos a encontrar o próximo livro e encontro” explica o que faz o projeto fornecido do clube de leitura. “Uma experiência inovadora” deixaria o visitante sem uma ideia concreta.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Troque o texto de exemplo por evidências

Escreva informações que o visitante possa usar, em vez de manter uma página bem-acabada sobre uma pessoa fictícia.

Substitua o nome, a atuação, a apresentação e o projeto de Alex. Descreva o que o projeto faz e quem ele ajuda. Um projeto de estudante ou uma pequena ferramenta pessoal são exemplos válidos quando descritos com honestidade.

Inclua um link para um projeto real, se tiver um. Se ele não for público, explique brevemente sem inventar um destino. Substitua o e-mail de exemplo por um endereço que você aceite publicar. Um link mailto abre o aplicativo de e-mail do visitante; ele não é o formulário com entrega na caixa de entrada ensinado em outra lição.

Exemplo resolvido: uma descrição concreta de projeto

“Clube de Leitura: uma página que informa nosso próximo livro, a data do encontro e o local” é específico. Um link chamado “Ver o projeto do clube de leitura” informa seu destino. “Clique aqui” dá menos contexto.

Extra implementation exercise

Escreva uma descrição do projeto em duas frases: o que você criou e o que alguém consegue fazer com isso?

Mostrar uma solução comentada

Por exemplo: “Criei uma página de clube de leitura para meu bairro. Os membros podem encontrar o próximo livro, a data do encontro e o local”. Substitua esse exemplo pelo seu próprio trabalho, sem apresentar o projeto de Alex como seu.

  • Identifica uma realização concreta e seu usuário pretendido.
  • Descreve uma funcionalidade sem inventar conquistas ou resultados.

Etapa 4

Verifique a página num celular

Peça a correção com base no que vê, sem precisar de vocabulário de CSS.

Abra a página em uma janela estreita, com cerca de 390 pixels, ou em um celular. Leia o título inteiro do projeto e acione Contact. Se o texto ultrapassar a borda, envie uma captura dessa tela ao assistente e peça uma correção pontual que mantenha todas as palavras.

Depois da alteração, repita na mesma largura e abra uma visualização ampla. Para um teste simples de teclado, pressione Tab até um link ganhar contorno visível e Enter para segui-lo. Mantenha os dois projetos e o contato disponíveis.

Um exemplo concreto

Em uma visualização estreita, leia o título completo e acione Contact. Se uma palavra sumir além da borda, mostre exatamente essa tela ao assistente; “deixe responsivo” informa muito menos.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Torne a página legível e utilizável

Use CSS para apoiar o conteúdo e depois verifique a página com um teclado e uma área de visualização estreita.

O CSS está em starter/style.css. A largura máxima evita linhas muito longas; o espaçamento interno afasta o texto das bordas; o tamanho do título se adapta à tela. Altere uma propriedade por vez e compare o resultado.

Use Tab para visitar cada link e Enter para ativá-lo. O contorno de foco visível mostra a quem usa o teclado onde está. Nas ferramentas de desenvolvimento do navegador, experimente uma largura próxima de 390 pixels. O texto deve continuar legível e a página não deve exigir rolagem horizontal.

Exemplo resolvido: texto flexível em vez de um título enorme e fixo

Um tamanho responsivo permite que o título cresça no computador sem deixar de ser utilizável no celular. Isso não resolve todos os problemas de layout, então teste também seu texto real.

h1 {
  font-size: clamp(36px, 7vw, 68px);
  line-height: 1.1;
}
a:focus-visible { outline: 3px solid #ba5d3e; }

Extra implementation exercise

Com 390 pixels de largura, o título longo do seu projeto exige rolagem horizontal. O que você vai examinar antes de reduzir todos os tamanhos de fonte?

Mostrar uma solução comentada

Examine o elemento que ultrapassa a tela. Remova uma largura fixa desnecessária ou permita que aquele texto longo quebre em linhas. Depois verifique novamente o título, os links e o corpo do texto, em vez de diminuir a página inteira.

  • Verifica larguras fixas, textos que não podem ser quebrados e elementos grandes demais.
  • Mantém o texto legível e testa novamente o layout estreito real.

Etapa 5

Mantenha a primeira versão pequena

Uma primeira página utilizável vale mais do que uma reconstrução desnecessária.

Revise as três tarefas do visitante. Peça ao assistente a menor alteração restante, em vez de um novo framework, sistema de contas ou animação. Salve uma cópia antes de uma mudança maior.

Abra novamente o resultado salvo e repita a tarefa afetada pela alteração. Guarde uma versão funcional à qual possa voltar.

Um exemplo concreto

Um pedido específico seria: “Adicione um rótulo claro de projeto de prática ao lado do cartão do clube de leitura, preservando o texto e o link.” A verificação é se o visitante encontra o projeto e reconhece sua condição de exemplo.

Astro: sites de conteúdo · Next.js: primeiros passos

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Escolha apenas as ferramentas de que esta página precisa

Uma página HTML funcional é um primeiro site perfeitamente válido. Acrescente um framework quando seus recursos resolverem um problema que você realmente tenha.

Este projeto inicial não exige instalação de pacotes nem comando de compilação. Você pode continuar editando o HTML e o CSS diretamente. Assim, fica fácil acompanhar a relação entre um arquivo e a página exibida.

Para um site de conteúdo em crescimento, o Astro pode oferecer layouts reutilizáveis. O Next.js é outra opção para uma aplicação React com recursos de servidor. São alternativas com sua própria configuração, não exigências para concluir este exercício. Guarde a pasta atual como uma versão que você sabe que funciona antes de experimentar.

Exemplo resolvido: escolher de acordo com a próxima tarefa

Um portfólio de uma página com três seções pode continuar em HTML e CSS. Um site com dezenas de artigos pode se beneficiar de modelos reutilizáveis. Escolha com base no trabalho que precisa manter, não na popularidade da ferramenta.

Astro: sites de conteúdo · Next.js: primeiros passos

Extra implementation exercise

Você tem uma página e nenhum recurso de aplicação. Precisa migrá-la para um framework antes de mostrá-la a alguém? Explique sua escolha.

Mostrar uma solução comentada

Esta tarefa não exige migração para um framework. Termine e teste a página atual. Considere um framework depois, se layouts repetidos, volume de conteúdo ou comportamento de aplicação o tornarem útil.

  • Reconhece que a página existente pode atender à tarefa.
  • Apresenta um motivo concreto antes de acrescentar configuração ou dependências.

Etapa 6

Conclua uma página com dois projetos

Entregue algo que outra pessoa possa abrir e usar.

Peça ao assistente para adicionar o segundo projeto fornecido ou verdadeiro, preservando navegação e contato. Abra o resultado e peça a alguém para encontrar um projeto e o contato, ou faça a mesma tarefa numa nova janela do navegador.

Verifique visualizações estreitas e largas e a navegação pelo teclado. Registre o que realmente tentou e uma melhoria; a publicação será uma próxima lição separada.

Um exemplo concreto

A versão de comparação fornecida acrescenta A community garden diary: os voluntários encontram notas de plantio e a próxima tarefa coletiva. Uma entrega completa identifica os dois cartões e o contato ainda não configurado, em vez de dizer apenas “a página ficou bonita”.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: deixe a página com a sua identidade

Produza uma página pequena que o visitante consiga entender e percorrer sem suas explicações.

Substitua todos os textos fictícios de identidade e projetos. Acrescente um segundo projeto com uma descrição distinta. Mantenha funcionando os destinos de apresentação, projetos e contato.

Peça a alguém que encontre um projeto e sua forma de contato, ou faça a tarefa em uma nova janela do navegador. Registre um detalhe confuso, melhore-o e repita a mesma verificação. A publicação é o assunto da próxima lição; esta tarefa pode ser concluída localmente. Depois de tentar, compare com a referência de dois projetos em worked-solution/index.html. A identidade e os projetos dela são fictícios; sua entrega deve conter o seu trabalho.

Exemplo resolvido: registrar resultados observáveis

Uma anotação útil é: “O link Projects chegou à seção correta; o link do segundo projeto ainda usava um endereço de exemplo”. Ela identifica um resultado real que você pode corrigir, em vez de dizer que a página parece pronta.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Crie sua página com dois projetos e verifique as três tarefas do visitante. Que evidências você vai entregar?

  1. Substitua a identidade, os textos de projeto e o endereço de contato de exemplo.
  2. Acrescente um segundo projeto sem quebrar a navegação interna.
  3. Verifique o acesso pelo teclado e em uma tela estreita; registre uma melhoria.
Mostrar uma solução comentada

Uma referência de estrutura usa uma página de horários de biblioteca e uma galeria de fotos; esses temas são opcionais e não devem ser apresentados como seu histórico. Para o exemplo da biblioteca: “Os vizinhos não encontravam o horário de hoje. Criei uma página que coloca o horário de hoje e o endereço antes da galeria”. Na sua página, use duas descrições verdadeiras de projetos. Um item de prática ou planejado é bem-vindo se estiver claramente identificado.

Substitua o nome e o e-mail de exemplo apenas por informações que você escolher publicar; um alias exclusivo para contato pode ser preferível a expor uma caixa de entrada pessoal. Abra o arquivo final diretamente, siga Projects e Contact e depois teste em 390px com um título de projeto longo. Os arquivos de solução fornecidos mostram a estrutura completa com dois projetos.

  • Não restam dados fictícios provisórios; os dois projetos estão claramente descritos.
  • Os links de navegação e contato funcionam, com texto legível e foco do teclado visível.
  • Usa descrições próprias e verdadeiras; identifica trabalhos de prática ou planejados e não copia realizações dos exemplos como histórico pessoal.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições