\documentclass[a4paper, 11pt]{article}
\usepackage[latin1]{inputenc}
\title{Curso de \LaTeX{} \\ Curso 2 : un documento ``del mundo real''}
\author{Isabelle HURBAIN \\ isabelle.hurbain@free.fr \\ \\ Traducción por \\ Jorge Bernal "Koke" \\ koke@sindominio.net}
\begin{document}
\maketitle
\tableofcontents
\section{Los diferentes tipos de documentos}

En el curso 1, hicimos un documento "Hola, mundo", con solamente un título y un "Hola, mundo!". Ahora veremos como hacer un documento ``de verdad''.

Hay tres tipos usados mayoritariamente: libro (book), informe(report) y artículo (article). Hay otras dos clases, llamadas diapositivas (slides) y cartas (letters), pero no hablaremos de ellas aun.

\verb+article+ es para artículos en revistas, documentación de programas,...

\verb+report+ es para informes con varios capítulos o partes.

\verb+book+ es para libros.

La regla que uso (no es una regla general, sino algo más personal) es usaer la clase article por debajo de 6-8 páginas, report entre 8 y 50 páginas y book para más de 50 páginas. No hace falta que diga que prácticamente nunca uso book.

\section{Acentos y saltos de línea}

Cuando comencé a usar \LaTeX{}, lo primero que me sorprendió fue "?`por qué no se muestran mis acentos?" y "?`cómo hago un salto de línea?"

Se puede conseguir acentos añadiendo la línea
\begin{verbatim}
\usepackage[latin1]{inputenc}
\end{verbatim}
en el preámbulo del documento.

y para saltar de línea, saltaremos dos veces, de la siguiente manera

\begin{verbatim}
Esto es un salto de línea 
que no funciona.

Pero éste funciona.

Aquí está la prueba.
\end{verbatim}

Para editar un documento en otro lenguaje distinto del inglés, se puede usar también el paquete babel. Babel gestiona las redefiniciones de títulos (para obtener "Capítulo" en lugar de "Chapter" en un documento en español, por ejemplo) y algunas reglas tipográficas (como la tabulación de comienzo de sección, existente en francés pero no en inglés).

Para usar el paquete Babel, hay que añadir en el preámbulo
\begin{verbatim}
\usepackage[lenguaje]{babel}
\end{verbatim}
donde \verb+lenguaje+ es el lenguaje del documento. Por ejemplo, podemos usar
\begin{verbatim}
\usepackage[french]{babel}
\end{verbatim}
en francés
\begin{verbatim}
\usepackage[spanish]{babel}
\end{verbatim}
en español.

\section{COMO hacer un documento ``real''}
Un documento genérico contendría un título, una tabla de contenidos, una introducción, varias secciones, una conclusión y apéndices. Las diferentes partes pueden contener subsecciones.

