Recursos de aprendizaje

Antes de comprar un manual de LaTeX, cuenta los libros que ya tienes. TeX Live 2024 distribuye lshort, la introducción clásica, en 24 ediciones lingüísticas —español, inglés, alemán, francés, chino, coreano y japonés entre ellas— y todas se abren con un simple texdoc lshort. En el mismo estante están las 317 páginas de TeX by Topic, las 1.308 páginas de la fuente anotada del núcleo de LaTeX y una lista de 481 páginas que documenta 20.323 símbolos. Esta página es el mapa de ese montón: qué leer y en qué orden (para saber dónde preguntar, véase «Comunidad»).

Los libros de LaTeX que ya están en tu disco

Todo esto está sin conexión y se abre ahora mismo. Basta escribir texdoc seguido de la palabra de la primera columna para que el PDF correspondiente aparezca en un visor (texdoc lshort, texdoc symbols). Aquí solo figura lo que se ha comprobado que abre en una instalación completa de TeX Live 2024, y las extensiones están contadas sobre esos mismos PDF. Leer de principio a fin las dos primeras entradas suele ser más rápido que leer cinco artículos encontrados en la red.

Empezar por lshort: «LaTeX2ε en 139 minutos»

Si solo se lee una introducción de principio a fin, que sea lshort. Su título completo es The Not So Short Introduction to LaTeX2ε, con el subtítulo «Or LaTeX2ε in 139 minutes». La edición inglesa incluida en TeX Live 2024 es la versión 6.4 (9 de marzo de 2021), de Tobias Oetiker y otros, y ocupa 153 páginas: prometer 139 minutos y entregar 153 páginas dice algo verdadero sobre el libro. Lo interesante es su origen. Los agradecimientos ingleses declaran sin rodeos que buena parte del material procede de una introducción austríaca a LaTeX 2.09 escrita en alemán por Hubert Partl, Irene Hyna y Elisabeth Schlegl. «Not So Short», por tanto, nunca fue un libro inglés: es el descendiente de uno alemán. Esa línea alemana sigue viajando en TeX Live como l2kurz.pdf (LaTeX2ε-Kurzbeschreibung, versión 3.0c, 8 de abril de 2018).

Se distribuyen veinticuatro ediciones lingüísticas. El japonés (jlshort.pdf), el chino simplificado, el coreano, el alemán, el francés y el español están ahí, junto con todo, del búlgaro al vietnamita. Al ejecutar texdoc -l lshort aparecen con su código de idioma, y la propia queda arriba si la configuración regional coincide. Pero las traducciones no están igual de frescas. Frente a una edición inglesa de 2021, el PDF chino se compuso en 2023, el coreano en 2021, el francés en 2011, el español en 2014 y el japonés en 2015. Lo prudente es proceder en dos tiempos: tomar la visión de conjunto en la edición del propio idioma y comprobar la sección correspondiente de la inglesa en cuanto un detalle ofrezca dudas.

texdoc lshort        # open your local copy (your locale picks the edition)
texdoc -l lshort     # list all 24 language editions, then choose
texdoc -M -l lshort  # same list, machine-readable: name, score, path, language

Qué leer después de lshort, y en qué orden

El principio del orden es: escribir, desaprender, consultar, mirar dentro. Primero llegar a redactar un documento; luego abandonar los hábitos que ya no rigen; después usar las obras de referencia como diccionarios; y solo entonces, si hace falta, leer la implementación. Respetar ese orden significa que, al atascarse, al menos se sabe en qué capa se está atascado. Abrir source2e de entrada no da una respuesta: da una implementación. La lista siguiente no está ordenada por popularidad sino por el momento en que la lectura rinde.

• 1. texdoc lshort: captar de una vez el panorama completo. Saltárselo es no saber después qué consultar.
• 2. texdoc l2tabu: saber qué comandos antiguos evitar, mejor antes de ponerse a leer artículos viejos en la web.
• 3. texdoc usrguide: la guía para autores escrita por el equipo de LaTeX, la versión oficial de lo que ofrece el núcleo actual.
• 4. texdoc amsmath y texdoc symbols: las dos lecturas obligadas para matemáticas: cómo escribirlas y dónde está el símbolo.
• 5. texdoc latex2e: la referencia no oficial para consultar comando a comando; imbatible en «¿qué opciones tenía este?».
• 6. texdoc <paquete>, paquete a paquete: leer el manual de un paquete justo cuando se necesita. No hay ruta más corta.
• 7. texdoc clsguide y texdoc fntguide: en cuanto haya que escribir una clase propia o cambiar de fuentes.
• 8. texdoc texbytopic y texdoc source2e: el interior del motor de TeX y del núcleo de LaTeX. Rara vez hace falta llegar ahí.

Los artículos viejos hacen daño: lo que l2tabu evita

