Primeros pasos: síntesis y desafíos

Resumen

Esta clase cierra la primera unidad del curso, dedicada a los primeros pasos con LaTeX. Reconstruye la cadena de conceptos y procedimientos que va de la composición tipográfica a la depuración de un documento, señalando en cada eslabón qué principio se usa y en qué clase se establece; sitúa lo logrado respecto del plan del curso y precisa qué cuestiones, apenas tocadas, quedan para las unidades siguientes; repite en su evaluación de salida las destrezas de la evaluación de entrada; y termina con seis desafíos, de dificultad superior a la de los problemas de las clases, que exigen combinar los instrumentos de varias de ellas para diagnosticar documentos que fallan o para planificar uno a partir de una descripción.

Objetivos de aprendizaje

Reconstruir el orden de los conceptos y procedimientos de la unidad, identificando el principio en que se apoya cada uno.
Explicar cómo se relacionan las reglas de lectura de la fuente, su anatomía y los mensajes del registro.
Distinguir lo que la unidad estableció de lo que solo anticipó y que las unidades siguientes desarrollarán.
Diagnosticar documentos que fallan por varias causas a la vez, ordenando las correcciones según el registro.
Planificar el preámbulo y el cuerpo de un documento a partir de la descripción de lo que debe contener.

Lo logrado en la unidad

La unidad se propuso llevar a quien nunca había usado LaTeX hasta el punto de escribir, compilar y corregir por su cuenta un documento breve. El propósito se ha cumplido con una sola salvedad, declarada desde la introducción: se ha dado por sabido el manejo de archivos y carpetas en un computador. Con ella, el camino recorrido puede leerse como una sola cadena en cuatro tramos, en la que cada concepto o procedimiento se apoya en los anteriores.

Qué es LaTeX

La clase Qué es LaTeX partió de la composición tipográfica, el conjunto de decisiones que disponen cada letra, cada línea y cada página, y de las exigencias particulares de los textos académicos. De ellas dedujo la conveniencia de un lenguaje de marcado, en el que el autor declara qué es cada cosa y la clase del documento decide cómo se ve: la separación del contenido y de la forma, que reaparece en toda la unidad. Distinguió después los tres motores y eligió LuaLaTeX, que lee Unicode y carga las tipografías del sistema; fijó las tres reglas con que el motor lee la fuente (los espacios repetidos valen uno, una línea en blanco termina el párrafo y el signo de porcentaje inicia un comentario), y describió el ciclo de escribir, compilar y leer, con el registro y el archivo auxiliar que deja cada compilación.

El entorno de trabajo

La clase sobre el entorno de trabajo convirtió esa descripción en una instalación: una distribución, TeX Live, MiKTeX o MacTeX, con su gestor de paquetes; Texmaker, configurado para compilar con LuaLaTeX, guardar en UTF-8 y sincronizar la fuente con el PDF; y Overleaf, cuyo compilador predeterminado hay que cambiar en cada proyecto. Estableció además la regla de una carpeta por proyecto, la distinción entre lo que el autor escribe y lo que la compilación regenera, y las tres causas por las que un PDF puede no cambiar: un error grave que impide escribirlo, un visor que lo bloquea o no lo recarga, y la compilación de otro archivo.

Anatomía de un documento

La clase sobre la anatomía de un documento explicó pieza por pieza lo que el documento mínimo traía como receta. El preámbulo configura y el cuerpo compone, porque al llegar a \begin{document} la configuración se cierra. Las instrucciones se dividen en palabras de control, cuyo nombre termina en el primer carácter que no es letra y que consumen el espacio siguiente, y símbolos de control, que no lo consumen; reciben argumentos obligatorios entre llaves y opcionales entre corchetes, y algunas tienen una forma con asterisco. Las declaraciones rigen hasta el final del grupo que las contiene, y los entornos, que son grupos, deben cerrarse en el orden inverso al de su apertura. Los diez caracteres reservados hacen algo en lugar de imprimirse, y cada uno tiene su modo de imprimirse. Los paquetes y la clase, con sus opciones, completan la estructura.

Compilar y corregir errores

La clase sobre la compilación y la corrección de errores reunió todo lo anterior. Explicó que el motor trabaja en pasadas, de modo que las referencias y el índice se completan en la pasada siguiente, y que latexmk repite las pasadas por sí solo; enseñó a leer un error por su línea de exclamación, su número de línea y el corte que separa lo leído de lo que faltaba leer; distinguió los errores, que siempre se corrigen, de las advertencias y de los avisos de cajas; asoció los mensajes más frecuentes a sus causas, que casi siempre son infracciones de la anatomía de la fuente; y propuso una estrategia: leer primero el primer error, dividir la fuente por mitades, reducir el problema a un ejemplo mínimo, limpiar los auxiliares y buscar el mensaje.

La figura siguiente reúne los cuatro tramos en una sola cadena. Cada nudo de la columna es un concepto o un procedimiento, numerado según el orden en que se apoyan unos en otros y unido por un arco a los eslabones anteriores que usa; alrededor flotan los apoyos, es decir, los principios a los que la cadena recurre una y otra vez, cada uno unido con un trazo firme a los eslabones que se apoyan en él y con uno punteado al eslabón donde se establece, salvo el que se admite sin estudiarlo, que se dibuja como un anillo. Al pulsar un apoyo se destacan todos los eslabones que lo usan, y cada eslabón remite a la clase en que se estudia.

