Estructura de un documento L A TEX. \documentclass. Clases de documentos. 29 de noviembre de 2007

Transcripción

1 Índice Estructura de un documento L A TEX 1 Estructura del fichero fuente Diego Cazorla Juan José Pardo 2 Estructura lógica de un documento. Departamento de Sistemas Informáticos 3 Partes de documento 29 de noviembre de 2007 \documentclass Clases de documentos La primera información que L A TEX necesita conocer para procesar un fichero fuente es el tipo de documento que el autor quiere crear. \documentclass[options]{class} donde: class: clase de documento (p. ej. book, report) options: parámetros opcionales de la clase (p. ej. 11pt, a4paper, twocolumn) Si no indicamos ninguna opción se utilizarán las opciones por defecto de la clase indicada. Hay cuatro clases principales: article: artículos de revistas científicas, informes técnicos, documentación de programas,. report: informes largos que contienen varios capítulos, pequeños libros, proyectos,... book: libros frames: trasparencias, presentaciones. Además, cada usuario tiene la posibilidad de definir su propia clase de documento, por ejemplo llncs: formato de Lecture Notes in Computer Science. elsart: formato de Elsevier Science. beamer: formato de este documento.

2 Opciones de una clase \usepackage 10pt, 11pt, 12pt: tamaño de la fuente. a4paper, letterpaper, : tamaño del papel. fleqn: muestra las fórmulas alineadas a la derecha en lugar de centradas. leqno: coloca los números de las fórmulas a la izquierda en lugar de a la derecha. titlepage, notitlepage: indica si debe existir una página separada con el título. onecolumn, twocolumn: texto formateado en una o dos columnas oneside, twoside: para imprimir a una o dos caras. openright, openany: cada capítulo empieza en las páginas derechas o en la siguiente página disponible. Un paquete (package) permite extender las capacidades de L A TEX, tales como incluir gráficos incluir texto coloreado incluir soporte para diferentes idiomas El comando necesario para utilizar un paquete es: \usepackage[options]{package} Pueden incluirse tantos paquetes como sea necesario Algunos paquetes Cuerpo del documento babel: soporte para diferentes idiomas: \usepackage[spanish]{babel} inputenc: código de caracteres usado en el documento fuente: \usepackage[latin1]{inputenc} graphicx: permite incluir gráficos EPS, rotar y escalar textos y gráficos, etc. color: permite incluir texto coloreado. latexsym: pemite utilizar ciertos símbolos matemáticos que no están en L A TEX básico. pstricks: inclusión de gráficos pstricks hyperref: inclusión de referencias en un documento. Una vez que hemos indicado que clase de documento utilizaremos y que paquetes necesitamos (lo que llamamos el preámbulo), podemos comenzar el documento. Aquí introduciremos el texto de nuestro documento El documento finaliza mediante:

3 Ejemplo de estructura División del fichero fuente: \include \documentclass{article} \usepackage[spanish]{babel} \usepackage{latexsym, graphicx, color} texto del documento En documentos largos puede ser conveniente dividir el fichero fuente en varios ficheros. Para ello utilizaremos en el cuerpo del texto \include{fichero} El texto del fichero comienza siempre en una nueva página. Además, en combinación con \includeonly{fichero1,fichero2} podemos hacer que sólo se procesen los ficheros indicados. División del fichero fuente: \input Ejemplo de división Una alternativa a \include es utilizar \input{fichero} \documentclass{book} \usepackage[spanish]{babel} \usepackage{latexsym,graphicx,color} \includeonly{capitulo2,capitulo3} La diferencia es que este fichero siempre se considera al componer el documento y no hace que el texto comience en una nueva página. \input{prologo} \include{capitulo1} \include{capitulo2} \include{capitulo3} \include{capitulo4}

4 Organización del texto Otros elementos Las clases estándar L A TEX contienen comandos y entornos que permiten definir una cierta organización dentro de un texto. Así, un documento puede contener: Parte: \part Capítulo: \chapter Apéndice: \appendix, \chapter Sección: \section Subsección: \subsection Subsubsección: \subsubsection Párrafo: \paragraph Subpárrafo: \subparagraph Además, pueden aparecer otros apartados como son: Título: \maketitle Tabla de contenidos: \tableofcontents Lista de figuras: \listoffigures Lista de tablas: \listoftables Bibliografía: \bibliography{fichero} índice de materias (glosario): \makeindex Partes de un texto (clase book) Ejemplo de estructura lógica En la clase book, todos los elementos indicados pueden, a su vez, asociarse a tres partes fundamentales del texto, como son: \frontmatter (principio): título, tabla de contenidos, listas de figuras, lista de tablas. \mainmatter (cuerpo): cuerpo principal del texto \backmatter (final): bibliografía, glosario. El principio se numera por defecto con número romanos. El cuerpo y el final se numeran consecutivamente con números arábigos comenzando por 1. \documentclass{book} \usepackage[spanish]{babel} \usepackage{latexsym,graphicx,color} \frontmatter titulo,tabla de contenidos, \mainmatter cuerpo del texto (partes,capitulos,secciones) \backmatter apendices, bibliografia,glosario

