Como Comentar Códigos e Estruturar o Layout do Seu Site
Fala, futuro mestre do Front-End! Tudo tranquilo por aí? Se você está acompanhando o nosso curso de HTML online, já deve ter percebido que nosso lema é sempre colocar a mão na massa. Teoria sem prática é igual a um site sem CSS: sem graça e difícil de engolir.
Hoje, vamos dar um salto gigante na sua carreira. Vamos começar aprendendo uma técnica simples (mas que salva vidas) para organizar o seu código: os comentários. Logo em seguida, faremos uma viagem no tempo! Vamos ver como os layouts de sites eram construídos antigamente (usando as temidas tabelas do HTML 4) e como nós fazemos isso hoje, do jeito certo, utilizando HTML5 Semântico e CSS moderno. Pegue seu café e vamos codar!
Como Comentar Códigos em HTML (E por que isso é vital)
Como fazer comentários no HTML? Para inserir um comentário em um código HTML, utilize a sintaxe de abertura e fechamento: <!-- seu texto aqui -->. Os comentários são completamente ignorados pelo navegador e não aparecem na tela do usuário, servindo exclusivamente para organizar o código-fonte e ajudar outros desenvolvedores a entenderem a estrutura.
Se você acompanhou as nossas últimas aulas, deve ter notado que nosso código HTML está ficando cada vez maior e mais complexo. E pode acreditar, as coisas só tendem a ficar mais densas à medida que você for injetando CSS e JavaScript na mistura.
Já ensinamos que a indentação (dar aquele espaço estratégico com a tecla Tab) torna seu código muito mais legível. A segunda regra de ouro de um bom webmaster é: comente o seu código! Às vezes, você escreve uma lógica complexa hoje e, daqui a três meses, não faz ideia do porquê fez aquilo. O comentário serve como um "bilhete" para o seu "eu do futuro".
<!-- CABEÇALHO DO SITE -->
<header>
<h1>Meu Blog de Tecnologia</h1>
<!-- <img src="logo-em-manutencao.png" alt="Logo"> A imagem está oculta por enquanto! -->
</header>Cansado de se perder nos códigos e quer dominar o Front-End de verdade? 🚀
A internet está cheia de tutoriais rasos e pedaços de código soltos. Se você quer aprender a criar layouts modernos sem depender de internet, fugir de anúncios e ter o mapa completo do zero ao profissional, você precisa do material certo.
"Eu sempre me enrolava na hora de dividir o site entre cabeçalho, conteúdo e rodapé. Essa apostila mastigou tudo e salvou meus projetos!" - Carlos, Desenvolvedor.
Antes vs. Depois: A Evolução do Layout na Web
No início da internet, antes de existirem recursos avançados de CSS, nós tínhamos um grande problema: como colocar o logotipo no topo, o menu na esquerda e o texto na direita de forma alinhada?
O Jeito Antigo: O Pesadelo das Tabelas (HTML 4.01)
A solução provisória (que durou anos) foi usar a tag <table> para englobar o site inteiro. O webmaster criava uma tabela invisível (sem bordas), onde a primeira linha <tr> guardava o cabeçalho, a segunda linha era dividida em colunas (<td>) para o menu e o conteúdo, e a última linha guardava o rodapé.
Criar layouts estruturais com tabelas é um crime grave no mercado atual. Isso destrói o seu SEO (o Google não entende a hierarquia do site), prejudica leitores de tela para deficientes visuais e impossibilita a criação de layouts responsivos para celulares. Tabelas servem estritamente para exibir dados estatísticos!
O Jeito Moderno: HTML5 Semântico e CSS
Com a chegada do HTML5, a internet amadureceu. Ganhamos tags semânticas (tags que explicam ao navegador exatamente o que elas contêm) e passamos a usar o CSS (Flexbox ou Grid) para colocar cada bloco em seu devido lugar.
O esboço moderno do site possui a seguinte anatomia estrutural:
<header>: Define o cabeçalho do site (logo e título).<nav>: O bloco de navegação, onde ficam os links do menu principal.<main>: O núcleo do site. Tudo que é conteúdo principal entra aqui.<aside>: A barra lateral (sidebar), ideal para menus secundários ou banners.<footer>: O rodapé, onde ficam os direitos autorais e links de contato.
Criando o Layout de um Site (Na Prática)
Vamos criar o esqueleto de um site moderno que simula a divisão clássica (Cabeçalho, Menu Esquerdo, Conteúdo Direto e Rodapé). Veja como o código fica limpo e maravilhoso quando usamos as tags corretas combinadas com um pouco de CSS Flexbox:
<!DOCTYPE html>
<html lang="pt-br">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Layout Moderno HTML5</title>
<style>
/* Estilização básica para visualizar as áreas da página */
body { font-family: Arial, sans-serif; margin: 0; background: #f4f4f9; }
header { background: #0f172a; color: white; padding: 20px; text-align: center; }
nav { background: #3b82f6; padding: 10px; text-align: center; }
nav a { color: white; text-decoration: none; padding: 0 15px; font-weight: bold; }
/* Aqui a mágica acontece: Flexbox divide a tela lado a lado */
.container-principal { display: flex; max-width: 1000px; margin: 20px auto; gap: 20px; }
aside { background: #e2e8f0; width: 250px; padding: 20px; border-radius: 8px; }
main { background: white; flex: 1; padding: 20px; border-radius: 8px; box-shadow: 0 2px 5px rgba(0,0,0,0.1); }
footer { background: #0f172a; color: white; text-align: center; padding: 15px; margin-top: 20px; }
</style>
</head>
<body>
<!-- CABEÇALHO DO SITE -->
<header>
<h1>HTML Progressivo</h1>
<p>Dominando a web moderna!</p>
</header>
<!-- NAVEGAÇÃO PRINCIPAL -->
<nav>
<a href="#">Home</a>
<a href="#">Artigos</a>
<a href="#">Contato</a>
</nav>
<!-- ÁREA CENTRAL (CORPO DO SITE) -->
<div class="container-principal">
<!-- MENU LATERAL -->
<aside>
<h3>Menu Lateral</h3>
<ul>
<li><a href="#">Apostila HTML</a></li>
<li><a href="#">Apostila CSS</a></li>
</ul>
</aside>
<!-- CONTEÚDO -->
<main>
<h2>Bem-vindo ao Novo Padrão da Web!</h2>
<p>Diga adeus às tabelas antigas. Agora usamos tags semânticas que o Google ama. Se o usuário estiver acessando pelo celular, o Flexbox cuidará de jogar a barra lateral para debaixo do conteúdo de forma automática!</p>
</main>
</div>
<!-- RODAPÉ DO SITE -->
<footer>
<p>Todos os direitos reservados - HTML Progressivo 2026 ©</p>
</footer>
</body>
</html>Resultado Visual (Simulação):
display: flex; no código acima? Isso é o Flexbox! Ele substituiu a antiga e problemática regra do float: left; que os desenvolvedores usavam logo após abandonarem as tabelas. É o estado da arte do CSS.
Exercício Prático de HTML
Chegou a sua hora! Crie um site sobre as suas bandas ou jogos favoritos seguindo essa estrutura moderna.
- No menu superior (
<nav>), crie os links: "Home", "Contato" e "Sobre". - No menu lateral (
<aside>), exiba uma lista de links com os nomes das bandas (Ex: Iron Maiden, Deep Purple, Led Zeppelin). - Ao clicar, o usuário deve ir para uma nova página (ex:
maiden.html). Dentro dessas páginas, o layout (cabeçalho, rodapé e menu) deve ser exatamente o mesmo! Você só precisa alterar o texto e as imagens dentro da tag<main>.
Perguntas Frequentes (FAQ)
Por que não se usa mais tabelas para criar o layout de sites?
Usar a tag <table> para posicionar cabeçalhos e menus quebra a acessibilidade do site e afunda o SEO. O Googlebot espera dados reais dentro de tabelas. Além disso, as tabelas são rígidas, o que impossibilita a criação de um layout que se adapte graciosamente às telas de smartphones (responsividade).
Qual a diferença entre HTML e CSS na criação do layout?
O HTML é como o esqueleto e a fundação da casa: ele diz o que é o cabeçalho, onde fica o menu e qual o texto principal. O CSS é a pintura e a decoração: ele pega esse esqueleto e determina cores, fontes, larguras e coloca o menu "flutuando" do lado esquerdo usando propriedades como o Flexbox ou Grid.
Os comentários no HTML deixam meu site mais lento?
Na prática, não. Embora o texto do comentário ocupe alguns bytes extras no peso do arquivo final, os navegadores (Chrome, Edge, Safari) pulam essas linhas durante a renderização (a fase de desenhar o site na tela). Portanto, o impacto na velocidade é zero, mas o ganho na organização é imenso.
🎯 O que estudar a seguir:
Para continuar a sua jornada rumo à maestria web, confira nossas próximas aulas essenciais:
- Como inserir e formatar imagens no HTML (Regras de Ouro)
- O guia definitivo de Listas no HTML (ul, ol e li)
- Introdução ao CSS: Entendendo seletores, classes e IDs