Apoyos de la cadena

AArchivos y carpetas. El manejo corriente de archivos y carpetas en un computador: crearlos, nombrarlos, encontrarlos, copiarlos y distinguirlos por su extensión. Se da por sabido desde la introducción. Se admite sin demostración en esta unidad.
BContenido y forma. El autor declara qué es cada cosa, y la clase del documento y el preámbulo deciden cómo se ve. Se establece en: 2. Lenguaje de marcado.
CUnicode y tipografías. LuaLaTeX lee la fuente en Unicode, guardada en UTF-8, y carga las tipografías del sistema; un carácter que la tipografía no contiene no detiene la compilación, pero falta en el PDF. Se establece en: 3. Motores y LuaLaTeX.
DEl registro. Cada compilación anota en el archivo de registro lo que hizo, con sus errores y advertencias; es lo primero que se lee cuando algo falla. Se establece en: 5. Fuente, compilación y PDF.
EGrupos y alcance. Una declaración rige hasta el final del grupo que la contiene; las llaves y los entornos abren grupos que deben cerrarse en el orden inverso al de su apertura. Se establece en: 12. Grupos y entornos.
FCaracteres reservados. Diez caracteres hacen algo en lugar de imprimirse; escritos tal cual en el texto, producen un error o un efecto inadvertido. Se establece en: 13. Caracteres reservados.
GEl primer error. Para recuperarse de un error el motor adivina, y sus adivinanzas pueden producir errores nuevos; solo el primero corresponde con certeza a la fuente. Se establece en: 16. Lectura de un error.

Tramo 1 Qué es LaTeX
- Explicar qué es la composición tipográfica y por qué los textos académicos la exigen.
- Separar el contenido de la forma mediante un lenguaje de marcado.
- Elegir el motor según los idiomas, las escrituras y las tipografías, y justificar LuaLaTeX.
- Predecir lo que produce una fuente según las reglas de los espacios, los párrafos y los comentarios.
1. Composición tipográfica. Componer es decidir dónde cae cada letra, dónde termina cada línea y dónde se corta cada página; los textos académicos, con fórmulas, remisiones, notas y varios idiomas, lo exigen en mayor grado.
  Se demuestra en: Qué es LaTeX.
2. Lenguaje de marcado. En LaTeX, un conjunto de macros escrito sobre TeX, el autor marca el contenido en un archivo de texto plano, y la forma se deriva de la clase y del preámbulo.
  Usa: 1. Composición tipográfica. Se demuestra en: Qué es LaTeX.
3. Motores y LuaLaTeX. pdfLaTeX, XeLaTeX y LuaLaTeX entienden el mismo LaTeX, pero solo los dos últimos leen Unicode y cargan las tipografías del sistema; el curso usa LuaLaTeX.
  Usa: 2. Lenguaje de marcado. Se demuestra en: Qué es LaTeX.
4. Espacios, párrafos y comentarios. Varios espacios valen uno y un salto de línea vale un espacio; una línea en blanco termina el párrafo; el signo de porcentaje convierte en comentario el resto de la línea, con su salto.
  Usa: 2. Lenguaje de marcado. Se demuestra en: Qué es LaTeX.
5. Fuente, compilación y PDF. Se escribe la fuente, el motor la compila y se lee el PDF; junto a él quedan el registro y el archivo auxiliar.
  Usa: 3. Motores y LuaLaTeX. Se apoya en: A (Archivos y carpetas). Se demuestra en: Qué es LaTeX.
Tramo 2 El entorno de trabajo
- Elegir una distribución y un tipo de instalación según el sistema, el espacio y la conexión.
- Configurar Texmaker y Overleaf para compilar con LuaLaTeX.
- Organizar cada proyecto en su carpeta y decidir qué archivos se conservan.
- Explicar por qué un PDF puede no cambiar tras una corrección.
1. Distribución y paquetes. Una distribución reúne los motores, los paquetes, las tipografías y un gestor que instala lo que falta: TeX Live, MiKTeX o MacTeX, completa o básica.
  Usa: 3. Motores y LuaLaTeX. Se apoya en: A (Archivos y carpetas). Se demuestra en: El entorno de trabajo.
2. Texmaker y Overleaf. Texmaker se configura para compilar con LuaLaTeX, guardar en UTF-8 y sincronizar la fuente con el PDF; en Overleaf se elige LuaLaTeX en cada proyecto.
  Usa: 5. Fuente, compilación y PDF, 6. Distribución y paquetes. Se apoya en: C (Unicode y tipografías). Se demuestra en: El entorno de trabajo.
3. Carpeta y auxiliares. Cada documento tiene su carpeta; lo que el autor escribió o aportó se conserva, y los auxiliares, que la compilación regenera, pueden borrarse.
  Usa: 5. Fuente, compilación y PDF, 7. Texmaker y Overleaf. Se apoya en: A (Archivos y carpetas). Se demuestra en: El entorno de trabajo.
