Clase de documento y preámbulo

Todo documento LaTeX empieza con una sola línea: \documentclass. La clase de documento que eliges ahí fija el esqueleto y el aspecto general de todo el documento: si es un artículo, un libro o un conjunto de diapositivas. Después, en el preámbulo, entre \documentclass y \begin{document}, declaras los paquetes que usarás y los ajustes que afectan a todo el documento. El objetivo de este capítulo es ayudarte a decidir, antes de escribir el cuerpo, qué clase usar y cuánto debe ir en el preámbulo.

\documentclass — la primera línea

Todo documento empieza con la declaración \documentclass[options]{class}. Este comando es obligatorio y debe ir primero: no puede aparecer nada antes, salvo comentarios. El nombre de la clase entre llaves {} elige el tipo de documento, y las opciones entre corchetes [] ajustan detalles como el tamaño de letra y el papel; las opciones son opcionales.

Una clase gobierna el aspecto en general: qué tipo y tamaño usan los encabezados, cómo se numeran capítulos y secciones, y cómo se construyen márgenes, encabezados y pies. Estas reglas viven en un archivo de clase, con extensión .cls. En el cuerpo escribes solo el significado, por ejemplo \section{Introduction}, y la clase lo convierte en una apariencia concreta. Por eso, cambiando solo la clase puedes recomponer el mismo manuscrito con otro estilo. Elegir primero una clase no es solo elegir fuentes; es elegir la estructura del documento.

Las clases estándar

LaTeX incluye estas clases desde el principio. article es la clase general más usada, para artículos académicos y documentos cortos. No tiene capítulos (\chapter); su nivel superior es la sección (\section). report queda entre un artículo y un libro, para documentos más largos que tienen capítulos, como informes técnicos y tesis. book es para libros completos: tiene capítulos, presupone impresión a doble cara y permite separar front matter, main matter y back matter. letter es para cartas, y slides para diapositivas, aunque hoy casi no se usa.

En book, en particular, divides el documento con \frontmatter / \mainmatter / \backmatter. La zona \frontmatter (prefacio, índice, etc.) se numera con romanos en minúscula (i, ii, iii…) y sus capítulos no llevan número. \mainmatter reinicia la página, cambia a números arábigos (1, 2, 3…) y empieza la numeración de capítulos. \backmatter (apéndices, índice analítico) mantiene la numeración arábiga pero elimina los números de capítulo.

Más allá de las clases estándar (beamer, KOMA-Script, japonés)

Más allá de las clases estándar, CTAN ofrece muchas clases para fines concretos. Para diapositivas de presentación, beamer es la opción estándar: cada entorno frame se convierte en una diapositiva, con revelados por pasos (overlays) y temas. Para sustituir las clases estándar por una tipografía predeterminada más cuidada, se usan mucho scrartcl / scrreprt / scrbook de KOMA-Script (correspondientes a article / report / book), que además son mucho más configurables.

Para composición japonesa, eliges una clase dedicada que corresponda al motor. En pLaTeX / upLaTeX, jsarticle / jsbook de Haruhiko Okumura (jsclasses) son el estándar. En LuaLaTeX, se usan sus equivalentes para LuaLaTeX, ltjsarticle / ltjsbook (ltjsclasses). La clase más reciente jlreq se basa en “Requirements for Japanese Text Layout (JLReq)”; funciona con pLaTeX, upLaTeX o LuaLaTeX y detecta el motor automáticamente (con las opciones report / book se comporta como report o book). Si una universidad o revista proporciona una plantilla, da prioridad a esa clase y añade después solo los ajustes visuales imprescindibles.

Opciones comunes

Las opciones van entre corchetes, separadas por comas, por ejemplo \documentclass[11pt,a4paper,twoside]{article}. Las más habituales son las siguientes; la mayoría son interruptores para todo el documento.

