Primeros pasos: introducción

Resumen

Esta clase abre la primera unidad del curso, dedicada a los primeros pasos con LaTeX. Explica para qué sirve la unidad: llevar a quien nunca ha usado LaTeX hasta el punto de escribir, compilar y corregir por su cuenta un documento breve; presenta sus cuatro clases y el hilo que las une, desde la idea de composición tipográfica hasta la lectura de los errores; precisa lo poco que se da por sabido, que es el manejo de archivos y carpetas en un computador; formula el problema que la unidad resuelve, el de pasar de un archivo vacío a un documento compuesto y, cuando algo falla, del mensaje del motor a su causa; y muestra que ese mismo ciclo sirve igual a un informe de laboratorio que a un ensayo de filosofía o a una edición de un texto latino.

Objetivos de aprendizaje

Describir la secuencia de contenidos de la unidad y explicar qué aporta cada clase a la siguiente.
Reconocer los conocimientos previos que la unidad supone y preparar el computador para ella, en particular la visibilidad de las extensiones de los archivos.
Explicar, con un ejemplo, por qué un documento de LaTeX puede no producir resultado y por qué el error no siempre se señala donde está.
Reconocer en otras disciplinas y en las unidades siguientes el ciclo de escribir, compilar y corregir que la unidad construye.

Evaluación de entrada

Antes de recorrer la unidad conviene medir el punto de partida. Esta evaluación es una autoevaluación: no se califica, y su único propósito es orientar el estudio. Sus ocho preguntas tocan, de dos en dos y en orden, las cuatro clases de la unidad; quien nunca haya usado LaTeX no debe esperar acertarlas, y no importa: cada respuesta, acertada o no, explica el punto y nombra la clase que lo trata. Las mismas destrezas se vuelven a medir al final, en la clase de síntesis; como esta es la primera unidad del curso, no hay preguntas sobre unidades anteriores.

Los contenidos de la unidad

Esta unidad sirve al primero de los objetivos del curso, producir y compilar documentos, diagnosticando y corrigiendo sus errores, y es la condición de todos los demás: componer textos en varios idiomas y escrituras, estructurar documentos largos, escribir matemática y lógica, presentar tablas y figuras, gestionar la bibliografía y elegir la clase adecuada a cada género académico suponen que el ciclo de escribir, compilar y corregir ya no ofrece dificultad. Su meta es que quien nunca ha usado LaTeX pueda, al terminarla, escribir un documento breve desde un archivo vacío, compilarlo con LuaLaTeX en Texmaker o en Overleaf y, cuando no compile, encontrar y corregir la causa por su cuenta. Sus cuatro clases forman una cadena en la que cada una se apoya en las anteriores.

Qué es LaTeX. Explica la composición tipográfica, compara el lenguaje de marcado con el procesador de textos, cuenta el origen de TeX y de LaTeX y su principio de separar el contenido de la forma, justifica la elección de LuaLaTeX y muestra cómo una fuente se convierte en un PDF. Fija el vocabulario de toda la unidad: fuente, motor, compilación, preámbulo, cuerpo y registro.
El entorno de trabajo. Instala lo que la primera clase describió: una distribución de TeX, con su gestor de paquetes, y el editor Texmaker, configurado para compilar con LuaLaTeX y guardar en UTF-8; presenta Overleaf como alternativa en el navegador, y explica qué archivos deja la compilación y cuáles se conservan. Termina con dos documentos de prueba que verifican la instalación.
Anatomía de un documento. Descompone la fuente en sus piezas: el preámbulo y el cuerpo, las instrucciones con sus argumentos, los grupos que limitan el alcance de las declaraciones, los entornos, los diez caracteres reservados, los comentarios, los paquetes y la clase. Con ella, el documento mínimo de la primera clase deja de ser una receta y se convierte en una estructura que se entiende pieza por pieza.
Compilar y corregir errores. Enseña a leer el registro: distinguir los errores de las advertencias, localizar cada error en la fuente, reconocer los mensajes más frecuentes y aislar la causa cuando el mensaje no basta. Reúne lo anterior, porque casi todo error es la infracción de una regla de la anatomía de la fuente, y su diagnóstico se apoya en el entorno de trabajo.

La unidad termina con la clase de síntesis y desafíos, que reúne lo logrado en una cadena de conceptos y procedimientos, repite en su evaluación de salida las destrezas de la evaluación de entrada y propone desafíos que combinan varias clases.

Lo que se da por sabido

La unidad parte de casi nada. No supone haber usado LaTeX, ni saber programar, ni conocimientos de matemática; tampoco supone saber inglés, aunque los mensajes del motor estén en ese idioma, porque el curso explica cada uno de los que presenta. Supone solo el manejo corriente de un computador: crear una carpeta, guardar un archivo con un nombre determinado y en una carpeta determinada, encontrarlo después, copiar, mover y borrar archivos, e instalar un programa, o bien disponer de un navegador y de una cuenta en Overleaf.