\subsection{El título}
El título se define para todo el documento. Sus parametros se dan en el preámbulo del documento (después de \verb+\begin{document}+ con los comandos \verb+\title+, \verb+\author+ y \verb+\date+. Estos comandos toman un único argumento (entre las llaves \verb+{}+).

Como debes suponer, \verb+\title+ define el título, \verb+\author+ define el/la autor/a (en la mayoría de los casos tú misma/o) y \verb+\date+ define la fecha de escritura o publicación del documento.

Si se omite \verb+\date+, la fecha será la de la última compilación. Para prevenir este comportamiento se puede usar \verb+\date{}+ para definir una fecha vacía.

Una vez que los parámetros están en el preámbulo, simplemente se inserta \verb+\maketitle+ seguido de \verb+\begin{document}+ para mostrar el título.

El título ocupará una página para las clases \verb+report+ y \verb+book+, y estará al comienzo de la primera página en la clase \verb+article+.

\subsection{Los comandos de secciones}
Hay 6 comandos de secciones en un artículo (en order jerárquico):

\begin{itemize}
\item \verb+\part+
\item \verb+\section+
\item \verb+\subsection+
\item \verb+\subsubsection+
\item \verb+\paragraph+
\item \verb+\subparagraph+
\end{itemize}

Report y book también tienen un comando \verb+\chapter+ , entre part y section.

Estos comandos tienen un argumento, el título del elemento de sección. Puede tener también un argumento opcional (entre corchetes \verb+[ ]+). Este argumento define un título alternetivo, por ejemplo para la tabla de contenidos.

Estos comandos gestionan el estilo del título y su numeración. Así pues, si tenemos una sección foo antes de una sección bar y si decidimos más tarde que bar tiene que ir antes de foo, simplemente tendremos que mover nuestra sección. \LaTeX{} se encarga de numerar las secciones (y las subsecciones) y de actualizar la tabla de contenidos. ¿Acaso no es fantastico?

\subsection{La tabla de contenidos}
La tabla de contenidos se puede obtener mediante \verb+\tableofcontents+. Muestra, en orden de aparición, un título y número de página para cada comando de sección menor que \verb+tocdepth+. \verb+tocdepth+ es una variable interna, que corresponde a los siguientes valores :

\begin{table}[!h]
\begin{center}
\begin{tabular}{|c|c||c|c|}
\hline
\verb+\part+ (book and report) & -1 & \verb+\part+ (article) & 0 \\
\hline
\verb+\chapter+ (book and report) & 0 & \verb+\section+ & 1 \\
\hline
\verb+\subsection+ & 2 & \verb+\subsubsection+ & 3 \\
\hline
\verb+\paragraph+ & 4 & \verb+\subparagraph+ & 5 \\
\hline
\end{tabular}
\end{center}
\end{table}

La profundidad de la tabla de contenidos se puede cambiar mediante \verb+\setcounter{tocdepth}{n}+ donde n es el nivel de profundidad deseado.

Para actualizar una tabla de contenidos después de haber modificado algo en las secciones, hay que ejecutar \verb+latex+ dos veces sobre el documento. ¿Por qué? De hecho, \LaTeX{} mantiene un archivo separado para la tabla de contenidos, el archivo \verb+.toc+. En la primera compilación, este archivo se actualiza y, en la segunda, el documento \verb+.dvi+ se actualiza.

\subsection{Los comandos estrellados}
Los llamados comandos estrellados son \verb+\chapter*+, \verb+\section*+, etc. Son comandos de sección, pero un tanto especiales. No actualizan la tabla de contenidos, no están numerados y no actualizan el contador de capítulo, seccion, etc.

Entoces, ¿dónde reside su interés? Son principalmente usados para introducción y conclusión. La introducción, por ejemplo, rara vez es llamada "Capítulo 1 - Introducción" en un libro.

Puede que queramos que nuestra introducción no esté numerada (así que usaríamos el comando estrellado) pero que sí aparezca en la tabla de contenidos (así que no lo usarías).

Para conseguir esto, podemos hacer algo asi :
\begin{verbatim}
\chapter*{Introducción}
\addcontentsline{toc}{chapter}{\numberline{}Introducción}
\end{verbatim}

La primera línea crea el título de la introducción, sin numerar como queríamos.

La segunda línea añade una línea en la tabla de contenidos para crear la entrada "Introducción".

El mismo truco se puede usar para la conclusión.

\subsection{Los apéndices}

Para definir que dejamos el documento "plano" y empezamos a escribir apéndices, simplemente usamos \verb+\appendix+. Esto pone los contadores de sección a 0 y cambia el sistema de numeración a alfabético. También redefine, para book y report, el título de los capítulos de "Capítulo" a "Apéndice". Así que si creamos un capítulo \verb+foo+ después del comando \verb+\appendix+, tendremos "Apéndice A  foo" como título en lugar de "Capítulo n+1  foo".

Los apéndices también aparecen en la tabla de contenidos.

\section{Ejercicio}
Ahora tienes todas las instrucciones necesarias para crear un documento básico. Prueba a crear uno, experimenta los comandos aprendidos y disfruta ;-)

No intentes modificar el aspecto de lo que obtienes de momento. Recuerda, \LaTeX{} usa un lenguaje orientado al contenido (lenguaje lógico), no un lenguaje orientado a la forma. Si quieres hacer un capítulo, no lo pongas como una \verb+part+ sólo porque te guste más como queda - veremos como modificar la definición de capítulo si es necesario. Pero, si la estructura lógica de tu documento requiere un capítulo, usa \verb+\chapter+. También tiene la ventaja de hacerte pensar más detenidamente en la estructura de tu documento y, en consecuencia, a hacer documentos más claros. Y eso simplifica el mantenimiento de tu trabajo.

\section{En la siguiente entrega}

En la siguiente entrega hablaremos acerca de tablas e imágenes y de cómo integrarlas en un documento.
\end{document}