5 Elementos del principio Título Son parte del principio del documento: Título: \maketitle Tabla de contenidos: \tableofcontents Lista de figuras: \listoffigures Lista de tablas: \listoftables Un título se compone de tres elementos: Nombre del documento: \title{nombre} Autores: \author{autor 1 \and Autor 2} Fecha: \date{fecha} ó \date{}. Si no aparece el comando \date por defecto se utiliza la fecha de hoy. Una vez definidos cada uno de los campos del título, el comando \maketitle lo genera y lo muestra en el documento. Tabla de contenidos Lista de figuras Se genera automáticamente mediante el comando \tableofcontents Se genera automáticamente mediante el comando \listoffigures Utiliza la organización del texto en capítulos, secciones, etc, para obtener un índice del documento. Utiliza la información indicada en el comando \caption que aparece en las figuras del documento (entorno figure ). Es necesario componer dos veces el documento para obtener la tabla de contenidos: en la primera, se crea el fichero.toc en la segunda, se incluye en el documento. Es necesario componer dos veces el documento para obtener la tabla de contenidos: en la primera, se crea el fichero.lof en la segunda, se incluye en el documento.

6 Lista de tablas Ejemplo de principio Se genera automáticamente mediante el comando \listoftables Utiliza la información indicada en el comando \caption que aparece en las tablas del documento (entorno table). Es necesario componer dos veces el documento para obtener la tabla de contenidos: en la primera, se crea el fichero.lot en la segunda, se incluye en el documento. \documentclass{book} \usepackage{} \frontmatter \title{the \LaTeX{} Companion} \author{m. Goossens \and F. Mittelbach \and A. Samarin} \date{mayo 1994} \maketitle \tableofcontents \listoffigures \listoftables Partes Capítulos \part{nombre de la parte} Permite dividir un documento muy largo (p. ej. un libro) en varias partes que constituye una unidad. Su apariencia depende de la clase de documento utilizada: book: se crea una página aparte. article: aparece en la misma página que el texto que le rodea. Las partes se numeran mediante números romanos. No influyen en la numeración de los capítulos. Crea una entrada en la tabla de contenidos. \chapter{nombre del capítulo} Permite dividir el texto en capítulos. No está permitido su uso en la clase article Los capítulos se numeran mediante números arábigos. Crea una entrada en la tabla de contenidos. El nombre del capítulo puede aparecer en la cabecera o el pie de página.

7 Secciones Subsecciones \section{nombre del capítulo} \subsection{nombre de la subsección} Permite dividir el texto en secciones. Su numeración depende de la clase de documento: article: números arábigos comenzando por 1 book: se numeran dentro del capítulo con el formato capitulo.sección Crea una entrada en la tabla de contenidos. El nombre de la sección puede aparecer en la cabecera o el pie de página. Similar a la sección pero un nivel por debajo. Es necesario que aparezcan dentro del entorno de una sección. Su numeración depende también de la clase del documento. article: formato sección.subsección book: formato capitulo.sección.subsección Los comandos \subsubsection, \paragraph y \subparagraph son similares pero un nivel más abajo en la jerarquía cada uno de ellos. Apéndices Ejemplo de cuerpo Un apendice es simplemente un capítulo que aparece tras el comando \appendix \chapter{ultimo capítulo} \appendix \chapter{primer apéndice} Capítulo 5 Último capítulo... Apéndice A Primer apéndice \documentclass{book} \mainmatter \part{primera parte} \chapter{primer capítulo} \section{punto 1.1} \subsection{punto 1.1.1} \subsection{punto 1.1.2} \appendix \chapter{apéndice A} \section{punto A.1} \subsection{punto A.1.1}

8 Opciones Niveles Algunos de los comandos indicados (\chapter, \section), admiten dos variantes: \section[nombre alternativo]{nombre}. Permite definir un nombre alternativo al nombre real de la sección. El nombre alternativo aparecerá en las cabeceras y en la tabla de contenidos. Es útil cuando el nombre de la sección es demasiado largo. \section*{nombre}. Las versiones con asterisco no son numeradas y no aparecen en la tabla de contenidos. Permiten, p.ej., incluir una sección Prólogo al comienzo de un libro: \section*{prólogo} Cada uno de los elementos que permite organizar un texto tiene asociado un número de nivel dentro de la jerarquía del documento: \part (book y report) -1 \part (article) 0 \chapter 0 \section 1 \subsection 2 \subsubsection 3 \paragraph 4 \subparagraph 5 Niveles y TdC Bibliografía Existe una variable ó contador que indica hasta que nivel debe aparecer la información en la Tabla de Contenidos. El nombre de este contador es tocdepth. Este contador tiene un valor por defecto para cada clase de documento, que puede ser modificado mediante \setcounter{tocdepth}{nivel} P. ej., \setcounter{tocdepth}{2} hace que aparezcan en la tabla de contenidos las partes, los capítulos, las secciones y las subsecciones. El elemento principal de la parte final de un documento es la bibliografía. Ésta se genera automáticamente utilizando los comandos \bibliography{fichero.bib} \bibliographystyle{estilo} El fichero.bib es una base de datos que contiene todas las referencias que habitualmente maneja el autor. El estilo indica el aspecto que presentará la bibliografía en el documento.

9 Bibliografía Índice de materias Únicamente se incluyen en la bibliografía las referencias que se haya citado en el texto mediante el comando \cite{nombre de referencia} Ésto permite una consistencia entre las referencias citadas y aquellas que aparecen en la bibliografía, sin necesidad de que el autor del documento tenga que preocuparse de ello. L A TEX permite generar automáticamente un glosario en el que aparece cada palabra clave del documento con indicación de las páginas en las que se hace referencia a él. Los comandos necesarios son \makeindex \index{palabra} \printindex Nota: El formato del fichero fichero.bib y el procedimiento necesario para generar la bibliografía se verá en el tema dedicado exclusivamente a Bibliografía.