La estructura del documento: introducción

Resumen

Esta clase abre la tercera unidad del curso, dedicada a la estructura del documento. Explica para qué sirve la unidad: pasar del texto bien compuesto de la unidad anterior a un documento largo con arquitectura propia, cuyas partes se numeran, se listan en un índice, se remiten unas a otras y se reparten en varios archivos; presenta sus cinco clases y el hilo que las une, desde la clase del documento y la página hasta el preámbulo propio; precisa lo que se da por sabido de las unidades anteriores; recuerda de dónde proceden las formas de los documentos académicos; formula el problema que la unidad resuelve, el de que un documento cuyas remisiones y números se escriben a mano empieza a mentir en cuanto cambia; y muestra que esa arquitectura sirve igual a una tesis de física que a una de historia.

Objetivos de aprendizaje

Describir la secuencia de contenidos de la unidad y explicar qué aporta cada clase a la siguiente.
Reconocer lo que la unidad da por sabido de las anteriores y repasarlo si hace falta.
Explicar, con un ejemplo, por qué las remisiones internas no se escriben a mano.
Reconocer en los géneros académicos de distintas disciplinas la estructura que la unidad enseña a componer.

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 dos primeras preguntas repasan lo que la unidad da por sabido de las anteriores; las diez siguientes tocan, de dos en dos y en orden, las cinco clases de la unidad. Quien nunca haya compuesto un documento largo no debe esperar acertarlas: 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.

Evaluación de entrada

Antes de comenzar la unidad, mide tu punto de partida. Es una autoevaluación breve: no se califica y su resultado se guarda solo en tu navegador.

Pregunta 1De unidades anterioresTras la primera compilación de un documento, una remisión hecha con \ref aparece como dos signos de interrogación, y el registro pide compilar otra vez. ¿Qué ocurre?
En la primera pasada el motor anotó los números en el archivo auxiliar, pero solo puede usarlos en la pasada siguiente; basta compilar otra vez, o compilar con latexmk.
La etiqueta está mal escrita, y hay que corregirla.
Falta un paquete para las referencias.
El archivo auxiliar está dañado y hay que borrarlo.
Pregunta 2De unidades anterioresUn ensayo marca los títulos de obras con \obra{…}, definida en el preámbulo como \newcommand{\obra}[1]{\emph{#1}}, en lugar de escribir \textit{…} en cada lugar. ¿Qué gana?
Que el aspecto de todos los títulos se cambia en una sola línea, sin tocar otras cursivas que cumplen otras funciones.
Nada, porque el resultado es el mismo.
Que la compilación es más rápida.
Que los títulos entran solos en el índice.
Pregunta 3Un estudiante escribe su tesis con \documentclass{article} y divide el texto con \chapter{…}. ¿Qué ocurre al compilar?
El motor produce el error «Undefined control sequence», porque la clase article no tiene capítulos.
Los capítulos se componen como secciones.
Los capítulos se componen bien, porque todas las clases tienen las mismas divisiones.
Se ignoran sin aviso.
Pregunta 4Una universidad exige márgenes de 2,5 centímetros en papel A4. ¿Cuál es la manera adecuada de fijarlos?
Con el paquete geometry, por ejemplo \usepackage[a4paper, margin=2.5cm]{geometry} en el preámbulo.
Con la opción a4paper de la clase, que fija los márgenes.
Con \hspace al comienzo de cada línea.
Reduciendo el tamaño de letra con \small.
Pregunta 5En un documento de clase article se escribe \setcounter{tocdepth}{1} antes de \tableofcontents. ¿Qué muestra el índice?
Solo las secciones, sin las subsecciones.
Solo las subsecciones.
Nada, porque el índice queda vacío.
Todas las divisiones, pero sin números.
Pregunta 6En un documento de clase article, tras la instrucción \appendix, se escriben dos \section. ¿Cómo se numeran?
Con letras: A y B.
Siguen la numeración anterior, como secciones ordinarias.
Sin número, como las secciones con asterisco.
Con números romanos: I y II.
Pregunta 7Un autor escribe \label{sec:metodos} en la línea anterior a \section{Métodos}, que es la sección 2. ¿Qué número imprime \ref{sec:metodos}?
El de la división anterior, 1, porque la etiqueta toma el último número asignado antes de ella.
El 2, porque la etiqueta está junto a la sección.
Dos signos de interrogación, en todas las compilaciones.
Un error, porque la etiqueta debe ir dentro del título.
Pregunta 8¿Qué cambia en un documento al cargar el paquete hyperref?
Las remisiones, las entradas del índice y las llamadas de las notas se convierten en enlaces del PDF, y el PDF recibe marcadores.
Los números de las secciones y de las páginas.
Las remisiones dejan de necesitar dos pasadas.
El idioma de los rótulos.
Pregunta 9En el documento principal de una tesis, ¿qué distingue \include{capitulo1} de \input{capitulo1}?
\include empieza el contenido en una página nueva y permite compilar solo algunos capítulos con \includeonly; \input inserta el archivo tal cual, en el punto donde se escribe.
Nada: son sinónimos.
\input solo admite archivos del preámbulo.
\include copia el archivo dentro del principal al guardar.
Pregunta 10El preámbulo de una tesis contiene \includeonly{capitulo3}, y el cuerpo incluye los cinco capítulos con \include. ¿Qué produce la compilación, si la tesis ya se había compilado entera antes?
Un PDF con solo el capítulo 3, que conserva sus números de página, de capítulo y de remisión, tomados de los auxiliares de los demás.
Un PDF con los cinco capítulos, porque \includeonly solo afecta al índice.
Un PDF con solo el capítulo 3, numerado como capítulo 1 y desde la página 1.
Un error, porque faltan los demás capítulos.
Pregunta 11Un preámbulo contiene \newcommand{\emph}[1]{\textbf{#1}}. ¿Qué ocurre?
El motor produce el error «Command \emph already defined»: \newcommand no redefine instrucciones existentes, y para eso existe \renewcommand.
Todos los énfasis pasan a negrita.
Se crea una segunda instrucción \emph, que convive con la original.
Nada, porque el preámbulo no compone texto.
Pregunta 12Con \newcommand{\unidad}[2]{#1~#2} en el preámbulo, ¿qué imprime \unidad{5}{km}?
«5 km», con un espacio en el que la línea no puede cortarse.
«km 5».
«5~km», con la tilde impresa.
Un error, porque una instrucción solo admite un argumento.