Programación

Tu primera página HTML: un cuaderno de lecturas

Construye una página completa con títulos, listas, enlaces e imágenes; entiende su estructura y comprueba la navegación con el teclado.

Referencias visuales: W3C · Composición editorial.

Un archivo HTML basta para empezar un cuaderno de lecturas. Vas a construir una página que puedas abrir en el navegador, recorrer con el teclado y ampliar con títulos, enlaces y secciones que tengan sentido.

Crea un archivo que el navegador entienda

Abre una carpeta de práctica y guarda el siguiente contenido como index.html, con codificación UTF-8. Comprueba que el editor no haya añadido .txt al nombre. Abre el archivo con tu navegador.

html · index.html: una página completa

<!doctype html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="description" content="Lecturas y notas para practicar HTML.">
  <title>Mi cuaderno de lecturas</title>
</head>
<body>
  <header>
    <h1>Mi cuaderno de lecturas</h1>
    <p>Libros, artículos y lo que quiero recordar.</p>
    <nav aria-label="Secciones del cuaderno">
      <ul class="menu">
        <li><a href="#lecturas">Lecturas</a></li>
        <li><a href="#notas">Notas</a></li>
      </ul>
    </nav>
  </header>
  <main>
    <section id="lecturas">
      <h2>Lecturas pendientes</h2>
      <ul>
        <li>Una guía para entender HTML</li>
        <li>Un artículo sobre fotografía</li>
      </ul>
    </section>
    <section id="notas">
      <h2>Notas de esta semana</h2>
      <p>Una buena estructura ayuda a encontrar la información.</p>
      <p><a href="https://developer.mozilla.org/es/docs/Web/HTML">
        Consultar la referencia de HTML en MDN
      </a></p>
    </section>
  </main>
  <footer>
    <p>Cuaderno de práctica.</p>
  </footer>
</body>
</html>

Deberías ver un título, una introducción, dos enlaces de navegación, una lista y una sección de notas. Todavía usa la presentación del navegador. El siguiente artículo de CSS parte de este mismo archivo.

Qué aporta cada parte

Estructura del documento
PiezaFunción
<!doctype html>Pide el modo de representación estándar.
html lang="es"Identifica el idioma principal.
headContiene título, metadatos y referencias a recursos.
meta charset="utf-8"Declara la codificación del texto.
meta viewportPermite adaptar el ancho al dispositivo.
bodyContiene lo que presenta la página.
header, main, footerDelimitan cabecera, contenido principal y pie.

El title identifica la pestaña y puede usarse como título del resultado de búsqueda. El h1 encabeza el contenido visible. Aunque aquí se parecen, cumplen funciones distintas. Una descripción clara explica la página; ningún metadato garantiza una posición en Google.

Elige elementos por lo que significan

Los encabezados ordenan el contenido: un h1 para el asunto principal y h2 para sus secciones. Una lista usa ul y elementos li. Un enlace a tiene un destino en href. No necesitas convertir cada párrafo en una caja genérica.

El enlace href="#notas" busca el elemento cuyo id es notas. Usa un identificador único para cada destino. Para navegar a otra página, emplea un enlace; para ejecutar una acción, emplea un botón con el comportamiento correspondiente.

Añadir una imagen con una descripción útil

Cuando tengas una fotografía propia, guárdala como lecturas.jpg junto al HTML. Añade este fragmento dentro de la sección de lecturas. Ajusta el texto alternativo al contenido real y los números a sus dimensiones reales.

html · Una imagen con contexto

<figure>
  <img src="lecturas.jpg"
       alt="Dos libros abiertos con notas en sus márgenes"
       width="1200" height="800">
  <figcaption>Material para preparar las próximas lecturas.</figcaption>
</figure>

El texto alternativo comunica la información relevante cuando la imagen no se ve o se usa un lector de pantalla. Si una imagen es puramente decorativa, alt="" permite omitirla. El pie visible aporta contexto adicional; no tiene por qué repetir el alt.

Prueba el documento, no solo su aspecto

  1. Pulsa Tab y comprueba que llegas a los enlaces; Enter debe activarlos.
  2. Activa Notas y revisa que el navegador vaya a esa sección.
  3. Cambia una lectura, guarda y recarga: confirma que editas el archivo correcto.
  4. Si añades la foto, comprueba ruta, nombre y mayúsculas.
  5. Revisa la jerarquía de encabezados y que los id no se repitan.

Ejercicio: añade una tercera sección

Añade Lecturas terminadas con un h2, una lista de dos títulos y un enlace nuevo en la navegación. Decide un id único y comprueba que el enlace llega a él.

Una solución posible
html · Dentro de la lista de navegación

<li><a href="#terminadas">Terminadas</a></li>
html · Dentro de main

<section id="terminadas">
  <h2>Lecturas terminadas</h2>
  <ul>
    <li>Una introducción a la web</li>
    <li>Notas sobre composición fotográfica</li>
  </ul>
</section>

Cuando la navegación y la estructura funcionen, pasa a CSS. Añadirás color, espacio y una distribución adaptable conservando el contenido que has escrito.

Para seguir leyendo

Volver a UnaCosa