De ello se sigue una única preparación previa, que conviene hacer antes de la clase sobre el entorno de trabajo. Un nombre de archivo consta de una base y de una extensión, la parte que sigue al último punto: en informe.tex, la base es informe y la extensión, tex. Ahora bien, el explorador de archivos de Windows y el Finder de macOS ocultan por omisión las extensiones conocidas, de modo que informe.tex e informe.pdf aparecen ambos como informe, y los archivos auxiliares de la compilación, que se distinguen solo por su extensión, se vuelven indistinguibles. Por tanto, conviene activar la opción que muestra las extensiones: en Windows, en el menú de vista del explorador de archivos; en macOS, en los ajustes avanzados del Finder. En Linux, los exploradores de archivos las muestran por omisión.

El problema que la unidad resuelve

Quien escribe en un procesador de textos ve el resultado a medida que escribe. En LaTeX, entre la fuente y la página hay un programa que lee la fuente al pie de la letra, y el resultado solo aparece al compilar. Esto plantea dos problemas, que son los de la unidad. El primero es cómo se pasa de un archivo vacío a un documento compuesto: qué hay que instalar, qué debe contener la fuente como mínimo y qué hace el motor con ella. El segundo es qué hacer cuando el documento no sale, o sale distinto de lo que se pretendía: el motor no muestra el error sobre la página, sino que lo describe en el registro, en un lenguaje propio, y a veces lo señala lejos del lugar en que se cometió. El ejemplo siguiente muestra ambos problemas en un documento de quince líneas.

EjemploUna llave que falta

La fuente siguiente es un documento completo: declara la clase, carga los paquetes, guarda el título, el autor y una fecha vacía, y compone dos secciones. Compilada con LuaLaTeX, produce este resultado.

Si en la undécima línea se omite la llave que cierra el argumento de \emph, el motor no produce ningún PDF, y el registro contiene, entre otras, estas líneas.

Registro de compilación

Runaway argument?{hipótesis sobre el 40 \% de los casos. \par \section {La respuesta}\ETC.! File ended while scanning use of \emph ....!  ==> Fatal error occurred, no output PDF file produced!

El error no se señala en la undécima línea, sino al final del archivo: el motor siguió leyendo el argumento de \emph a través del párrafo, de la sección siguiente y de \end{document}, hasta que el archivo se terminó. Ahora bien, el registro da la pista que falta: la línea que sigue a «Runaway argument?» reproduce el argumento desbocado desde su comienzo, y ese comienzo, la llave que precede a «hipótesis», es exactamente el lugar del error. Leer así el registro es lo que enseña la clase sobre la compilación y la corrección de errores; entender por qué una llave sin cerrar arrastra todo lo que sigue es lo que enseña la de la anatomía de un documento.

La respuesta de la unidad a estos dos problemas tiene, por tanto, dos partes. Para el primero, un entorno instalado y probado, y una fuente cuya estructura se entiende pieza por pieza, de modo que nada en ella es una fórmula mágica. Para el segundo, un método: leer el registro desde el primer error, situar el error en la fuente, reconocer la regla que se infringió y, si el mensaje no basta, aislar la causa desactivando partes de la fuente. Ninguna de las dos partes exige memorizar instrucciones; ambas exigen leer la fuente como la lee el motor.

La unidad en las disciplinas

El ciclo que la unidad enseña es el mismo en todas las disciplinas, y lo que cambia de una a otra es solo lo que se escribe. Un informe de laboratorio de química, un ensayo de filosofía con un centenar de notas al pie, un comentario de un pasaje de Cicerón con el texto latino y su traducción, un trabajo de economía con tablas, una tesis de historia con documentos de archivo y un artículo de matemática con teoremas comienzan igual: una carpeta, un archivo fuente con su preámbulo y su cuerpo, una compilación y la lectura de su registro. Del mismo modo, los errores de esta unidad, una llave sin cerrar, un carácter reservado escrito tal cual, un paquete cargado fuera de lugar, aparecen en cualquiera de esos documentos, sin distinción de disciplina.

Por ello, lo que la unidad enseña se usa en los demás cursos del sitio. Los trabajos y apuntes de Lógica Aristotélica o de Fundamentos de Mecánica pueden escribirse en LaTeX desde la primera semana; en Análisis de Datos con R, los resultados de un análisis se incorporan a un documento compuesto; y en Programación en C++ I el ciclo es, en lo esencial, el mismo: se escribe una fuente, un compilador la lee, y sus mensajes, que remiten a números de línea, se leen con el método que esta unidad enseña.

Adónde conduce

Al terminar la unidad, el documento mínimo será un punto de partida conocido, y las unidades siguientes construirán sobre él. La segunda se ocupará del texto mismo: los idiomas y las escrituras, entre ellas el griego y el latín, las tipografías, las notas al pie y las citas largas. La tercera, de la estructura de los documentos largos, con sus capítulos, su índice y sus referencias internas, repartidos en varios archivos. La cuarta, de la escritura de la matemática y de la lógica con su notación correcta; la quinta, de las tablas y las figuras; la sexta, de la bibliografía y de las convenciones de cita de cada disciplina; y la séptima, de las clases de documento adecuadas a cada género académico, de las presentaciones a las cartas y los pósteres. En todas ellas, cada nueva instrucción se escribirá, se compilará y, cuando falle, se corregirá con lo aprendido en esta.