Que los capítulos de book empiecen en página derecha (impar) lo controlan openright (predeterminado en book) y openany (predeterminado en report). Las opciones dadas aquí se pasan no solo a la clase, sino también a los paquetes cargados después; actúan como opciones globales.

El preámbulo — \usepackage y ajustes globales

Las líneas que van justo después de \documentclass hasta justo antes de \begin{document} forman el preámbulo. Todavía no es el cuerpo: es donde preparas todo el documento. El cuerpo, es decir, el contenido impreso, empieza en \begin{document} y termina en \end{document}.

El elemento central del preámbulo es \usepackage[options]{package}. Mientras la clase fija el aspecto de base, un paquete, con extensión .sty, añade funciones utilizables sin depender del tipo de documento: por ejemplo amsmath para mejorar las matemáticas, graphicx para incluir figuras o hyperref para añadir enlaces. Un solo comando puede cargar varios paquetes a la vez (\usepackage{amsmath,amssymb}). Una regla útil: si da forma al aspecto de un tipo concreto de documento, es una clase; si añade una función independiente del tipo, es un paquete.

Además de cargar paquetes, el preámbulo contiene ajustes y definiciones que se aplican a todo el documento: los metadatos de título \title{...}, \author{...}, \date{...}; comandos propios con \newcommand; cambios de longitudes con \setlength; el estilo de página con \pagestyle, etc. Deben declararse antes del cuerpo: ponerlos dentro del cuerpo puede no tener efecto o producir un error.

Aquí tienes un ejemplo completo con un preámbulo típico. Elige una clase, carga paquetes de codificación e idioma, define un comando, ajusta márgenes y metadatos de título, y después entra en el cuerpo.

\documentclass[11pt,a4paper]{article}

% --- preamble: packages ---
\usepackage[T1]{fontenc}
\usepackage{amsmath}      % better mathematics
\usepackage{graphicx}     % \includegraphics
\usepackage[margin=25mm]{geometry}
\usepackage{hyperref}     % load last

% --- preamble: settings & definitions ---
\newcommand{\R}{\mathbb{R}}
\setlength{\parindent}{0pt}
\title{A Short Note}
\author{Ada Lovelace}
\date{\today}

\begin{document}
\maketitle
Hello, \LaTeX! For all $x \in \R$ we have $x^2 \ge 0$.
\end{document}

El orden de carga también importa. Los paquetes que tienden a interferir pueden comportarse de forma distinta según la secuencia, y algunos, como hyperref, normalmente se cargan tarde (con excepciones que conviene comprobar en los manuales correspondientes). En un documento japonés, el primer paso es cambiar la propia clase a algo como jsarticle o ltjsarticle: elegir una clase acorde con el motor es lo más importante. Si ajustar el preámbulo empieza a impedirte escribir el cuerpo, volver a una configuración mínima y avanzar el texto es una buena decisión de ingeniería.

No dejes que el preámbulo crezca más que el documento

El preámbulo es la base del documento, no un vertedero. Los ajustes visuales de un solo uso, los paquetes que solo probaste y las abreviaturas sin significado dificultan rastrear errores después. Empieza solo con ajustes globales: clase, idioma y fuentes, matemáticas, figuras y tablas, enlaces. Añade \newcommand solo para construcciones que realmente se repiten mientras escribes. Si usas una plantilla de envío, respeta el preámbulo que proporciona y evita sustituir paquetes que pueden estar ligados a la clase.

• Informe nuevo: empieza con article o jsarticle; no añadas diseño de página complejo hasta que lo necesites.
• Tesis: da prioridad a la clase de la plantilla universitaria y deja los ajustes propios de márgenes o encabezados para el final.
• Japonés + fuentes OpenType: elige una clase acorde con el motor, como ltjsarticle/jlreq para LuaLaTeX o jsarticle para upLaTeX.
• Cuando aparezcan errores: sospecha del \usepackage o \newcommand añadido más recientemente y reduce a un ejemplo mínimo.