4. El PDF que no cambia. Si el PDF no cambia, o la compilación no lo escribió, o el visor lo bloquea o no lo recarga, o se compiló otro archivo; el registro y la hora del PDF lo deciden.
  Usa: 8. Carpeta y auxiliares, 7. Texmaker y Overleaf. Se apoya en: D (El registro). Se demuestra en: El entorno de trabajo.
Tramo 3 Anatomía de un documento
- Distinguir el preámbulo del cuerpo y decidir dónde va cada instrucción.
- Reconocer las partes de una instrucción y predecir dónde termina su nombre.
- Predecir el alcance de las declaraciones y anidar correctamente los entornos.
- Imprimir los diez caracteres reservados y explicar qué hacen sin protección.
1. Preámbulo y cuerpo. El preámbulo carga paquetes y toma decisiones sin componer nada; el cuerpo es el único lugar donde se compone; lo que solo define o guarda puede ir en ambos, y conviene en el preámbulo.
  Usa: 5. Fuente, compilación y PDF. Se apoya en: B (Contenido y forma). Se demuestra en: Anatomía de un documento.
2. Instrucciones. Una palabra de control termina en el primer carácter que no es letra y consume el espacio siguiente; un símbolo de control tiene un solo carácter y no lo consume; los argumentos van entre llaves o entre corchetes.
  Usa: 4. Espacios, párrafos y comentarios. Se demuestra en: Anatomía de un documento.
3. Grupos y entornos. Una declaración rige hasta el final de su grupo; los entornos son grupos, y uno abierto dentro de otro se cierra antes que él.
  Usa: 11. Instrucciones. Se apoya en: B (Contenido y forma). Se demuestra en: Anatomía de un documento.
4. Caracteres reservados. La barra inversa, las llaves, el porcentaje, el dólar, el signo et, la almohadilla, el guion bajo, el circunflejo y la tilde hacen algo en lugar de imprimirse, y cada uno se imprime de un modo propio.
  Usa: 11. Instrucciones, 4. Espacios, párrafos y comentarios. Se demuestra en: Anatomía de un documento.
5. Paquetes y clase. Los paquetes amplían lo que LaTeX sabe hacer y se cargan solo en el preámbulo; la clase, con sus opciones, fija la forma general del documento.
  Usa: 10. Preámbulo y cuerpo, 6. Distribución y paquetes. Se apoya en: B (Contenido y forma). Se demuestra en: Anatomía de un documento.
Tramo 4 Compilar y corregir errores
- Explicar por qué las referencias y el índice necesitan otra pasada, y compilar con latexmk.
- Leer un error del registro: su mensaje, su línea y el punto de la detección.
- Relacionar los errores más frecuentes con sus causas probables.
- Localizar la causa real de un error con una estrategia ordenada, y decidir qué advertencias atender.
1. Pasadas y latexmk. En cada pasada el motor anota en los auxiliares números y títulos que la pasada siguiente usa; latexmk repite las pasadas hasta que nada cambie.
  Usa: 8. Carpeta y auxiliares. Se apoya en: D (El registro). Se demuestra en: Compilar y corregir errores.
2. Lectura de un error. Un error se reconoce por su línea de exclamación; la línea que empieza con l. da el número de la línea de la fuente, partida en lo leído y lo que faltaba leer.
  Usa: 9. El PDF que no cambia, 11. Instrucciones. Se apoya en: D (El registro). Se demuestra en: Compilar y corregir errores.
3. Errores frecuentes. Instrucciones o entornos no definidos, fórmulas no abiertas, llaves que no se corresponden, archivos que faltan y texto en el preámbulo: cada mensaje delata la infracción de una regla de la anatomía de la fuente.
  Usa: 16. Lectura de un error, 10. Preámbulo y cuerpo, 12. Grupos y entornos, 13. Caracteres reservados, 14. Paquetes y clase. Se apoya en: E (Grupos y alcance), F (Caracteres reservados). Se demuestra en: Compilar y corregir errores.
4. Estrategia de depuración. Leer el primer error, dividir el cuerpo por mitades sin cortar grupos ni entornos, reducir a un ejemplo mínimo, limpiar los auxiliares y buscar el mensaje.
  Usa: 17. Errores frecuentes, 4. Espacios, párrafos y comentarios, 8. Carpeta y auxiliares. Se apoya en: D (El registro), E (Grupos y alcance), G (El primer error). Se demuestra en: Compilar y corregir errores.
5. Advertencias. Las advertencias no detienen la compilación, pero algunas exigen actuar: referencias indefinidas, peticiones de compilar otra vez, líneas que sobresalen y caracteres que faltan.
  Usa: 15. Pasadas y latexmk, 16. Lectura de un error. Se apoya en: C (Unicode y tipografías), D (El registro). Se demuestra en: Compilar y corregir errores.

Hacia el texto. La cadena se detiene donde el documento mínimo ya no basta: el texto mismo, con sus idiomas, escrituras, notas y citas, es el objeto de la unidad siguiente.