Lección 12 de 19
Errores comunes, buenas prácticas y siguientes pasos
Diagnosticar los errores típicos leyendo el registro, escribir fuentes limpios y abrir la puerta a Beamer, TikZ y biblatex.
Objetivos de la lección
- Leer el registro de compilación y localizar los errores habituales
- Aplicar hábitos de escritura que evitan errores
- Conocer los ecosistemas siguientes: presentaciones, dibujo y bibliografía moderna
Leer el registro sin miedo
Cuando la compilación falla, LaTeX escribe en el registro (.log) una línea que empieza por ! con el diagnóstico y, justo debajo, la línea y el punto exactos del fuente donde detectó el problema. El error más común, «Undefined control sequence», significa exactamente eso: has usado un comando que no existe — una letra mal escrita (\secton) o un paquete sin cargar.
Otros clásicos: «File not found» (el \includegraphics apunta a un archivo inexistente), «Missing \end{document}» (el documento no se cierra), «Runaway argument» (falta una llave de cierre y LaTeX se pasó de largo buscando }), y «There's no line here to end» (un \\ donde no hay párrafo, típico tras \item vacío).
La estrategia ante un error es siempre la misma: arregla el primero y recompila. Los errores de LaTeX se acumulan en cadena y el segundo casi siempre es consecuencia del primero. Nunca escribas fuentes largos sin compilar: compila cada poco y sabrás siempre en qué cambio nació el error.
Buenas prácticas de fuentes limpios
Declara estructura, no formato: \subsection en lugar de \textbf con números manuales; \emph en lugar de cursivas para indicar énfasis. Automatizar es la razón de ser de LaTeX y tu garantía de consistencia.
Etiqueta todo lo citable con claves con prefijo (sec:, fig:, tab:, eq:) y usa siempre el espacio irrompible antes de referencias y citas: figura~\ref{...}. Un párrafo por línea en blanco; comentarios % para anotar secciones largas del fuente; y un preámbulo corto —si acumulas diez paquetes «por si acaso», algo vas mal.
Cuida también las advertencias (warnings), que no detienen la compilación pero delatan problemas: «Overfull \hbox» significa que una línea sobresale del margen, casi siempre por una palabra intradivisible o una fórmula larga; «Label(s) may have changed» solo pide recompilar.
Siguientes pasos
Presentaciones: la clase beamer convierte tu fuente en diapositivas con temas, transiciones y estructura por marcos (frame). Es el estándar de las defensas de tesis y los seminarios técnicos.
Dibujo: TikZ dibuja diagramas, gráficas y esquemas directamente en el fuente con un lenguaje declarativo; su curva de aprendizaje es real pero el resultado es tan portable como tu documento. PGFPlots, construido sobre TikZ, genera gráficas de datos.
Bibliografía moderna: biblatex con biber supera a BibTeX clásico (utf8 nativo, estilos por disciplina, entradas online ricas). Y para plantillas de revistas y congresos, busca siempre la clase oficial antes de improvisar el formato.
Un error diagnosticado en directo
Este fuente tiene un error deliberado: \textt en lugar de \texttt. Compílalo y lee el panel de errores: verás «Undefined control sequence» señalando la línea exacta.
Después corrígelo (añade la letra que falta) y recompila para ver el documento sano. Ese ciclo error-diagnóstico-correión es exactamente tu día a día futuro con LaTeX.
Caza de errores
El fuente inicial contiene cuatro errores clásicos: un comando mal escrito, una llave sin cerrar, un entorno itemize sin cerrar y el \end{document} ausente.
Arréglalos de uno en uno, recompilando tras cada corrección para ver cómo cambia el diagnóstico. El objetivo es practicar la lectura del registro, no acertar a la primera.