Lo que más tiempo consume al aprender LaTeX es trasladar prácticas de hace veinte años a una instalación actual. l2tabu es el documento que reúne esas prácticas; su título completo es An essential guide to LaTeX2ε usage — Obsolete commands and packages. El original es la edición alemana de Mark Trettin, y TeX Live incluye la traducción inglesa de Jürgen Fenn (versión 1.8.5.7, 17 de junio de 2007, 22 páginas) junto con ediciones francesa, italiana y española. Los comandos de fuente a la antigua sin argumento como \bf e \it, \centerline, los paquetes superados que se solapan con lo que hoy hace el núcleo: todo eso sigue apareciendo con toda naturalidad en los artículos que uno encuentra buscando. Leerlo lleva bastante menos de una hora, y el número de accidentes que esa hora evita es considerable. Una salvedad: l2tabu es a su vez un documento de 2007, así que lo desaconsejado desde entonces no está ahí. Para los cambios recientes, sigue los boletines del propio equipo de LaTeX con texdoc ltnews.

Los estándares impresos: Lamport, el LaTeX Companion y el japonés

En papel el tándem que hay que conocer es «Lamport para aprender, el Companion para consultar». LaTeX: A Document Preparation System (Leslie Lamport, 2.ª edición, 1994) es la guía oficial de usuario escrita por quien creó LaTeX: concisa y acertada sobre el modelo de fondo. The LaTeX Companion (Frank Mittelbach y Ulrike Fischer, con contribuciones de Javier Bezos, Johannes Braams y Joseph Wright; 3.ª edición, 2023, Addison-Wesley, dos volúmenes) es la obra enciclopédica sobre paquetes y detalles de composición. Esta tercera edición también tiene un pie dentro de TeX Live: todos los ejemplos del libro se distribuyen como tlc3-examples —fuentes y PDF de las partes I y II, más de 1.500 archivos— y texdoc tlc3 abre la lista de erratas. Es decir, se pueden hojear los ejemplos antes de decidir la compra.

En japonés, un libro funciona como estándar de facto: LaTeX美文書作成入門, de Haruhiko Okumura y Yusuke Kuroki (Gijutsu-Hyohron). La edición vigente es la 9.ª revisada (diciembre de 2023, unas 432 páginas); recorre en un solo volumen desde los fundamentos hasta terrenos avanzados del tipo «quiero cambiar el diseño por mi cuenta», y la 9.ª edición refuerza el tratamiento de motores modernos como LuaLaTeX y de la instalación de TeX Live. Okumura está además detrás de buena parte del LaTeX japonés, jsclasses incluido, de modo que el libro se ajusta bien a las instalaciones reales. Si la composición japonesa forma parte del trabajo, este es el volumen único más rápido de tener a mano.

Recursos de aprendizaje en línea, y cómo leerlos

Para las consultas diarias la red es más rápida, pero conviene adquirir el hábito de mirar el año de lo que se encuentra. Como introducción, Overleaf Learn (overleaf.com/learn) se lee bien, y su «Learn LaTeX in 30 minutes» es una entrada solvente, legible sin cuenta. Para amplitud, el LaTeX Wikibook (en.wikibooks.org/wiki/LaTeX). Para una pregunta concreta, TeX Stack Exchange (tex.stackexchange.com) casi con seguridad ya la tiene. Para ver las trampas habituales ordenadas por tipo, el sitio es el TeX FAQ (texfaq.org), y texdoc visualfaq, en el disco propio, es un índice visual de ese mismo FAQ: 34 páginas construidas sobre la idea de pulsar una muestra compuesta y aterrizar en la entrada correspondiente. Para los cambios en el propio LaTeX la fuente primaria es el LaTeX Project (latex-project.org); en local, texdoc ltnews sigue esos mismos boletines. Para los paquetes la fuente primaria es CTAN (ctan.org). En japonés, los dos centros son la TeX Wiki (texwiki.texjp.org) y el foro TeX de Okumura (okumuralab.org/tex/).

Aprender con eficiencia: cinco reglas para evitar rodeos

• Leer una introducción corta de principio a fin. lshort u Overleaf Learn. Acumular fragmentos sin visión de conjunto deja sin saber qué es lo que no se sabe.
• Aprender los paquetes bajo demanda, con texdoc <nombre>. El manual propio de un paquete es siempre la ruta más corta hacia él.
• Aprender escribiendo. Terminar un documento enseña más que hojear tres manuales. Cuando algo falle, leer el propio .log: el error literal es el material didáctico más breve que existe.
• Mirar el año de lo que se lee. Las prácticas de entradas antiguas pueden estar superadas. Empezar por texdoc l2tabu y mantenerse al día con texdoc ltnews.
• Buscar cuando uno se atasca; si no basta, preguntar con un ejemplo mínimo funcional. La misma pregunta suele estar ya en TeX Stack Exchange (véase «Comunidad»).