Saltar al contenido
Topos Uranos
Español

Anatomía de un documento

Resumen

Esta clase descompone una fuente de LaTeX en sus piezas. Distingue el preámbulo del cuerpo y explica qué puede ir en cada uno y por qué; describe las instrucciones, con sus dos clases de nombres, sus argumentos obligatorios y opcionales y sus formas con asterisco, y precisa dónde termina el nombre de una instrucción; muestra cómo los grupos limitan el alcance de las declaraciones; presenta los entornos y el error que produce anidarlos mal; recorre los diez caracteres reservados, lo que hace cada uno y cómo se imprime; explica los comentarios como medio para desactivar código; y presenta brevemente los paquetes y la clase del documento con sus opciones, que la unidad dedicada a la estructura desarrollará.

Objetivos de aprendizaje

  1. Distinguir el preámbulo del cuerpo y decidir dónde debe ir una instrucción según lo que hace.
  2. Reconocer en una instrucción su nombre, sus argumentos obligatorios y opcionales y su forma con asterisco, y predecir dónde termina su nombre.
  3. Predecir el alcance de una declaración dentro de grupos y entornos, y escribirla de modo que afecte solo al texto debido.
  4. Anidar correctamente los entornos e interpretar el error que produce un anidamiento incorrecto.
  5. Imprimir cada uno de los diez caracteres reservados y explicar qué hace cada uno cuando no se protege.

Las dos partes de una fuente

Toda fuente de LaTeX tiene la misma forma. Comienza con \documentclass, que declara la clase del documento. Lo que sigue, hasta \begin{document}, es el preámbulo: en él se cargan los paquetes y se toman las decisiones que valen para todo el documento, pero no se compone nada. Entre \begin{document} y \end{document} está el cuerpo, el único lugar donde se compone texto. Lo que se escriba después de \end{document} se ignora por completo.

La división no es una convención de estilo, sino una consecuencia de cómo trabaja LaTeX. Al llegar a \begin{document}, LaTeX cierra la configuración: ya se sabe qué paquetes hay y qué tipografía, qué idioma y qué tamaño de página rigen, y desde ese momento se compone. De ello se siguen dos reglas, y dos errores. Primera: un paquete solo puede cargarse en el preámbulo, porque podría cambiar decisiones ya aplicadas; un \usepackage en el cuerpo produce el error «Can be used only in preamble». Segunda: en el preámbulo no se compone nada; un texto, un título de sección o un índice escritos antes de \begin{document} producen el error «Missing \begin{document}».

Entre ambos extremos hay instrucciones que solo definen o guardan algo, sin componerlo: \newcommand, que define una instrucción nueva, o \title, que guarda el título para cuando \maketitle lo imprima. Esas funcionan en cualquiera de las dos partes, pero van en el preámbulo, porque así rigen desde el comienzo y quien lea la fuente las encuentra reunidas.

EjemploUn documento con sus partes señaladas

Los comentarios, que comienzan con %, señalan las partes; el motor los ignora. La última línea, escrita después de \end{document}, tampoco aparece en el resultado.

Código LaTeX
\documentclass{article}      % la clase\usepackage{fontspec}        % preámbulo: paquetes\usepackage[spanish]{babel}\title{Informe de lectura}   % preámbulo: datos que se guardan\author{Ana Pérez}\date{}​\begin{document}             % comienza el cuerpo\maketitle\section{Planteamiento}El cuerpo es el único lugar donde se compone texto.\end{document}               % fin del cuerpoEsta línea no aparece en el resultado.
Resultado
Resultado

La instrucción \date{}, con el argumento vacío, hace que \maketitle no imprima la fecha, que de otro modo sería la de la compilación.