Manual de Kile

Jonathan Pechta Federico Zenith Holger Danielsson Thomas Braun Michel Ludwig Felix Mauch Traductor: Ral Gonzlez Traductor: Rafael Rodrguez Martn Traductor: Santiago Fernndez Traductora: Kira J. Fernndez

Manual de Kile

ndice general
1. Prefacio 1.1. Requisitos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2. Personas a quienes va dirigido este documento . . . . . . . . . . . . . . . . . . . . . 2. Introduccin 2.1. Aspectos bsicos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1. Sobre Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.2. Kile y el componente de edicin de Kate . . . . . . . . . . . . . . . . . . . . 2.1.3. Qu es LA TE X? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.4. Cmo se pronuncia? Por qu esa escritura tan extraa? . . . . . . . . . . . 2.2. LA TE X 101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3. Principales caractersticas de Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.1. Asistente de inicio rpido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.2. Plantillas predenidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.3. Resaltado de sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.4. Autocompletado de entornos . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.5. Saltar a un elemento de estructura . . . . . . . . . . . . . . . . . . . . . . . . 2.3.6. Bsqueda inversa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.3.7. Bsqueda directa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.4. La barra de herramientas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. Inicio rpido 3.1. Escribiendo un documento 3.2. Entornos . . . . . . . . . 3.3. Utilizando Kile . . . . . 3.4. Archivos DVI . . . . . . 3.4.1. Ver un DVI . . . 3.4.2. Imprimir un DVI . . . . . LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . con Kile para principiantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1 2 2 2 2 2 2 3 3 3 4 4 4 5 5 5 5 9 9 10 10 11 11 11 11 11 11 12

3.4.3. Convertir archivos DVI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.5. Bsqueda hacia delante entre Kile y Okular . . . . . . . . . . . . . . . . . . . . . . . 3.6. Bsqueda inversa entre Kile y Okular . . . . . . . . . . . . . . . . . . . . . . . . . . 3.7. Resolviendo errores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Manual de Kile

4. Comenzando un nuevo documento 4.1. Plantillas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.1. Crear una nueva plantilla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.2. Congurando las sustituciones automticas . . . . . . . . . . . . . . . . . . 4.1.3. Crear una plantilla desde el asistente . . . . . . . . . . . . . . . . . . . . . . 4.1.4. Crear una plantilla desde cualquier archivo . . . . . . . . . . . . . . . . . . . 4.1.5. Eliminando una plantilla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5. Editando documentos LA TE X 5.1. Manual de referencia de LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.2. 5.3. 5.4. 5.5. 5.6. Movimientos del cursor Parntesis . . . . . . . . Resaltado . . . . . . . . . Marcas . . . . . . . . . . Seleccionar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13 13 14 14 14 14 15 16 16 16 17 17 17 17 18 19 19 20 21 21 22 23 23 23 25 26 26 26 26 27 27 28 28 28 30 31 32 32 36

5.6.1. Seleccionar rdenes de LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . 5.7. Borrar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.8. Entorno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.9. Grupo TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.10. Comillas dobles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.11. Nueva lnea inteligente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.12. Tabulador inteligente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. Completado de cdigo 6.1. Completado automtico de entornos . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.2. rdenes LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.3. Entornos . . . . . . . . . . 6.4. Abreviaturas . . . . . . . . 6.4.1. Abreviaturas . . . 6.5. Modos de autocompletado . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6.5.1. rdenes LA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.5.2. Palabras de documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6.6. Escribir los propios archivos de completado . . . . . . . . . . . . . . . . . . . . . . . 7. Asistentes y dilogos 7.1. Asistente de inicio rpido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.2. Incluir grcos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.3. Matrices y tablas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.4. Insertar elementos otantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.5. Insertar entornos matemticos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.6. Utilidades PostScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7.7. Estadsticas del documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Manual de Kile

8. Etiquetas especiales en LA TE X 8.1. Utilizando la librera de etiquetas de LA TE X . . . . . . . . . . . . . . . . . . . . . . . 8.2. Utilizando Bibitems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3. Etiquetas denidas por el usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.3.1. Localizadores en etiquetas denidas por el usuario . . . . . . . . . . . . . . 9. Las herramientas de construccin 9.1. Compilar, convertir y ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.1. BibTE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.2. MetaPost and Asymptote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.3. PDFLA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.4. LA TE X para Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.1.5. Pasar parmetros en lnea de rdenes . . . . . . . . . . . . . . . . . . . . . . 9.2. Vista previa rpida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.2.1. 9.2.2. 9.2.3. 9.2.4. Modo de seleccin . . . . Modo entorno . . . . . . . Modo subdocumento . . . Modo grupo matemtico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

37 37 39 40 41 42 42 42 42 42 43 43 43 44 44 45 45 45 45 45 45 46 47 47 47 48 48 49 49 50 51 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 51 53 53

9.2.5. Vista previa rpida en la barra inferior . . . . . . . . . . . . . . . . . . . . . . 9.3. Formatos de archivos grcos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.1. LA TE X y PDFLA TE X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.2. Conversin de grcos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.3.3. Utilizar el archivo adecuado para cada imagen . . . . . . . . . . . . . . . . . 9.4. Grcos EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.4.1. LA TE X y los grcos EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.4.2. El PostScript a travs de Kile . . . . . . . . . . . . . . . . . . . . . . . . . . 9.4.3. El PostScript a travs de los grcos de mapas de bits . . . . . . . . . . . . 9.4.4. PDFLA TE X y los grcos EPS . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.5. Documento maestro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.6. Manejo de errores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9.7. El modo de vigilar archivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10. Navegando por el cdigo fuente LA TE X 10.1. Utilizando la vista de estructura . . . . . . 10.1.1. Usando el men contextual . . . . 10.1.2. Actualizando la vista de estructura 10.2. Marcadores . . . . . . . . . . . . . . . . .

Manual de Kile

11. Proyectos 11.1. Trabajando con proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.2. Creando un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.3. La vista de archivos y proyectos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.4. Aadir y eliminar archivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.4.1. Guardar su proyecto en un archivo comprimido . . . . . . . . . . . . . . . . 11.5. Opciones del proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.6. Cerrando un proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12. Codicacin del documento 12.1. El paquete ucs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.2. XeLaTeX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.3. Soporte CJK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.3.1. Problemas con CJK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12.3.2. Cmo puedo hacer entradas CJK en Unicode? . . . . . . . . . . . . . . . . . 13. Crear guiones 13.1. Guiones en Kile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13.2. Referencia del API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14. Ayuda 14.1. Documentos de ayuda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.2. Ayuda sensible al contexto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.3. Buscando palabras clave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14.4. Ayuda denida por el usuario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15. Crditos y licencia

54 54 54 55 55 56 56 57 58 59 59 59 60 61 62 62 62 64 64 64 65 66 69

Resumen Kile es un editor de archivos de fuentes y un intrprete de rdenes de LA TE X y TE X.

Manual de Kile

Captulo 1

Prefacio
1.1. Requisitos

Para ejecutar Kile se requiere que tenga instalados los siguientes componentes en su sistema: Entorno de escritorio K (KDE): KDE es un popular entorno de escritorio de cdigo abierto. Qt: Qt es una biblioteca de red e interfaces grcas de usuario en C++ necesaria para compilar Kile. LATEX: programa de composicin de textos de alta calidad. Lo ms seguro es que quiera el paquete TeX Live (o teTE X en los sistemas antiguos), si est en un sistema de tipo Unix. Algunos de estos elementos podran estar incluidos en su distribucin Linux. Consulte la documentacin de su distribucin, o el CD o DVD de instalacin, para aadir estos paquetes a su sistema. Kile puede estar ya tambin disponible como un paquete precompilado para su distribucin Linux. Por favor, comprubelo con el gestor de paquetes de su distribucin.

1.2.

Personas a quienes va dirigido este documento

Este manual puede ser utilizado por cualquier persona, independientemente de su experiencia con LA TE X, KDE, Kile o Linux. No se espera que los usuarios avanzados lean este manual, pero se agradecer cualquier sugerencia sobre la documentacin. Si desea contribuir con este proyecto o con la documentacin, consulte la pgina web ocial de Kile. Necesita respuestas sobre Kile? Se ha atascado en el proceso de compilacin? Deseara ver una nueva funcionalidad? La mejor manera de plantear cuestiones tcnicas o comenzar un debate es utilizar nuestra lista de correo: kile-devel@lists.sourceforge.net.

Manual de Kile

Captulo 2

Introduccin
2.1.
2.1.1.

Aspectos bsicos
Sobre Kile

Kile es un entorno integrado de LA TE X para el escritorio KDE. Kile le proporciona la habilidad de utilizar todas las funcionalidades de LA TE X con una interfaz grca, proporcionndole un acceso sencillo, inmediato y personalizado a todas las herramientas para la compilacin, procesamiento, depuracin, conversin y visualizacin de LA TE X. Tambin ofrece prcticos asistentes, una referencia de LA TE X, y potente administracin de proyectos.

2.1.2.

Kile y el componente de edicin de Kate

Kile est basado en el componente de edicin de Kate, as que muchas capacidades proceden del propio componente de edicin de Kate y Kile extiende estas capacidades para editar documentos de LA TE X. Para aprender ms acerca de Kate y sus capacidades, consulte la Kate pgina web.

2.1.3.

Qu es LA TE X?

LA TE X es un sistema de procesamiento de textos derivado de TE X, un programa desarrollado originalmente en 1977 por Donald Knuth para ayudar a los autores a confeccionar su trabajo profesionalmente, obteniendo algo similar a lo producido por un tipgrafo. El tipgrafo es el profesional que proporciona el estilo visual a un documento de acuerdo con las especicaciones para ese tipo de documento. LA TE X fue creado por Leslie Lamport para proporcionar a los autores un tipgrafo automtico, especialmente cuando se trataba de la costosa y dolorosa escritura de frmulas y expresiones matemticas, que estn encerradas entre signos de dlar en LA TE X por un motivo. Hoy en da, los procesadores de textos permiten a cualquier usuario ser el tipgrafo, pero lo que usted muchas veces quiere es un documento que se vea bien, no uno en el que tenga que invertir horas en darle forma. LA TE X se toma esas molestias, y le permite concentrarse en el documento, no en su confeccin. Y s, el documento se ver bien!

2.1.4.

Cmo se pronuncia? Por qu esa escritura tan extraa?

Hay una curiosa tradicin de que los paquetes relacionados con TE X tengan la pronunciacin y escritura lo ms raras posibles. Se supone que TE X proviene del griego , o tech en letras 2

Manual de Kile

latinas. Hay muchas explicaciones del porqu, pero lo ms seguro es que sea porque LA TE X fue originalmente concebido para informes tcnicos, y de ah que su principal punto fuerte fuera la correccin y facilidad en la escritura de frmulas matemticas, que por aquellos tiempos era una tarea cara, larga y frustrante. Se supone que se pronuncia as: T como en espaol, E como en espaol, y X como en la ch alemana. Si no sabe cmo suena esta ch, se parece al siseo de un gato. El smbolo de la IPA que lo representa es //. Mucha gente dice que se pronuncia como la h aspirada (smbolo IPA /x/), pero segn algunos griegos, la primera versin es la correcta. Debe tener en cuenta que mucha gente lo pronuncia mal (/teks/ o /tek/). Por ltimo, en LA TE X la primera LA se pronuncia como la palabra inglesa lay: la idea es que, aunque TE X por s solo es difcil, incluso un lego puede utilizar las macros de LA TE X. Una explicacin menos inspirada pero ms realista es que proviene del apellido de Leslie Lamport, el creador de LA TE X. Ahora ya lo sabe!

2.2.

LA TE X 101

El sistema de composicin de textos LA TE X es similar a otros lenguajes de marcas como XML, utilizados para muchos tipos de documentos (incluyendo el que usted est leyendo), o HTML, empleado para pginas web. La idea general es tener un conjunto de palabras especiales, llamadas etiquetas, que le dicen al programa (un procesador de textos, un navegador, o el compilador de LA TE X) cmo presentar el texto. Kile le ofrece un buen nmero de esas etiquetas en el men LaTeX de la barra de men. Si bien intentaremos darle una buena idea de lo que es LA TE X, este no es el Libro Denitivo sobre LA TE X. Si desea profundizar en el aprendizaje de LA TE X, debera comprar un libro especializado en alguna librera cercana. Al igual que otros lenguajes de marcas, LA TE X contiene un prembulo, que especica rdenes globales, como el tamao del papel, la numeracin de las pginas y las dimensiones del texto en la pgina, y un cuerpo que contiene el texto del documento. El prembulo tiene que contener al menos la orden \documentclass, y precede al cuerpo, que comienza con la orden \begin{docu ment}, y concluye con la orden \end{document}.

2.3.
2.3.1.

Principales caractersticas de Kile

Asistente de inicio rpido

El asistente integrado con Kile es una estupenda caracterstica para introducirle en la creacin de documentos con Kile de una forma rpida. Eligiendo el asistente en la barra de mens se le proporcionan diversas opciones para la creacin de su documento: artculo, libro, carta, informe, o documento vaco. Tambin puede especicar algunas opciones relacionadas con el propio documento. Opciones de clase: Clase de documento: elija el documento que desea crear: artculo, libro, carta, informe, scrartcl, scrreprt, scrbook, prosper, beamer u otro denido por usted mismo. Tamao del tipo de letra: indica a Kile qu tamao (pt) punto desea utilizar. Tamao del papel: selecciona el tamao o estilo de las hojas. Codicacin: En general es una buena idea utilizar la codicacin estndar de su sistema. Cada vez ms sistemas modernos se pasan a UTF-8 como sistema de codicacin estndar. Si puede, utilice utf8 o utf8x (que es, en efecto, la grafa correcta para los documentos de LA TE X). 3

Manual de Kile

Otras opciones: permite aadir otras opciones para la impresin, borradores y otras. Paquetes Lista algunos de los paquetes adicionales ms comunes utilizados en LA TE X. Marque la casilla para incluirlos. Propiedades del documento Autor: escriba su nombre aqu. Ttulo: aada el ttulo de su documento aqu. Fecha: especique la fecha.

2.3.2.

Plantillas predenidas

Las plantillas predenidas en Kile son: Documento vaco: los ms fanticos comienzan desde cero! Artculo: selecciona el formato de artculo, para un documento sucientemente corto como para no estar dividido en captulos. Informe: selecciona el formato de informe, para un documento de tamao medio, con, por ejemplo, numeracin de pginas en el borde exterior de estas. Libro: selecciona el formato de libro, una opcin tan potente que es utilizada para escribir muchos libros de texto universitarios. Letra: establece el formato de letra. Beamer,HA-Prosper: crea bonitas presentaciones en PDF con un aspecto superior y toda la potencia de LA TE X. Powerdot: Powerdot es la continuacin de los paquetes seminar y HA-Prosper. No tiene tantas opciones como Beamer, pero es fcil de usar y crea unas presentaciones muy bonitas en PDF. Scrartcl, Scrbook, Scrreprt, Scrlttr2: Las clases de documento de KOMA-Script, especialmente adaptados a la tipografa alemana. Utilcelas si escribe textos en alemn. Xelatex: una plantilla modicada de artculo para usar con XeLaTeX. Tenga en cuenta que todas estas plantillas se pueden ajustar a los requerimientos del usuario. Los nuevos usuarios no deben preocuparse: esta lista solo es una breve descripcin de las caractersticas disponibles. Se puede encontrar una descripcin ms detallada en captulo 3.

2.3.3.

Resaltado de sintaxis

Kile es similar a otros programas que tratan con cdigo fuente y edicin, y resaltar automticamente las rdenes, opciones y elementos utilizados (y sobreutilizados). Kile hace posible detectar fcilmente reas problemticas: por ejemplo, si ve un gran espacio de texto de color verde, seguramente se haya olvidado de cerrar un entorno matemtico en alguna parte.

2.3.4.

Autocompletado de entornos

El autocompletado de entornos signica que cuando comienza un nuevo entorno escribiendo \ begin{environment}, Kile automticamente aadir una orden \end{environment}, con una lnea en medio para su texto. Por supuesto, puede desactivarlo si as lo desea en Preferencias Congurar Kile...+LaTeX. 4

Manual de Kile

2.3.5.

Saltar a un elemento de estructura

Todos los documentos suelen estar estructurados en una jerarqua de algn tipo. LA TE X le permite dividir los documentos en las siguientes jerarquas (siendo parte la ms alta en la jerarqua, y subprrafo la ms baja): \part (parte) \chapter (captulo) \section (seccin) \subsection (subseccin) \subsubsection (subsubseccin) \paragraph (prrafo) \subparagraph (subprrafo) Mientras est viendo un documento en la vista de Estructura, puede saltar entre elementos pulsando en el elemento que le gustara ver.

2.3.6.

Bsqueda inversa

Cuando crea su propio archivo LA TE X, la bsqueda inversa puede serle muy til. Una vez creado un archivo DVI (DeVice Independent File -archivo independiente del dispositivo-), cuando pulsa en el botn central del ratn en el visor DVI, Kile saltar a la lnea correspondiente en el cdigo fuente de LA TE X. Un DVI es un tipo de archivo que contiene una descripcin de un documento con formato, as como otra informacin incluyendo el tipo de letra de los caracteres, y junto con el PDF es la salida usual de TE X o LA TE X. Existen diversas utilidades para ver, convertir e imprimir archivos DVI en varios sistemas y dispositivos.

2.3.7.

Bsqueda directa

Cuando se usa la bsqueda inversa, la seleccin de elementos en el archivo DVI est asociada con el editor, as que cuando pulse sobre el archivo DVI, la ventana principal saltar a la correspondiente seccin de cdigo LA TE X en el editor. La bsqueda directa es exactamente lo contrario, pues le permitir pulsar en una seccin especca de texto en el cdigo LA TE X, y saltar a la posicin asociada en la ventana del visor.

2.4.

La barra de herramientas

Nuevo: comienza un nuevo documento. Abrir: abre un nuevo documento. Cerrar: cierra su documento. Denir el documento actual como documento maestro: Se emplea cuando se trabaja con varios archivos. Tener un documento maestro le permitir incluir otros archivos .tex en su documento. Si est utilizando proyectos, tambin puede establecer un proyecto completo como documento maestro en Proyecto-> Opciones de proyecto.

Manual de Kile

Generacin rpida: compila su cdigo fuente LA TE X y muestra los resultados automticamente, a menos que el documento contenga errores. Modo de vigilar archivo: este modo vigilar el archivo DVI para ver si cambia, y no ejecutar una nueva instancia de Okular despus de Generacin rpida. Ver archivo de registro: muestra el archivo .log, para que pueda examinar los errores. Error anterior: salta hacia atrs en el archivo .log y resalta los errores en el cdigo fuente. Siguiente error: salta hacia adelante en el archivo .log y resalta los errores en el cdigo fuente. Detener: detiene la herramienta actual. LaTeX: ejecuta LA TE X en el documento activo. Ver DVI: ejecuta el visor DVI. DVI a PS: convierte el archivo DVI en PostScript (PS). Ver PS: ejecuta el visor PostScript (PS). PDFLaTeX: ejecuta PDFLA TE X en el documento activo. Ver PDF: ejecuta el visor de PDF. DVI a PDF: convierte un DVI a PDF. PS a PDF: convierte un PS a PDF. Ver HTML: muestra el HTML creado. ForwardDVI: salta a la pgina del archivo DVI que corresponde a la lnea actual en el editor. ForwardPDF: salta a la pgina del archivo PDF que corresponde a la lnea actual en el editor. Si se ja en la barra de herramientas Editar, observar tres grandes mens desplegables. Los mens desplegables fueron diseados para permitirle aadir rpidamente caractersticas a su documento. El primer men desplegable se utiliza para dividir su documento en partes, captulos, secciones, etc. Las rdenes disponibles para aadir segmentos a su cdigo fuente LA TE X son: part (parte): el nivel ms alto para seccionar un documento. chapter (captulo): comienza un nuevo captulo. section (seccin): crea una nueva seccin. subsection (subseccin): crea una nueva subseccin. subsubsection (subsubseccin): crea una seccin secundaria. Est a caballo entre una subseccin y un prrafo. paragraph (prrafo): crea un nuevo prrafo. subparagraph (subprrafo): crea un nuevo subprrafo. La lista desplegable llamada Otro se utiliza para insertar en su documento elementos tales como ndices, pies de pgina y referencias; las rdenes disponibles son: label (etiqueta): Orden que presenta una etiqueta para un captulo, una gura u otro elemento. index (ndice): crea una entrada para el ndice. footnote (nota al pie): crea una nota al pie en su documento. 6

Manual de Kile

ref (referencia): utilizado para referirse a una etiqueta predenida, que puede escoger de una lista desplegable. pageref: igual que ref, pero se reere a una pgina en vez de a un elemento de la estructura. cite (cita): crea una cita en su documento desde una bibliografa.

El men desplegable Otro

Seleccionando la etiqueta para una referencia Cuando utilice cite (cita) se le mostrar una lista desplegable de bibitems, pero si est utilizando BibTE X solo funcionar si el archivo pertenece a un proyecto. Para editar archivos BibTE X se recomienda el uso de editores especializados. El autor ha tenido una buena experiencia con KBibTE X y KBib. Por supuesto, tambin puede escribir archivos BibTE X a mano desde Kile. El ltimo men desplegable, etiquetado tiny (pequeo), se utiliza para establecer el tamao de su texto. Tiene la opcin de jar el tamao del texto, notas al pie, etc. Las rdenes de que dispone son: 7

Manual de Kile

tiny: el ms pequeo. scriptsize: muy pequeo. footnotesize: ms pequeo. small: pequeo. normalsize: normal. large: grande. Large: mayor. LARGE: ms grande. huge: todava mayor. Huge: el mayor de todos.

Manual de Kile

Captulo 3

Inicio rpido
3.1. Escribiendo un documento LA TE X con Kile para principiantes

Los usuarios de Kile tiene dos opciones cuando comienzan un documento nuevo: Pueden usar el Asistente para comenzar el documento nuevo, seleccionando el tipo de documento que le gustara crear y opciones tales como tamao del tipo de letra, tamao del papel, etc. La otra opcin es escribir el cdigo a mano.
\ documentclass [12 pt ]{ article } \ begin { document } Aqu tiene un montn de texto codificado en \ LaTeX . \ end { document }

Cada documento en LA TE X comienza con la orden \documentclass[argumento opcional ]{class}, donde la clase especica el tipo de documento. Escribiendo el cdigo del ejemplo anterior, la caja de texto da la siguiente salida:

Texto compilado en la salida DVI Los corchetes que vienen despus la orden \documentclass contienen las opciones para la orden. La opcin [12pt] ja el tamao del tipo de letra para su artculo. Si no ja el tamao del tipo de letra al principio, puede hacerlo ms adelante en el cdigo. Una vez que haya escrito el cdigo de ejemplo del cuadro anterior, necesitar compilar su cdigo fuente LA TE X. La manera ms sencilla de compilar LA TE X es utilizar el men Generar, o utilizar el botn Construccin rpida. Alt-2 es la combinacin de teclas para compilar su cdigo fuente. Necesitar guardar su cdigo fuente antes de poder compilarlo. Kile lo har automticamente por usted. Si su documento no compil, compruebe el registro para buscar errores. Cuando utilice la opcin de Construccin rpida, el visor de Okular debera iniciarse automticamente; si no es as compruebe el registro. 9

Manual de Kile

3.2.

Entornos

Un entorno es un segmento de texto que es tratado de forma diferente que el resto de su documento. Por ejemplo, puede crear un informe con un tipo de letra de tamao 12, pero necesitar cambiar el tamao de su tipo de letra para unas pocas lneas. La orden \begin{environment}, \huge y \end{environment} le permitir temporalmente alterar el texto dentro de las rdenes de entorno para tener un tamao mayor. Por tanto, los cambios son solo efectivos desde \begin{environment} hasta \end{environ ment}. No hay lmites acerca de cuntos cambios puede hacer dentro de un entorno. Hay muchas caractersticas que puede aadir a su documento que lo har ms legible y amigable. Puede aadir caractersticas como tipos de letra especcas, negrita, cursiva, subrayado, etc.. a su documento, y estas rdenes nalizarn con un orden \end, o bien al nal de su entorno. \begin{emph}: esta orden pone el texto en cursiva, y es vlido hasta que se encuentra una orden \end{emph}, \end{emph} o un nal de entorno. Para poner en cursiva solo una palabra en una frase, utilice la sintaxis: esta es la frase \em{mi}. \textbf{Estoy poniendo en negrita el texto entre llaves}: esta orden pone su texto en negrita. \quote: para crear una cita (no bibliogrca) dentro de su documento, comience su cita con \begin{quote} y termnela con \end{quote}. \center: centra el texto. \verse: crea texto desplazado para poemas. \itemize: crea una lista de elementos.

3.3.

Utilizando Kile

Ahora que le hemos dado cierta base sobre cmo escribir cdigo utilizando el lenguaje de marcas LA TE X, le mostraremos cmo crear un documento paso a paso utilizando Kile. 1. Arranque Kile. 2. Seleccione Asistente Inicio rpido. Entonces elija un formato, y seleccione sus preferencias en el asistente. 3. Una vez el asistente ha introducido texto, personalcelo un poco para hacer el documento ms legible. Aada un mnimo de una cita (no bibliogrca), texto en negrita u cursivas, y un verso para ver las diferencias entre rdenes. 4. Guarde su archivo y llmelo intro.tex. 5. Construya su documento utilizando Alt-2 o el botn LaTeX. 6. Seleccione Ver DVI. 7. Compruebe su nuevo texto. 8. Cuando termine de ver su documento, haga clic sobre Vista de editor o pulse Ctrl-E para volver al editor si est utilizando el visor empotrado, o cierre la ventana del visor si este est separado. Ya est! Ha creado su primer documento LA TE X! Una vez haya creado su DVI, podr imprimir su documento o convertirlo en un archivo PostScript o PDF si lo desea. Experimente y divirtase! 10

Manual de Kile

3.4.

Archivos DVI

DVI signica archivo independiente del dispositivo (DeVice Independent). Estos archivos son producidos por TE X o LA TE X para ser ledos por un controlador en su ordenador. Hay muchos tipos diferentes de salidas a las que un .dvi puede ser enviado, como a una impresora, a un archivo PostScript, a un conversor de archivos PDF, o a la pantalla de su ordenador.

3.4.1.

Ver un DVI

Ya ha visto cmo ver un archivo DVI en la pantalla utilizando el botn Ver DVI de la barra de herramientas.

3.4.2.

Imprimir un DVI

Para imprimir un DVI, puede emplear el mismo proceso que utiliz anteriormente para crear su documento (vea Seccin 3.3). En el paso 7, despus de pulsar en Ver DVI, elija Archivo Imprimir en el visor, y si tiene la impresora correctamente congurada, el DVI se imprimir.

3.4.3.

Convertir archivos DVI

La barra de herramientas da opciones para convertir un DVI a diferentes formatos. Una vez haya creado un DVI desde su cdigo fuente LA TE X, podr exportarlo al formato que elija utilizando los botones de la barra de herramientas.

3.5.

Bsqueda hacia delante entre Kile y Okular

Las funciones de bsqueda hacia delante le permiten que su editor salte directamente sobre la posicin asociada al archivo DVI o PDF. Kile ofrece una conguracin con esta opcin para todos los binarios LA TE X. Vaya a Preferencias Congurar Kile... Herramientas+Generar y seleccione siempre la conguracin Moderna. Para ejecutar una bsqueda directa, site el cursor en una lnea del cdigo fuente, y pulse Bsqueda directa para saltar a la posicin asociada en la ventana del visor DVI o PDF.

3.6.

Bsqueda inversa entre Kile y Okular

La bsqueda inversa es una caracterstica muy prctica cuando escribe un documento LA TE X. Si est congurada adecuadamente, puede pulsar en la ventana Okular con el botn izquierdo del ratn mientras mantiene apretada la tecla Maysculas. Despus, Kile carga el cdigo fuente de LA TE X y salta al prrafo adecuado. Para usar la bsqueda inversa, debe compilar su archivo LA TE X con la conguracin Moderna La bsqueda inversa no funcionar a no ser que: El archivo de cdigo fuente haya sido compilado correctamente. Okular sabe qu editor le gustara usar.

11

Manual de Kile

Con esta caracterstica de Okular, una pulsacin en el botn izquierdo del ratn en el documento DVI o PDF har que Kile abra el correspondiente documento LA TE X e intente ir a la lnea correspondiente. Recuerde decirle a Okular que utilice Kile como editor de texto, en la opcin de men de Okular Preferencias Congurar Okular. (en la pgina Editor).

Congurar Okular

3.7.

Resolviendo errores

Si est intentando utilizar la construccin rpida y el visor DVI no se abre, lo normal es que tenga un error. Si es as, ser visible en el rea de registro / mensajes, y se visualizar un resumen del error. El archivo de registro explicar la fuente del error en su cdigo. En el editor, puede utilizar los botones de la barra de herramientas Anterior error de LaTeX y Siguiente error de LaTeX para saltar a y desde los errores. El registro siempre especica en qu lnea se produjo el error. Para ver la lnea en la que ha ocurrido un error, pulse en el error en la ventana del registro, y Kile le llevar a la lnea correspondiente.

12

Manual de Kile

Captulo 4

Comenzando un nuevo documento

Cuando pulsa el botn en la barra de herramientas para comenzar un documento nuevo, aparece un dilogo preguntando qu tipo de plantilla deseara emplear para escribir su documento. Las opciones predeterminadas son: Empty document (documento vaco) Article (artculo) Beamer Book (libro) HA-Prosper Powerdot Letter (carta) Report (informe) Scrartcl (del paquete KOMA-Script) Scrbook (del paquete KOMA-Script) Scrlttr2 (del paquete KOMA-Script) Scrreprt (del paquete KOMA-Script) PDF XeLaTeX Si ha seleccionado Documento vaco, puede comenzar a escribir un documento desde cero, o bien puede utilizar el Asistente para comenzar rpidamente un nuevo documento (vea Seccin 2.3.1).

4.1.

Plantillas

Los usuarios que utilicen LA TE X con frecuencia suelen emplear el mismo prembulo para casi todos sus documentos. Las plantillas pueden ser creadas, guardadas y cargadas dentro de Kile para que resulte ms sencillo comenzar un nuevo documento.

13

Manual de Kile

4.1.1.

Crear una nueva plantilla

Para crear una nueva plantilla, primero debe abrir un archivo TE X / LA TE X, o crear un archivo por su cuenta. Kile puede generar una plantilla desde un documento existente, abriendo el documento deseado y seleccionando Archivo Crear una plantilla a partir de un documento.

4.1.2.

Congurando las sustituciones automticas

Cuando se crea un nuevo documento seleccionando una plantilla desde Archivo Nuevo, ciertas combinaciones de caracteres sern sustituidas por datos como su nombre, o el juego de caracteres que est utilizando. Estas variables pueden ser conguradas en Preferencias Congurar Kile... Preferencias+General. Si est diseando su propia plantilla, es til saber qu combinaciones de caracteres son sustituidas por qu variables de plantilla: $$AUTHOR$$: Esta cadena ser sustituida por la variable autor. $$DOCUMENTCLASSOPTIONS$$: Esta cadena ser sustituida por la variable de opciones de clase de documento. Esto se suele utilizar como sigue: \documentclass[$$DOCUMENTCLAS SOPTIONS$$]{article}. $$INPUTENCODING$$: Si la variable de codicacin de las entradas esta jada, digamos, a latin1 esta cadena es sustituida por \input[latin1]{inputenc}.

4.1.3.

Crear una plantilla desde el asistente

La manera ms sencilla de crear una nueva plantilla es iniciar el asistente y entonces aadir rdenes al editor. Una vez tenga su documento congurado como desee: 1. Guarde su archivo. 2. Vaya a Archivo. 3. Elija Crear una plantilla a partir de un documento. 4. Haga cualquier correccin necesaria a la plantilla. 5. Introduzca un nombre para su nueva plantilla. 6. Pulse Aceptar para aadir su plantilla al men. La siguiente vez que comience un nuevo documento podr elegir su plantilla personalizada adems de las predenidas.

4.1.4.

Crear una plantilla desde cualquier archivo

Se puede crear una plantilla desde cualquier archivo LA TE X. Si est buscando una manera fcil de congurar una plantilla, encuentre en Internet una que le guste y siga los mismos pasos listados en Seccin 4.1.3. Por ejemplo, pongamos que quiere crear un pster enorme de tamao A0. Estos psteres normalmente se ven en congresos cientcos, y LA TE X le ayudar a crear uno atractivo y con gancho. Puede obtener una plantilla para psteres A0 en la pgina de Jonathan Marchini, pero hay muchas otras disponibles. Recuerde que necesitar el paquete a0poster, que normalmente no est en una instalacin estndar de tex, as que deber descargarlo, y copiarlo en l misma carpeta que su archivo de LA TE X. 14

Manual de Kile

4.1.5.

Eliminando una plantilla

Para eliminar una plantilla de Kile, haga lo siguiente: 1. Vaya a Archivo Eliminar plantilla...; 2. Aparecer una cuadro de dilogo con todas las plantillas listadas: seleccione una. 3. Pulse Aceptar y su plantilla ser eliminada. Las plantillas marcadas con un asterisco (*) no podrn ser eliminados sin los permisos pertinentes.

15

Manual de Kile

Captulo 5

Editando documentos LATEX

El editor interno que Kile utiliza es Kate. Kate es un editor de texto creado para programadores, que incorpora la habilidad de leer y resaltar muchos tipos diferentes de archivos de texto, entre los que se encuentran LA TE X y BibTE X. Puede acceder a muchas opciones para Kate directamente desde el men Herramientas de Kile. Para aprender ms acerca de Kate y sus capacidades, mire el Manual de Kate. Los usuarios de Kile pueden empezar a leerlo por el captulo Trabajando con el editor de Kate.

5.1.

Manual de referencia de LA TE X

Kile cuenta con un prctico manual de referencia de etiquetas LA TE X, al que puede acceder seleccionando Ayuda Referencia LaTeX. Contiene una cuidadosa descripcin de casi todas las rdenes que podra utilizar en LA TE X y su sintaxis.

5.2.

Movimientos del cursor

Para seleccionar texto dispone de las siguientes opciones: Mantener pulsado el botn izquierdo del ratn y arrastrarlo para resaltar el texto. Pulsar una vez en una palabra para mover el cursor a un rea diferente. Pulsar dos veces en una palabra para seleccionar la palabra entera. Realice una doble pulsacin sobre una palabra y pulse Ctrl para seleccionar la palabra de tex completa. Esto signica que si pulsa en \par desde \par\bigskip solo se seleccionar \par. Pulsar tres veces para seleccionar la frase entera. Mantener pulsado el botn izquierdo del ratn y arrastrarlo sobre el texto que desea seleccionar, automticamente copia el texto seleccionado al portapapeles. Mantener pulsada la tecla Maysculas y utilizar las teclas de direccin le permite seleccionar porciones de cdigo fuente en la ventana del editor.

16

Manual de Kile

5.3.

Parntesis

El completado de parntesis es una herramienta visual que utiliza el editor para indicar cules se emparejan entre s. Si abre cualquier archivo .tex, y seleccione cualquier parntesis (), corchete [] o llave {}, y el editor lo resaltar (as como a su pareja) en amarillo (este color predeterminado puede ser cambiado). Por ejemplo, si posicionara el cursor en una de las llaves de \section{ Introduccin}, vera \section{Introduccin} en el resaltado amarillo predeterminado, mostrndole la ubicacin de las llaves del principio y el nal.

5.4.

Resaltado

Kile tiene la habilidad de buscar y resaltar diferentes tipos de cdigo. Por ejemplo, las rdenes de LA TE X se distinguen del texto normal, y las frmulas tambin se resaltan en un color diferente.

5.5.

Marcas

Algunos asistentes pueden insertar vietas, un tipo especial de marcadores de texto. Las entradas de men Editar Vietas o el correspondiente acceso rpido del teclado le permitir saltar al siguiente o a la ltima marca. Esto resaltar esta marca que ser borrada cuando introduzca su primera letra.

Siguiente topo (Ctrl+Alt+Derecha) Salta a la siguiente marca de texto si es que existe. Topo anterior (Ctrl+Alt+Izquierda) Salta a la marca anterior de texto si es que existe.

5.6.

Seleccionar

Editar es uno de los aspectos principales cuando utiliza un programa similar a Kile. Aunque Kate ya tiene grandes capacidades, Kile aade algunas caractersticas, que son especialmente importantes para escribir cdigo fuente LA TE X. LA TE X necesita muchos entornos y grupos, por eso Kile soporta rdenes especiales para seleccionarlos. En Editar Seleccionar encontrar las siguientes rdenes para el texto seleccionado.

17

Manual de Kile

Entorno (dentro) (Ctrl+Alt+S,E) Seleccione un entorno sin las etiquetas envolventes. Si se invoca esta orden cuando un entorno ya se ha seleccionado, Kile expandir la seleccin hasta el siguiente entorno envolvente. Entorno (fuera) (Ctrl+Alt+S,F) Seleccione un entorno incluyendo las etiquetas envolventes. Esta seleccin se puede expandir con una segunda llamada a esta orden. Grupo TeX (dentro) (Ctrl+Alt+ST) Selecciona un grupo TeX dentro de los parntesis. Grupo TeX (fuera) (Ctrl+Alt+SU) Selecciona un grupo TeX incluyendo los parntesis. Grupo Math (Ctrl+Alt+SM) Selecciona el grupo matemticas actual incluyendo las rdenes matemticas. Prrafo (Ctrl+Alt+SP) Selecciona un prrafo completo, es decir, un grupo de lneas de texto separadas en ambos lados por lneas vacas. Un prrafo no solo signica lneas continuas de texto, como en los dems editores. El signicado extendido tambin incluye tablas, rdenes LA TE X y todas las dems lneas fuente. Lo nico importante para Kile es que el tipo de prrafo est separado por dos lneas vacas. Lnea (Ctrl+Alt+SL) Selecciona la lnea de texto de la posicin actual del cursor. Palabra TeX (Ctrl+Alt+SW) Selecciona la palabra bajo la posicin del cursor. Esta seleccin tambin tiene un signicado extendido, porque esta orden tambin puede seleccionar rdenes LA TE X, que comienzan con una barra inversa y pueden tener un inicio y un nal opcional.

5.6.1.

Seleccionar rdenes de LA TE X

Kile tiene una caracterstica extendida para seleccionar instrucciones de LA TE X. Si usted, por ejemplo, ha tecleado
texto \ bfseries \ itshape ms texto

Y hace doble click en una de las rdenes de LA TE X, se seleccionarn ambos. Pero a menudo usted querr seleccionar solo una o dos rdenes ms. Esto se puede hacer usando la tecla Ctrl. Solo tiene que apretar la tecla Ctrl, y al hacer doble click seleccionar nicamente la orden deseada. 18

Manual de Kile

5.7.

Borrar

Para borrar algunas partes de un documento puede realizar la seleccin y utilizar la tecla Borrar. Pero tambin Kate proporciona la orden Ctrl-K que borra la lnea. Pero Kile proporciona una forma rpida que son sus propias rdenes de borrado. En Editar Borrar podr encontrar las siguientes rdenes de borrado de texto.

Entorno (dentro) (Ctrl+Alt+TE) Borra un entorno sin incluir las etiquetas. Entorno (fuera) (Ctrl+Alt+TF) Borra un entorno incluyendo las etiquetas. Grupo TeX (dentro) (Ctrl+Alt+TT) Borra un grupo TeX dentro de los parntesis. Grupo TeX (fuera) (Ctrl+Alt+TU) Borra un grupo TeX incluyendo los parntesis. Grupo Math (Ctrl+Alt+TM) Borra un grupo matemtico actual incluyendo las rdenes matemticas. Prrafo (Ctrl+Alt+TP) Borra un prrafo entero. Vea la orden Seleccionar Prrafo, para ver cmo se denen los prrafos en Kile. Al nal de la lnea (Ctrl+Alt+TI) Borra desde la posicin del cursor hasta la posicin del nal de la lnea. Palabra TeX (Ctrl+Alt+TW) Borra la palabra o la orden LA TE X situada bajo la posicin del cursor.

5.8.

Entorno

Ya se mencion que los entornos son el punto central en LA TE X. Por ello Kile proporciona otras cinco rdenes en los submens de Editar Entorno para trabajar con LA TE X de una forma sencilla.

19

Manual de Kile

Ir al principio (Ctrl+Alt+EB) Esta orden ir al principio del entorno actual, sin importar en la posicin en la que est. El cursor se colocar delante de la etiqueta de apertura del entorno. Ir al nal (Ctrl+Alt+EE) Esta orden ir al nal del entorno actual, sin importar la posicin en la que est. El cursor se colocar detrs de la etiqueta de cierre del entorno. Coincidencia (Ctrl+Alt+EM) Cuando su cursor se coloque delante o sobre la etiqueta \begin{environment}, se desplazar a la del nal del entorno y viceversa. Cerrar (Ctrl+Alt+EC) Al teclear muchas etiquetas de entorno anidadas, puede perder el control de estos entornos. Esta orden cerrar el ltimo entorno abierto, de forma que la estructura de anidacin de entornos no se romper. Cerrar todo (Ctrl+Alt+EA) Cierra todos los entornos abiertos, no solo el ltimo entorno abierto.

5.9.

Grupo TE X

Kile tambin ofrece rdenes especiales para los grupos de LA TE X, que estn denidas por llaves {...}. En el submen Editar Grupo TeX encontrar algunas rdenes importantes, que se corresponden con las del men Editar Entorno.

Ir al principio (Ctrl+Alt+GB) Salta al principio del grupo actual desde su posicin actual. El cursor se colocar delante de la llave de apertura. Ir al nal (Ctrl+Alt+GE) Salta al nal del grupo actual desde su posicin actual. El cursor se colocar detrs de la llave de cierre.

20

Manual de Kile

Coincidencia (Ctrl+Alt+GM) Si el cursor se sita delante o detrs de una llave abierta del grupo TE X, se mover al nal del grupo y viceversa. Cerrar (Ctrl+Alt+GC) Teclear muchas llaves de grupo anidadas puede ser duro. Esta orden cerrar el ltimo grupo abierto, de forma que la estructura de anidacin de grupos de TE X no se romper.

5.10.

Comillas dobles

En LA TE X, dos comillas simples se utilizan como comillas dobles. Para ayudarle a insertarlas de forma eciente, Kile le permite pulsar para insertar dos comillas simples de apertura. De la misma forma, para cerrar el entrecomillado deber pulsar . Kile es lo sucientemente inteligente como para reconocer este caso e insertar dos comillas de cierre para LA TE X. Para conseguir que aparezcan las comillas dobles, pulse dos veces .Para conseguir que aparezcan las comillas dobles, pulse dos veces . Puede activar o desactivar esta insercin automtica de apertura y cierre de dobles comillas en la seccin Preferencias Congurar Kile... LaTeX.

Si incluye opciones especcas de su idioma o archivos de estilo como ngerman o french, tambin podr utilizar las Comillas dobles alemanas o francesas. Hay muchos ms idiomas disponibles.

5.11.

Nueva lnea inteligente

Si pulsa Ctrl-Intro, Kile insertar una nueva lnea inteligente. Si su posicin actual se encuentra dentro de un entorno de lista, como enumerate o itemize, Kile no solo insertar una lnea nueva, sino que tambin aadir una orden \item.

21

Manual de Kile

Si est dentro de un entorno tabular, Kile terminar la lnea actual con \\, seguido de una lnea nueva. Si est dentro de un comentario de LA TE X, Kile comenzar la siguiente lnea con un %. Incluso mejor, Kile es lo sucientemente inteligente como para soportar entornos predenidos de LA TE X y denidos por el usuario, que pueden aadirse en la seccin Preferencias Congurar Kile... LaTeX.

5.12.

Tabulador inteligente

Algunos usuarios quieren colocar las columnas en entornos tabulares y situar all todos los caracteres ampersand & unos debajo de otros. Kile intenta admitir esto. Si pulsa Alt-Maysculas-&, Kile buscar el siguiente tabulador en la lnea de arriba. Sin embargo, a veces no se corresponder con el tabulador adecuado. Kile aadir algunos espacios para ajustarlo a la posicin de la columna del tabulador actual.

22

Manual de Kile

Captulo 6

Completado de cdigo
A pesar de que Kate ofrece un buen modo de completado, el completado de cdigo extendido de Kile soporta mtodos especialmente indicados para LA TE X. Existen cinco modos diferentes integrados. Tres de ellos trabajan bajo peticin, los otros dos son modos de autocompletado. Todos los modos pueden congurarse para trabajar de formas muy diferentes a travs de Preferencias Congurar Kile....

6.1.

Completado automtico de entornos

Cuando empiece un nuevo entorno, escribiendo por ejemplo \begin{environment}, Kile automticamente aadir una orden \end{environment}, con una lnea en medio para su texto. El autocompletado se puede desactivar en la seccin LA TE X de Preferencias Congurar Kile... LaTeX+Entornos.

Completando un entorno de ecuacin

6.2.

rdenes LA TE X

Cuando teclee algunas letras, puede activar este modo de completado para las rdenes LA TE X y palabras normales con Editar Completado Orden (La)TeX o el acceso rpido de teclado Ctrl-Maysculas-Espacio. Kile lee primero las letras de la posicin del cursor hacia la izquierda y se detiene en el primer carcter que no sea una letra o una barra inversa. Si el patrn comienza con una barra inversa, Kile entrar en modo de completado para las rdenes TE X o LA TE X. Si no, entrar en el modo de diccionario normal, donde no encontrar rdenes LA TE X. Dependiendo del modo seleccionado, se abrir un cuadro de completado. Podr ver todas las rdenes o palabras que comiencen con el patrn actual. Puede navegar con las teclas del cursor por la lista y seleccionar una entrada con Intro o con una doble pulsacin del ratn.

23

Manual de Kile

Cuando pulse la tecla Retroceso, la ltima letra de su patrn se borrar, y la lista de completado crecer. Por otra parte, si teclea otra letra el patrn se expandir y la lista de palabras visibles se reducir. Si decide no seleccionar ninguna sugerencia, podr mantener este dilogo con Esc. Podr ver que todas las rdenes se escriben con una pequea descripcin de sus parmetros. Estas descripciones desaparecen cuando selecciona una orden. Opcionalmente puede dejar que Kile inserte marcas en estos lugares, de forma que pueda saltar fcilmente a estas posiciones con Editar Vietas Siguiente vieta e insertar el parmetro que desee.

Vaya a Preferencias Congurar Kile... Kile+Completado para congurar una o ms de estas listas. Puede seleccionar listas de palabras diferentes para las rdenes TE X y LA TE X y el modo diccionario para las palabras normales. Si elige la opcin Mostrar orden de Latex, las entradas de todos los archivos cwl elegidos para la complecin de las rdenes de LA TE X se mostrarn en una vista separada de la barra lateral de Kile. As tendr un buen sondeo de qu instrucciones estn disponibles y qu parmetros u opciones deben o pueden darse para la complecin. Usted tambin puede seleccionar simplemente una entrada con un click del ratn y esta se insertar en el documento, donde estarn detallados todos los parmetros y opciones.

24

Manual de Kile

Como cada lista de palabras elegida se mostrar en una vista separada, podra haber demasiadas vistas, con lo que la ventana principal de Kile sera demasiado grande para los monitores pequeos. Como esto resulta muy feo, Kile trabaja con un nmero mximo de vistas permitidas, que est establecido en 10. Si este valor es demasiado grande para su pantalla, debera reducir este nmero.

6.3.

Entornos

El modo de rdenes no es prctico para completar rdenes. Siempre podr teclear algunas ordenes de \begin, e invocar el modo de completado puede dar como resultado una enorme lista de etiquetas de entorno. Por otra parte, los entornos que Kile utiliza con cierta frecuencia cuentan con un modo especial para completado de entornos. Olvide la etiqueta de apertura y escriba, por ejemplo, eq. Cuando llame al modo de completado con Editar Completado Entorno o con el acceso rpido Alt-Maysculas-Espacio, la etiqueta de apertura se aadir automticamente y ver \be gin{eq}. Despus de este cambio, la lista de completado ser mucho ms reducida.

Ahora seleccione un entorno, y ver que tambin se cierra automticamente. Incluso ms, si Kile lo reconoce como una lista de entorno, insertar una primera etiqueta \item.

Vaya a Preferencias Congurar Kile... Kile+Completado para congurar una o ms de estas listas. Este modo utiliza la misma lista de palabras que el modo de completado de las rdenes TE X y LA TE X.

25

Manual de Kile

6.4.

Abreviaturas

Kile soporta listas de abreviaturas denidas por el usuario, que se reemplazan bajo peticin por largas cadenas de texto. Vaya a Preferencias Congurar Kile... Kile+Completado para congurar una o ms de estas listas. Para el ejemplo dado, se elegir la lista de abreviaturas en exam ple.cwl. En este archivo encontrar, por ejemplo, la entrada L=\LaTeX. Por ejemplo, teclee la letra L. Llame el modo de abreviatura de completado de palabra con Editar Completado Abreviatura o con Ctrl-Alt-Espacio, y la letra L se reemplazar por la cadena \LaTeX. La complecin de abreviaturas tambin admite %n y %C para colocar el cursor, si estos caracteres estn presentes en el texto de expansin. As, si tiene la entrada
en1 =\ begin { enumerate } %n\ item %C %n\ end { enumerate } %n

en el archivo de complecin e invoca el completado de abreviaturas, la expansin tendr el aspecto que se ve abajo, donde x muestra la posicin nal del cursor.
\ begin { enumerate } \ item x \ end { enumerate }

6.4.1.

Abreviaturas

Si elige Mostrar abreviaturas, se mostrarn todas las posibles abreviaturas en una vista de la barra lateral. As que tendr un buen listado de todas las abreviaturas posibles.

6.5.
6.5.1.

Modos de autocompletado
rdenes LA TE X

Puede activar el modo de completado automtico para las rdenes LA TE X. Cuando se introduce un nmero de letras (valor predeterminado: 3), se abrir una ventana con una lista de todas las rdenes LA TE X coincidentes. Puede seleccionar una de estas rdenes, o ignorar esta ventana y teclear ms letras. Las entradas del cuadro de completado cambiarn para adaptarse a las letras que escriba. Vaya a Preferencias Congurar Kile... Kile+Completado para activar o desactivar este modo o para cambiar el nmero de palabras.

26

Manual de Kile

6.5.2.

Palabras de documento

Los diccionarios grandes no son prcticos en el modo autocompletado. Pero, hemos visto que muchas palabras en un documento se teclean ms de una vez. Por ello Kile ofrece un autocompletado para todas las palabras del documento que el usuario haya tecleado anteriormente. Puede invocar este completado manualmente si presiona Ctrl-espacio. Tenga en cuenta que este modo es diferente del modo de completado en las instrucciones LA TE X. Si desea activar o desactivar este modo, vaya a Preferencias Congurar Kile... Editor Editar+Autocompletado. En este dilogo puede congurar si el modo de completado para palabras del documento debe estar habilitado. Hay tambin un modo de autocompletado adicional, donde aparece una caja de completado cuando se supera cierto umbral.

6.6.

Escribir los propios archivos de completado

La especicacin ms reciente del formato de archivo de completado puede encontrarse en la especicacin del formato de archivo CWL. Los archivos de completado pueden instalarse en la carpeta personal del usuario en la carpeta~/ .kde/share/apps/kile/complete/<modo>/ , donde <modo> se utiliza para abreviatura, diccion ario o tex.

27

Manual de Kile

Captulo 7

Asistentes y dilogos
7.1. Asistente de inicio rpido

Este asistente ya se ha descrito en la seccin Seccin 2.3.1.

7.2.

Incluir grcos

El dilogo Incluir grcos hace la insercin de grcos lo ms fcil posible. Puede acceder a l mediante la barra de men con LaTeX Insertar imagen. Por favor, mire Seccin 9.3 y Seccin 9.4 para tener una idea general de algunos hechos bsicos referidos a los formatos de grcos.

1. Seleccione un archivo grco. Este puede ser JPEG, PNG, PDF, EPS e incluso un archivo EPS comprimido con zip o gzip. Si tiene instalado ImageMagick y tambin tiene congurado Kile para utilizarlo (Preferencias Congurar Kile... LaTeX+Grcos), la anchura y la 28

Manual de Kile

altura de los grcos se muestra automticamente. Si ImageMagick puede determinar la resolucin, el tamao de los grcos tambin se muestra en centmetros. 2. Decida si su imagen ser centrada en la pgina. 3. Elija si quiere la notacin de \graphicspath para su archivo de grcos. De forma predeterminada los archivos grcos deberan estar en la misma carpeta que el documento maestro. Sin embargo, es posible colocarlos en otras carpetas para hacer las cosas ms ordenadamente. Sin una orden \graphicspath, Kile incluir la ruta para el archivo grco. Pero si utiliza \graphicspath en el prembulo as:
\ graphicspath {{/ ruta /a/ mis / grficos }{ otra / ruta /a/ ms / grficos }}

y marca esta opcin, Kile solo utilizar el nombre base de los archivos grcos. Otro ejemplo: si congura \graphicspath de forma similar a:
\ graphicspath {{./}{ cmara /}{ imgenes /}}

LA TE X buscar en la carpeta actual, a continuacin en cmara y nalmente en imgenes para encontrar sus archivos grcos. 4. Si selecciona la anchura o la altura, el grco completo se escalar proporcionalmente. Si selecciona dos valores para la anchura y la altura a la vez, la anchura y la altura se escalarn con factores diferentes, y esto puede que no sea lo que desee. Vea tambin la informacin cercana a la parte superior del dilogo para saber el tamao original de los grcos. 5. Inserte un ngulo para rotar el grco en el sentido de las agujas del reloj. 6. El cuadro con la informacin relacionada con el archivo grco se congurar automticamente cuando lo elija. Esta informacin solo ser necesaria cuando trabaje con el LA TE X tradicional y grcos de mapas de bits. Vea el debate referente a los grcos EPS. Si LA TE X necesita una caja envolvente y no desea generar un archivo bb, Kile admite esta opcin. Por otra parte, PDFLA TE X le dar un aviso cuando desee incluir grcos png o jpg con esta opcin. Esta casilla de vericacin habilita o deshabilita la opcin de caja envolvente. 7. Escale la imagen segn el factor de escala deseado, p.ej. 0,5 para reducirla a la mitad, o 2 para hacerla el doble de grande. Cuando utilice esta opcin, no tendr que introducir una anchura o una altura para la imagen. 8. En la pestaa Recortar imagen puede recortar la imagen en cualquiera de las cuatro direcciones. 9. Finalmente, tiene que especicar si desea incluir esta imagen en un entorno de guras. Cuando quiera que el texto envuelva la gura, use el entorno de envolver gura en su lugar.

NOTA
Cuando elija el entorno de guras, necesita incluir el paquete wrapg en el prembulo.

En cualquier caso puede insertar un pie de foto y una etiqueta para su imagen. Generalmente, es una buena idea aadir un prejo diferente para cada tipo de etiqueta. Es habitual usar el prejo fig: para las imgenes. 10. Si selecciona el entorno de gura, puede elegir dnde debera LA TE X situar la gura preferiblemente. 11. En el entorno de envolver gura puede

29

Manual de Kile

a) Seleccione una regla de situacin para la gura y decida si la gura debera otar o no. En un documento de dos caras puede denir si la gura debera estar o no en el interior de la pgina o en el exterior. b) Dena cuntas lneas del texto envuelto deberan romperse. Si deja esto vaco, LA TE X lo determinar por s mismo de la mejor manera posible. c) Dena un saliente para el lado elegido. Esto es especialmente til cuando tiene columnas en su documento y desea que una gura abarque ms de una, o desea que la envuelvan dos columnas. d) Elija el ancho de la gura. Este debera ser un poco mayor que la anchura real de la imagen, de forma que haya algo de espacio vaco entre la gura y el texto.

7.3.

Matrices y tablas

Una de las tareas ms aburridas que uno puede hacer en LA TE X consiste en escribir una matriz o un entorno de tabla. Se debe llevar la cuenta de todos los elementos, asegurarse de que el entorno est bien formado, y que todas las cosas estn donde se supone que deben estar. Una buena indentacin ayuda, pero hay una forma ms sencilla de hacerlo: utilizar el men Asistente de Kile. Contiene las entradas de men Tabla y Matriz (utilizado en entornos matemticos). Conseguir un formulario con forma de matriz que puede rellenar fcilmente con sus entradas. Este dilogo tambin ofrece algunas opciones para seleccionar el tipo del material de la tabla.

Usando la barra de herramientas en la parte superior del dilogo puede establecer la alineaci n de una celda, denir un estilo de tipo de letra determinado, combinar y dividir celdas, elegir un borde y especicar el color del fondo y del tipo de letra. Ms a la derecha hay un botn de Pegar. Con este botn puede insertar una tabla desde el portapapeles al dilogo, lo que le permite copiar y pegar tablas desde un programa de hoja de clculo, por ejemplo. En la parte inferior puede elegir cuntas las y columnas desea, y puede ajustar algunas cosas ms en la distribucin. Con la opcin Etiqueta puede seleccionar qu entorno se debera usar para su matriz o material tabulado. 30

Manual de Kile

Puede seleccionar la alineacin vertical de celdas con la opcin Parmetro. Esta solo est habilitada en los entornos que admiten esta caracterstica. Si existe para el entorno seleccionado, puede elegir usar la versin con estrella. Cuando seleccione esta opcin, tambin tendr que especicar una anchura de tabla. Las tablas a veces tienen mejor aspecto si selecciona la opcin Usar paquete de pestaas. Por supuesto, tambin puede centrar toda la matriz. Insertar vietas ayuda cuando desea llenar el editor con su contenido. Con esta opcin seleccionada, Kile insertar un marcador de posicin para cada elemento de su distribucin. La opcin Asistente Tablas mostrar un dilogo sencillo para congurar rpidamente un entorno tabular. Le permite especicar fcilmente el nmero de las o columnas y el espacio requerido.

7.4.

Insertar elementos otantes

Kile le ayuda con la insercin de elementos otantes. Con el asistente de Asistente Flotantes es muy fcil crear una nueva gura o un entorno de tabla.

Para insertar un nuevo elemento otante solo tiene que seguir estos pasos: 1. Elija si quiere insertar una imagen o una tabla. 2. Seleccione las reglas de posicin deseadas. 3. Introduzca un pie de foto para su elemento otante. 4. Teclee una etiqueta para su nuevo elemento otante. Kile sugerir automticamente un prejo apropiado, p. ej. g: para guras y tab: para tablas.

31

Manual de Kile

7.5.

Insertar entornos matemticos

Recordar cmo funcionan todos los elementos matemticos puede ser muy molesto. Por supuesto, Kile puede hacer toda la magia por usted aqu: Asistente Matemticas

Opciones: Nombre:: Elija el tipo de elemento matemtico que desee crear. Sin numerar: Esto puede activar o desactivar la numeracin de elementos numerados, como ecuaciones o alineaciones. Orden de espacio para separar grupos: En un entorno que admita varios grupos, como alignat, puede denir un separador de espacio cuando tiene ms de un grupo. Puede introducir cualquier orden de espacio aqu, que existe en el modo matemtico, p. ej. \quad. Tabulador estndar: Seleccione el tabulador que se utilizar. Kile debera elegir automticamente el adecuado para usted. Mostrar el modo matemtico: Para entornos como matrices, puede elegir con qu entorno matemtico debera mostrarse su texto. Usar vietas: Con esta opcin seleccionada, Kile insertar marcadores de posicin para cada elemento de su texto matemtico.

7.6.

Utilidades PostScript

Los archivos PS no son tan populares como los PDF, pero son una excelente base para la manipulacin y reordenacin de pginas. Si necesita una salida PDF, puede reorganizar las pginas con algunas utilidades PostScript y convertirlas a PDF con ps2pdf. El Asistente de PostScript bajo Asistente Herramientas de Postscript sugerir los arreglos ms populares. La conversin se realiza mediante los programas pstops y psselect, que se pueden encontrar en la mayora de distribuciones en el paquete psutils. Si uno de estos programas no est disponible, no se ver el elemento correspondiente.

32

Manual de Kile

En primer lugar elija el archivo de entrada. Si Kile encuentra un archivo PS correspondiente al documento maestro, se utilizar como archivo de entrada, aunque puede escoger otro archivo. A continuacin elija un archivo de salida, y seleccione una de las tareas. Finalmente, debe decidir si desea hacer la conversin o solo llamar a Okular para ver el resultado. 1 pgina A5 + pgina vaca --> A4 Combina una pgina A5 con una pgina vaca en una pgina A4. Si se combinan juntas dos pginas A5, se girarn 90 grados y se ajustarn en una pgina A4 en modo horizontal.

1 pgina A5 + duplicado --> A4 Coloca una pgina A5 y un duplicado en una pgina A4.

2 pginas A5 --> A4 Coloca dos pginas A4 consecutivas en una pgina A4. 33

Manual de Kile

2 pginas A5L --> A4 Coloca dos pginas consecutivas A5 horizontales en una pgina A4. 4 pginas A5 --> A4 Combina cuatro pginas consecutivas A5 en una pgina A4. Las pginas A5 se escalarn utilizando el factor 0,7 para ajustarla a la pgina.

1 pgina A4 + pgina vaca --> A4 Combina una pgina A4 con otra pgina vaca dentro de una pgina A4. Siempre que dos pginas A4 se combinan entre s dando como resultado una pgina A4, tendrn que ser escaladas con un factor de 0,7 y se colocarn en modo apaisado.

1 pgina A4 + duplicado -->A4 Coloca una pgina A4 y un duplicado juntos en una pgina A4.

34

Manual de Kile

2 pginas A4 --> A4 Coloca dos pginas consecutivas A4 juntas en una pgina A4.

2 pginas A4L --> A4 Coloca dos pginas consecutivas A4 en modo horizontal juntas en una pgina A4. seleccionar pginas pares Selecciona todas las pginas pares de un documento. seleccionar pginas impares Selecciona todas las pginas impares de un documento. seleccionar pginas pares (orden inverso) Selecciona todas las pginas pares de un documento en orden inverso. seleccionar pginas impares (orden inverso) Selecciona todas las pginas pares de un documento en orden inverso. invertir todas las pginas Invierte todas las pginas de un documento. copiar todas las pginas (ordenadas) Copia todas las partes de un documento. Debe seleccionar el nmero de copias ordenadas.

35

Manual de Kile

copiar todas las pginas (desordenadas) Copia todas las pginas de un documento. Debe seleccionar el nmero de copias no ordenadas.

pstops: seleccionar parmetro Existen muchas opciones para las utilidades de PostScript pstops y psselect. Si necesita una muy especial, puede llamar a pstops con una opcin a su eleccin. Por favor, lea el manual para ver todas las posibles opciones. psselect: seleccionar parmetro Puede llamar a psselect con una opcin que elija. Por favor, lea el manual para ver todas las opciones posibles.

7.7.

Estadsticas del documento

El dilogo de estadsticas en Archivo Estadsticas le da un resumen estadstico de una seleccin, un documento o un proyecto completo. Incluye el nmero de palabras, rdenes o entornos LA TE X y tambin incluye el nmero de caractersticas de cada tipo. Las estadsticas obtenidas se pueden copiar al portapapeles como texto o como una tabla LA TE X con un formato bonito. Cuando selecciona un texto y abre el dilogo de estadsticas, obtiene las estadsticas para el texto actualmente seleccionado. Si abre el dilogo sin seleccionar texto, se muestran las estadsticas para todos los archivos abiertos. Si desea obtener las estadsticas de todo el proyecto, puede usar Proyecto Abrir todos los archivos de proyecto para una forma rpida y fcil de abrir todos los archivos de fuente de su proyecto. Tenga un poco de cuidado al interpretar la exactitud de los nmeros. Hemos incluido un poco de lgica para obtener una buena estimacin, p.ej. K\uhler da como resultado una palabra y una orden, formada por seis caracteres. Pero existen combinaciones en las que parte de las rdenes se cuentan como palabras y viceversa. Debe tener en cuenta que el algoritmo se ha vericado para idiomas similares al ingls o alemn, por tanto, no d los nmeros por exactos. Si necesita hacer un informe con nmeros de palabras o caracteres exactos, realice algunas pruebas para vericar si la exactitud de Kile satisface sus necesidades.

36

Manual de Kile

Captulo 8

Etiquetas especiales en LATEX

8.1. Utilizando la librera de etiquetas de LA TE X

LA TE X dispone de miles de etiquetas para smbolos y caracteres especiales. La manera ms sencilla de insertar caracteres especiales es empleando el men de la barra lateral, a la izquierda de la ventana de edicin.

El men de la barra lateral Estn disponibles los siguientes tipos: Ms frecuentemente usado Relacin Operadores Flechas 37

Manual de Kile

Smbolos matemticos diversos Texto diverso Delimitadores Griego Caracteres especiales Caracteres cirlicos Denido por el usuario Las ayudas visuales de los iconos muestran las rdenes de LA TE X y en ocasiones pueden necesitar paquetes. Pulsar Maysculas y un smbolo dar como resultado que se inserte $\symbolcmd$. De forma similar, pulsar Ctrl lo insertar entre llaves. Si inserta una orden que precise un paquete no incluido en su documento LA TE X, ver un mensaje de aviso en la ventana de registro. La primera lista de smbolos contiene losMs frecuentemente usados. Los smbolos insertados se aadirn a la lista, para conseguir una referencia rpida y sencilla. La ordenacin de los smbolos no cambiar cuando se aadan smbolos nuevos, pero se incrementar un contador de referencia. Si el nmero de elementos excede de 30, el elemento con un nmero menor se eliminar. La lista de smbolos Denidos por el usuario le permite mantener sus propios smbolos. Para crear sus propios smbolos necesita el programa gesymb y el archivo denitions.tex del paquete fuente de kile. Tambin necesitar un compilador LA TE X (qu sorpresa) y dvipng (versin 1.7 o posterior). El procedimiento consiste en crear un archivo LA TE X con \input{definitions}, que hace que las rdenes siguientes estn disponibles, y le permite que gesymb mysymbols .tex usuario (que llama LA TE X y dvipng) cree los iconos. Despus de copiarlos a $HOME/ .kde/share/apps/kile/mathsymbols/user/ y restaurar kile puede utilizar sus propios smbolos. Las siguientes rdenes se denen en dinitions.tex: \command[\argumento-opcional]{\smbolo}: Incluye el smbolo \smbolo en la lista, el argumento opcional \argumento-opcional especica la orden que kile debe insertar. Si no se usa, se utiliza la orden en el argumento obligatorio. \mathcommand[\argumento-opcional]{\smbolo}: Igual que el anterior, con la diferencia de que en el argumento obligatorio se inserta en el modo matemtico. \pkgs[argumento]{paquete}: Declara que la orden dada en esta lnea necesita el paquete de LA TE X paquete con el argumento opcional argumento. Esta orden debe estar frente a la orden \command y sobrescribe cualquier especicacin de paquete del entorno neededpkgs. \begin{neededpkgs}[argumentos-paquetes]{paquetes} ... \end{neededpkg s}: Tiene el mismo efecto que la anterior, pero para todas las rdenes encerradas. A continuacin se muestra un ejemplo completo:
\ documentclass [ a4paper ,10 pt ]{ article } \ usepackage { amssymb } \ input { definitions } % \ begin { document } \ pagestyle { empty } % \ begin { neededpkgs }{ amssymb } \ mathcommand {\ surd }

38

Manual de Kile

\ pkgs { amsmath }\ mathcommand [\ ddddot {}]{\ ddddot {a }} \ mathcommand {\ angle } \ end { neededpkgs } \ command {\" A} \ mathcommand {\ exists } \ mathcommand [\ stackrel {}{}]{\ stackrel { abc }{=}} %\ begin { neededpkgs }[ russian , koi8 -r ,T2C ,]{ babel , inputenc , fontenc , mathtext } % % \ end { neededpkgs } % this would need to include the packages % \ usepackage { mathtext } % \ usepackage [ T2C ]{ fontenc } % \ usepackage [ russian ]{ babel } % \ usepackage [ koi8 -r ]{ inputenc } % just to explain the format \ end { document }

8.2.

Utilizando Bibitems

\bibitem es una orden utilizada para introducir una referencia en un entorno thebibliogra phy en su documento. La sintaxis para utilizar \bibitem es\bibitem[etiqueta]{clave}. La [etiqueta] opcional es para que aada su propio sistema de etiquetado para esa entrada bibliogrca. Si no se ja ninguna etiqueta, las entradas sern ordenadas numricamente: [1], [2], [3], etc.. El argumento {clave} se utiliza para referenciar y enlazar las rdenes \bibitem y \cite as como la informacin que contienen. La orden \cite contiene la etiqueta asociada con el \bi bitem deseado, que est localizado dentro de un entorno thebibliography, y contiene los datos de la referencia. Tanto el \bibitem como el \cite correspondiente deben tener la misma {clave}. La manera ms sencilla de organizar las claves es por el apellido del autor. El segundo {} en {thebibliography} denota la mayor etiqueta bibliogrca que puede tener. Es decir, que insertar {} signica que puede tener cualquier etiqueta menor o igual a la expresin foo. Si se equivoca con este parmetro podra conseguir una indentacin no demasiado atractiva en su bibliografa. La bibliografa es una seccin aparte de su documento principal, y un ejemplo de cdigo para la bibliografa podra ser el siguiente:
\ begin { thebibliography }{50} \ bibitem { Simpson } Homer J. Simpson . \ textsl { Mmmmm ... donuts }. Evergreen Terrace Printing Co ., Springfield , SomewhereUSA , 1998 \ end { thebibliography }

Por tanto, su cdigo fuente principal contendra la localizacin de la informacin relativa al \bi bitem empleando \cite. Este cdigo se parecera al siguiente:
Mi tesis sobre la filosofa de Los Simpson \ el copyright viene de mi libro favorito \ cite { Simpson }.

Como muchas veces es difcil recordar la clave de una cita bibliogrca cuando tiene muchas referencias, Kile proporciona una manera sencilla de insertar una cita. Usando LaTeX Referencias Cita aparece una lista con todas las claves de cita. Seleccione la referencia correcta y la cita se insertar en su documento. Para actualizar la lista de claves, guarde el archivo o Editar Refrescar estructura, o presione F12. Con la complecin de cdigo habilitada, Kile le mostrar una lista de todas las etiquetas bibitem tan pronto como abra una orden de \cita. 39

Manual de Kile

El resultado nal en la bibliografa de su documento se parecera a algo como esto: [1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, AlgnLugarEE.UU., 1998. Kile tambin puede trabajar con editores de BibTE X, como KBibTE X, para hacer ms fcil la introduccin de citas. Cuando se aade un archivo de BibTE X al proyecto, Kile le ayudar a completar las rdenes de cita, como se describe ms arriba.

8.3.

Etiquetas denidas por el usuario

Kile le permite crear sus propias etiquetas. Una etiqueta es similar a un acceso rpido que ejecuta alguna orden o escribe texto empleado frecuentemente. Por ejemplo, Joe Sixpack utiliza frecuentemente las frases Yo prefiero \LaTeX\ a \TeX\ y Qu hara yo sin Linu x?. Para crear etiquetas denidas por el usuario para escribir estas frases, l accedera a LaTeX Etiquetas de usuario Editar etiquetas de usuario..., mostrndose un dilogo en el que podr crear sus propias etiquetas.

El cuadro de dilogo para editar etiquetas del usuario

40

Manual de Kile

Llamando una etiqueta denida por el usuario Probablemente le dara a cada etiqueta un nombre que la identique con claridad. El nombre que le da a su etiqueta se introduce en la seccin marcada como Elemento de men, y el texto de la orden frecuentemente usada se debera introducir en la seccin Valor. Una vez que las rdenes hayan sido introducidas, puede utilizarlas rpidamente mediante la combinacin de teclas CtrlMaysculas-1 para la primera etiqueta para introducir Yo prefiero \LaTeX\ a \TeX\, y Ctrl-Maysculas-2 para introducir Qu hara yo sin Linux?.

8.3.1.

Localizadores en etiquetas denidas por el usuario

Existen algunos localizadores que puede utilizar en las etiquetas denidas por el usuario, que son %B, %C, %M y %S. %B: ser sustituido por una marca. %C: indica dnde se posicionar el cursor despus de usar una etiqueta denida por el usuario. %M: el texto seleccionado se inserta en este lugar cuando se utiliza la etiqueta denida por el usuario. %S: se sustituir por el nombre del archivo fuente sin la extensin del archivo. Consideremos el ejemplo que puede ver en las capturas de pantalla. Primero, seleccionamos un nmero de nuestro texto, digamos el 2. Ahora, presionamos Ctrl-Maysculas-1 o elegimos LaTeX Etiquetas de usuario Frac, y obtenemos \frac{2}{} con el cursor localizado dentro del segundo par de parntesis.

41

Manual de Kile

Captulo 9

Las herramientas de construccin

9.1. Compilar, convertir y ver

Para ver el resultado de su trabajo, primero necesita compilar el archivo fuente. Todas las herramientas de construccin estn agrupadas en los mens Generar Compilar, Generar Convertir, y Generar Ver. Para compilar su cdigo fuente para los visores en pantalla tales como Okular o para realizar la conversin posterior, puede utilizar el acceso rpido Alt-2. Entonces podr ver el archivo DVI utilizando su visor predeterminado con Alt-3, convertir el DVI a un archivo PS con Alt-4, y ver el archivo PS con Alt-5.

9.1.1.

BibTE X

Si est utilizando BibTEX para sus entradas bibliogrcas, usualmente deber elegir un esquema de compilacin especial. Esto implica llamar a LA TE X y a continuacin a BibTE X y a continuacin LA TE X de nuevo. Afortunadamente Kile es lo sucientemente inteligente como para detectar automticamente si es necesario llamar a herramientas adicionales como BibTE X, makeidx y Asymptote. De forma predeterminada esta lgica est activada y puede cambiarse en Preferencias Congurar Kile... Herramientas+Compilar en la pestaa General en las herramientas LA TE X y PDFLA TE X.

9.1.2.

MetaPost and Asymptote

Si quiere compilar su documento con MetaPost o Asymptote, programa de dibujo de imgenes, puede hacerlo con Compilar Compilar Metapost, o Compilar Otro Asymptote.

9.1.3.

PDFLA TE X

Existe otra manera de compilar su documento si desea obtener un PDF: ejecutando PDFLA TE X compilar el fuente directamente en un archivo PDF, con Alt-6: podr ver el archivo compilado pulsando Alt-7. Tambin puede convertir un PS en un PDF con Alt-8, o directamente un DVI en un PDF con Alt-9. Emplear PDFLA TE X en vez de LA TE X puede deberse a una cuestin de simplicidad o costumbre, pero a veces el comportamiento de los dos programas puede ser diferente. 42

Manual de Kile

9.1.4.

LA TE X para Web

Finalmente, podra desear publicar su trabajo en la web y no solo en papel. Puede entonces utilizar el programa latex2html, que puede llamarse desde el men de Kile Generar Convertir LaTeX a web. El resultado se colocar en una subcarpeta de la carpeta de trabajo, y podr ver el resultado de la conversin eligiendo el elemento de men Compilar Ver Ver HTML.

9.1.5.

Pasar parmetros en lnea de rdenes

Si desea pasar algunos parmetros especcos de lnea de rdenes a la compilacin, conversin o herramientas de visionado, puede congurar las llamadas en Preferencias Congurar Kile... Herramientas+Compilar.

9.2.

Vista previa rpida

Necesitar algn tiempo para ver el resultado, cuando trabaje con LA TE X. LA TE X tiene que compilar las fuentes y llamar al visor. Esto puede ser molesto si solo ha cambiado algunas letras en una ecuacin dicil de presentar. Kile tiene un modo de Vista previa rpida, con el que puede compilar solo una parte de un documento y ahorrar mucho tiempo. Soporta cuatro modos diferentes, que pueden combinarse con siete conguraciones.

Todas las modicaciones se pueden realizar en Preferencias Congurar Kile... Herramientas+Vista previa.

43

Manual de Kile

9.2.1.

Modo de seleccin

El usuario debe seleccionar una parte del documento. La entrada del men Generar Vista previa rpida Seleccin o el acceso rpido de teclado Ctrl+Alt+P,S iniciarn los programas seleccionados. Kile tomar el prembulo del texto original, por eso se incluirn todos los paquetes y rdenes denidas por el usuario. El usuario puede seleccionar una de las ocho conguraciones predenidas: LaTeX+DVI (visor empotrado) LaTeX+DVI (Okular) LaTeX+PS (visor empotrado) LaTeX+PS (Okular) PDFLaTeX+PDF (visor empotrado) PDFLaTeX+PDF (Okular) XeLaTeX+PS (visor empotrado) XeLaTeX+PDF (Okular) Esto debera ser suciente para cualquier situacin para la que necesite una vista previa rpida.

9.2.2.

Modo entorno

Es frecuentemente que quiera previsualizar el entorno actual, y especialmente los entornos matemticos, que muchas veces pueden ser difciles de escribir. Kile ofrece una forma rpida de hacer esto. No se necesita seleccin, solo escoja Generar Vista previa rpida Entorno o el acceso rpido de teclado Ctrl+Alt+P,E y el entorno actual se compilar y se mostrar.

44

Manual de Kile

9.2.3.

Modo subdocumento

Si tiene un proyecto muy grande con muchos documentos, compilar el proyecto completo no es buena idea, si solo ha hecho cambios en un documento individual. Kile es capaz de compilar y mostrar una vista previa del subdocumento actual. Toma el prembulo del documento maestro, y compila solo la parte actual cuando seleccione Compilar Vista previa rpida Subdocumento o el acceso rpido de teclado Ctrl+Alt+P,D.

9.2.4.

Modo grupo matemtico

El modo de vista previa del grupo matemtico le permite obtener la vista previa del grupo matemtico que est editando. Kile toma el prembulo de un documento maestro y solo compila el grupo matemtico en el que se encuentra el cursor cuando haya seleccionado Compilar Vista previa rpida Grupo matemtico o el acceso rpido de teclado Ctrl+Alt+P,M.

9.2.5.

Vista previa rpida en la barra inferior

En lugar de mostrar la vista previa en un documento nuevo Kile tambin puede congurarse para utilizar la barra inferior para las compilaciones de vista previa. Puede activar esta funcionalidad en el panel de conguracin de la vista previa rpida.

9.3.
9.3.1.

Formatos de archivos grcos

LA TE X y PDFLA TE X

PDFLA TE X cuando se utiliza con los paquetes graphics o graphicx, puede compilar correctamente archivos PNG y JPG en un DVI o PDF, pero no es capaz de manejar archivos EPS. Inversamente, el proceso de compilar con LA TE X a DVI y convertirlo a PS y tal vez a PDF soporta EPS, pero no soporta PNG ni JPG. Muchos usuarios desean crear documentos PDF, pero tambin desean utilizar el excelente paquete Pstricks para crear grcos PostScript, o desean utilizar la salida PostScript del software matemtico y cientco especco como Mathematica, Maple o MuPAD. Estos usuarios de LA TE X tienen que compilar primero PostScript, incluso si desean crear documentos PDF, ya que estos programas generan cdigo PostScript que PDFLA TE X no puede gestionar. Sin embargo, esto no es complicado y tambin se puede hacer con la ayuda de Kile.

9.3.2.

Conversin de grcos

Para saltarse este frustrante bucle, en el caso de que desee incluir tanto cdigo PostScript como archivos PNG o JPG, tiene las siguientes posibilidades: Si necesita un archivo en formato PS, pero tiene imgenes JPG o PNG, puede tambin simplemente usar PDFLA TE X con la salida DVI primero, y despus ejecutar en la lnea de rdenes dvips para crear el archivo PS. Puede ver que PDFLA TE X es una buena eleccin si sus fuentes no contienen cdigo PostScript. Puede convertir los archivos EPS a PNG u otros formatos con utilidades como Gimp o ImageMagick y emplear PDFLA TE X.

45

Manual de Kile

La mejor forma es convertir los grcos EPS a grcos PDF con epstopdf, que se incluye en la distribucin de TE X y utilizar PDFLA TE X. Genera grcos de alta calidad, e incluso puede controlar el resultado con alguna de las siguientes opciones:
- dAutoFilterColorImages = false - dAutoFilterGrayImages = false - sColorImageFilter = FlateEncode - sGrayImageFilter = FlateEncode - dPDFSETTINGS =/ prepress - dUseFlateCompression = true

Incluso mejor: si su sistema permite shell-escape, la conversin se puede hacer al vuelo. Todo lo que tiene que hacer es incluir el paquete epstopdf, que se incluye en todas las distribuciones de TE X, con la orden \usepackage{epstopdf}. Asumiendo que su cdigo es
\ includegraphics [ width =5 cm ]{ test . eps }

Dnde podr llamar a PDFLA TE X con la opcin --shell-escape, el grco test.eps se convertir automticamente a test.pdf. Esta conversin se realizar cada vez que ejecute PDFLA TE X. Si sus rdenes gracas se dan implcitamente:
\ includegraphics [ width =5 cm ]{ test . eps }

epstopdf comprueba si test.pdf se encuentra disponible, para saltarse este paso. Puede convertir en el sentido contrario, y utilizar LA TE X y la conversin a PS-PDF. Esto no siempre es una buena idea, ya que la encapsulacin en EPS de JPG y PNG puede provocar archivos mayores, que derivan en documentos innecesariamente grandes. Sin embargo, esto depende en gran medida de la utilidad grca que utilice, ya que EPS puede encapsular otros formatos grcos, pero no todas las aplicaciones soportan esto correctamente. Algunas podran intentar generar su imagen JPG con vectores y varios archivos de scripts, que produciran archivos gigantescos. La conversin de todos los formatos grcos a EPS puede realizarse por ImageMagick. Otro programa sencillo que ejecuta este proceso correctamente es jpg2ps. Tambin puede utilizar la conversin automtica. Todos los archivos grcos se convierten al vuelo a EPS y se insertan en el documento PS. Esta es una forma cmoda, pero tiene que congurar su sistema de forma adecuada. Esto se explica en la seccin Grcos EPS.

9.3.3.

Utilizar el archivo adecuado para cada imagen

EPS es un tipo de lenguaje de script de vectores grcos, que describe todas las lneas y puntos que conforman el grco. Mantiene un buen aspecto incluso cuando se aumenta su tamao ms all del predeterminado, y concuerda mejor con diagramas y grcos vectoriales producidos nativamente en PS, que tienen un aspecto limpio y claro manteniendo un tamao en bytes muy pequeo. PNG (o GIF, en desuso) es un formato de archivo con pocas prdidas, con una buena compresin y calidad. Es muy bueno para diagramas, escaneados de dibujos, o cualquier cosa cuya nitidez desee mantener. A veces no funciona bien cuando se utiliza para fotos. JPG es un formato con prdidas que comprime los archivos mejor que PNG al precio de algunas prdidas en el detalle de la imagen. Esto es por lo general irrelevante para fotos, pero puede causar mala calidad para diagramas, dibujos, y puede directamente hacer desaparecer algunas lneas delgadas. En esos casos, utilice EPS o PNG. Pero recuerde siempre: basura al principio, basura al nal! Ninguna conversin obtendr una imagen buena de una imagen mala. 46

Manual de Kile

9.4.

Grcos EPS

Los archivos grcos EPS son la forma tradicional de insertar archivos grcos en documentos LA TE X. Como las listas de correo estn llenas de preguntas relativas a grcos EPS, explicaremos algunos aspectos importantes y demostraremos cmo Kile los soporta.

9.4.1.

LA TE X y los grcos EPS

Si decide utilizar el tradicional LA TE X para generar salidas PS o PDF, probablemente tendr algunos problemas con los grcos. Debe utilizar grcos EPS (PostScript encapsulado), no archivos JPEG o PNG. Esto no debera ser ningn problema, ya que existen multitud de conversores como convert del excelente paquete ImageMagick. Pero, esto lleva su tiempo, por supuesto. Los archivos EPS se utilizan tanto por LA TE X como por el conversorDVI-PS: LA TE X explora el archivo EPS para determinar la lnea del borde, lo que le indica a LA TE X cunto espacio reservar para los grcos. El conversor DVI-PS lee a continuacin el archivo EPS e inserta el grco en el archivo PS. Esto tiene algunas implicaciones: LA TE X nunca leer el archivo EPS si se han especicado los parmetros relativos a los bordes en la orden de insercin del grco. Como LA TE X no puede leer archivos no ASCII, no podr leer informacin sobre los bordes a partir de archivos comprimidos o grcos no EPS. Los grcos EPS no se incluirn en el archivo DVI. Cmo los archivos EPS deben estar presentes cuando el archivo DVI se convierta a PS, los archivos EPS se deben acompaar de los archivos DVI si se mueven. Ahora podr llamar a LA TE X, y a un conversor DVI-PS como dvips para crear su documento PostScript. Si lo que desea es generar un documento PDF, debera ejecutar dvips con la opcin -Ppdf de forma que llame a ps2pdf. Podr encontrar muchos documentos describiendo esta solucin.

9.4.2.

El PostScript a travs de Kile

Kile le ayudar a obtener informacin de los bordes. Si tiene instalado el paquete ImageMagick, Kile extraer esta informacin del archivo EPS y le insertar como opcin. Este procedimiento tiene dos ventajas: La informacin aparecer en el dilogo, y no necesitar ser obtenida de nuevo por LA TE X. Y lo que es ms importante, se calcular la anchura y la altura, cuando se conozca su resolucin. Esta informacin se mostrar cerca de la parte superior del dilogo, y puede servir como pista cuando desee escalar el grco. Kile tambin soporta archivos EPS comprimidos con zip o gzip, que son mucho ms pequeos que los archivos EPS. Pero, esta caractersticas pueden nicamente utilizarse con una conguracin especial del sistema y un cambio de la conguracin grca local, tal y como se describe en la seccin Grcos de mapas de bits.

47

Manual de Kile

9.4.3.

El PostScript a travs de los grcos de mapas de bits

Si su sistema permite shell-escape, Kile tambin soporta una forma sencilla de incluir grcos de mapas de bits, si tiene congurado el sistema TE X de forma adecuada. No necesitar convertir los grcos JPEG y PNG, ya que esto se realizar automticamente cuando el archivo DVI se convierta a PS. LA TE X necesita alguna informacin sobre las extensiones de los archivos. El paquete graphic x busca un archivo graphics.cfg, que debe estar en su ruta de bsqueda de documentos para LA TE X. Busque unas entradas como:
\ DeclareGraphicsRule {. pz }{ eps }{. bb }{} % \ DeclareGraphicsRule {. eps .Z }{ eps }{. eps . bb }{} % \ DeclareGraphicsRule {. ps .Z }{ eps }{. ps . bb }{} % \ DeclareGraphicsRule {. ps . gz }{ eps }{. ps . bb }{} % \ DeclareGraphicsRule {. eps . gz }{ eps }{. eps . bb }{} %

y reemplace estas lneas con:

\ DeclareGraphicsRule {. pz }{ eps }{. bb }{} % \ DeclareGraphicsRule {. eps .Z }{ eps }{. eps . bb }{} % \ DeclareGraphicsRule {. ps .Z }{ eps }{. ps . bb }{} % \ DeclareGraphicsRule {. ps . gz }{ eps }{. ps . bb }{} % % cambiadas o reglas para nuevos grficos \ DeclareGraphicsRule {. eps . zip }{ eps }{. eps . bb }{ unzip -p #1} % comprimido con zip \ DeclareGraphicsRule {. eps . gz }{ eps }{. eps . bb }{ gunzip -c #1} % comprimido con gzip \ DeclareGraphicsRule {. jpg }{ eps }{}{ convert #1 eps :-} % \ DeclareGraphicsRule {. gif }{ eps }{. bb }{ convert #1 eps :-} % \ DeclareGraphicsRule {. png }{ eps }{. bb }{ convert #1 eps :-} % \ DeclareGraphicsRule {. tif }{ eps }{. bb }{ convert #1 eps :-} % \ DeclareGraphicsRule {. pdf }{ eps }{. bb }{ convert #1 eps :-} % PDF

EPS EPS

JPEG GIF PNG TIFF grficos

Podr encontrar este archivo, por ejemplo en Debian, en /etc/texmf/latex/graphics.cfg. Lo mejor es copiar este archivo a su ruta local de tex y cambiarlo. Consulte el manual de TE X para aprender cmo obtener una lista de sus carpetas TE X. Con este archivo de conguracin ser capaz de insertar grcos de mapa de bits y archivos EPS comprimidos con zip o gzip en LA TE X. La orden para la conversin es dvips. Cuando vea la orden de conversin se dar cuenta de que no se crean archivos extra. El resultado del proceso de conversin se redirige directamente al archivo PS. Lo nico que debe saber LA TE X es el tamao de los grcos, y por eso necesitaremos los bordes, que proporciona Kile. Algunos dicen que este camino es inseguro, usted tiene que decidir cmo trabajar. En cualquier caso, no necesita ningn cuadro con informacin, ya que Kile extraer esta informacin de los diferentes tipos de grcos.

9.4.4.

PDFLA TE X y los grcos EPS

Como ya se indic, PDFLA TE X no es capaz de manejar archivos grcos EPS, pero los conversores como epstopdf le pueden ayudar. La mejor forma es incluir el paquete epstopdf, al que le seguir el paquete graphicx.
\ usepackage [ pdftex ]{ graphicx } \ usepackage { epstopdf }

48

Manual de Kile

Ahora podr incluir grcos EPS, si ejecuta pdatex con la opcin --shell-escape, pero podemos hacerlo incluso mejor manejando archivos EPS comprimidos con zip o gzip. Nuevamente deberemos cambiar el archivo de conguracin grca graphics.cfg de forma similar a como ya se hizo. Esta vez buscaremos:
% pdfTeX ejecutndose en modo pdf \ ExecuteOptions { pdftex } %

y aadiremos algunas lneas.

% pdfTeX ejecutndose en modo pdf \ ExecuteOptions { pdftex } % \ AtEndOfPackage { % \ g@addto@macro \ Gin@extensions {. eps .gz ,. eps . zip } % \ @namedef { Gin@rule@ . eps . gz }#1{{ pdf }{. pdf }{ gunzip -c #1 | epstopdf -f >\ Gin@base . pdf }} % \ @namedef { Gin@rule@ . eps . zip }#1{{ pdf }{. pdf }{ unzip -p #1 | epstopdf -f >\ Gin@base . pdf }} % }%

Con estas lneas, PDFLA TE X ser capaz de manejar archivos EPS, y esperamos que no tenga ms problemas con los grcos.

9.5.

Documento maestro

Denir su documento como maestro le permite trabajar con archivos separados, lo cual le proporciona un documento padre (o documento maestro) y documentos hijos que se complementan en su trabajo. Despus de haber denido su documento maestro con el correspondiente orden en el men Preferencias, todas las rdenes del men Herramientas tendrn aplicacin solo en este documento, incluso cuando est trabajando en los documentos hijos. Puede incluso cerrar el documento maestro.

9.6.

Manejo de errores

Tras compilar algo, Kile echa un vistazo a los mensajes de error generados. Si hay algn error o aviso, se resumir brevemente en la ventana de Registro y mensajes. Se puede profundizar ms en los mensajes seleccionando Compilar Ver archivo de registro, o utilizando el acceso rpido de teclado Alt-0. El registro generado se mostrar entonces en la ventana de Registro y mensajes, con los errores y los avisos resaltados.

49

Manual de Kile

Viendo el registro Puede fcilmente saltar de un mensaje a otro en el archivo de registro utilizando los elementos del men Generar Siguiente / Anterior error /aviso de LaTeX, o utilizando los botones de la barra de herramientas correspondientes. Para saltar a la lnea en el documento fuente LA TE X en la que se produjo el error o aviso, pulse en el error o aviso en la ventana de Registro y mensajes. Kile le llevar automticamente a la lnea en cuestin.

9.7.

El modo de vigilar archivo

Cuando ejecute la orden de Construccin rpida, normalmente ser invocado un visor de algn timpo tras la compilacin. Si no est utilizando un visor empotrado, cada vez se abrir una nueva ventana. Si est ajustando el aspecto de su documento, podra ocurrir que ejecutara Construccin rpida muy a menudo, y tener muchas ventanas del visor abiertas en su escritorio. Para evitar esta confusin, puede activar el Modo de vigilar archivo, que evitar que Construccin rpida ejecute un visor. Este modo carece de utilidad con los visores empotrados, ya que tiene que cerrarlos de todas maneras para volver a editar el documento y recompilar.

50

Manual de Kile

Captulo 10

Navegando por el cdigo fuente L A TE X

10.1. Utilizando la vista de estructura

La vista de Estructura muestra la jerarqua del documento que est siendo creado en Kile, y le permite rpidamente navegar a travs de l, mostrando sus diferentes partes. Para moverse por su documento, todo lo que necesita es pulsar con el botn izquierdo del ratn en cualquier etiqueta, captulo, seccin, subseccin, etc., y ser llevado al principio del rea correspondiente. Si incluy un archivo LA TE X en su cdigo fuente empleando las etiquetas \input o \include, estos archivos sern referenciados en la vista de Estructura. Si pulsa dos veces en sus nombres, Kile mostrar el archivo incluido en la ventana del editor. El rbol jerrquico tiene tambin una rama separada para etiquetas utilizadas en el texto.

10.1.1.

Usando el men contextual

La mayora de las entradas en la vista de estructura tienen un montn de opciones en el men contextual, que puede abrir haciendo click derecho con el ratn. Mire la vista de estructura en la siguiente imagen.

51

Manual de Kile

Encontrar algunas etiquetas, algunas entradas de seccin, un entorno de guras y tres imgenes. Si hace click derecho en una de las entradas de seccin, surgir un men con algunas rdenes tiles. Todas las rdenes como Seleccionar, Eliminar o Comentar funcionarn con todas las lneas que pertenezcan a esta seccin.

Hacer click sobre una entrada de gura o de tabla ofrecer algunas acciones con respecto a las referencias, y un click derecho en una entrada de grcos mostrar programas para abrirlos.

52

Manual de Kile

10.1.2.

Actualizando la vista de estructura

Para actualizar su vista de estructura puede o ir a Editar Actualizar estructura, pulsar F12, o guardar su documento, lo que har que Kile actualice su vista de Estructura.

10.2.

Marcadores

Los marcadores son su referencia a un segmento de texto o una lnea dentro del entorno de Kile. Para utilizar un marcador, seleccione una lnea especca de su documento a la que le gustara volver. Entonces pulse Ctrl-B, y Kile aadir un marcador a esta lnea. Tambin puede jar un marcador resaltando una lnea y eligiendo el men Marcadores Cambiar marcador. Para eliminar todos sus marcadores seleccione Marcadores Borrar todos los marcadores.

53

Manual de Kile

Captulo 11

Proyectos
11.1. Trabajando con proyectos

En Kile puede crear y trabajar con proyectos. Un proyecto es un grupo de LA TE X, grcos, BibTE X u otros documentos que entre todos contienen la informacin que se utilizar para completar su documento. Un proyecto tpico consistira en varios captulos escritos en diferentes archivos .tex. Todos ellos se incluiran en un mismo proyecto, para facilitar el manejo del documento que conforman. Las especicaciones de un proyecto se guardan en un archivo especial, con extensin .kilepr. Un proyecto aade las siguientes funcionalidades: No necesita congurar un documento maestro: Kile lo hace automticamente. Los archivos de proyecto se pueden archivar juntos con facilidad a travs de la opcin Proyecto Archivar La vista de Archivos y proyectos muestra qu archivos estn incluidos en el proyecto. Despus de abrir un proyecto, cualquier archivo que hubiera abierto se restaurar con la codicacin y el resaltado originales. El completado de cdigo funciona con todos los archivos del proyecto. El completado de referencia funciona con todos los archivos del proyecto. El completado de citas funciona con todos los archivos del proyecto. Buscar en todos los archivos del proyecto. Especica la orden personalizada quickbuild y makeidx. Puede encontrar todas las rdenes relacionadas con el proyecto en el men Proyecto. Desde ah puede abrir, cerrar y gestionar sus proyectos.

11.2.

Creando un proyecto

Para crear un proyecto, seleccione Proyecto Nuevo proyecto... Se le preguntar la siguiente informacin para crear su proyecto: Ttulo del proyecto. 54

Manual de Kile

Nombre del archivo de proyecto con extensin .kilepr. Nombre de archivo. Tipo de archivo creado: documento vaco (empty document), artculo (article), libro (book), carta (letter), informe (report)... Cuando rellene el campo nombre de archivo, debe incluir una ruta en la que se encuentre el archivo del proyecto .kilepr.

11.3.

La vista de archivos y proyectos

La vista de Archivos y proyectos es un botn del men de la barra lateral. Desde esta vista, puede ver la estructura de su proyecto, sus archivos, y el nombre del archivo .kilepr que guarda la informacin del proyecto. Las opciones para aadir, eliminar o cambiar en su proyecto se realiza mediante la vista de Archivos y proyectos.

La vista de archivos y proyectos

11.4.

Aadir y eliminar archivos

Para aadir un archivo a su proyecto, abra cualquier archivo TE X, pulse con el botn derecho en su nombre en la vista de Archivos y proyectos, y seleccione Aadir a proyecto. Si tiene varios proyectos abiertos, un cuadro de dilogo le preguntar a qu proyecto debe aadirse. Puede tambin pulsar con el botn derecho del ratn en el nombre del proyecto en la vista de Archivos y proyectos, y seleccionar Aadir archivos... para mostrar el dilogo de seleccin de archivos.

55

Manual de Kile

Aadir un archivo a un proyecto Para eliminar un archivo de un proyecto, pulse con el botn derecho sobre l y seleccione Eliminar archivo. Esto no elimina su archivo, solo lo quita de la lista de archivos contenida en el archivo .kilepr.

11.4.1.

Guardar su proyecto en un archivo comprimido

Kile le permite hacer fcilmente una copia de respaldo de su proyecto almacenando todos sus archivos en un nico archivo comprimido (habitualmente conocido como tarball). Para archivar un proyecto, pulse con el botn derecho del ratn en el nombre del proyecto (en la vista de Archivos y proyectos), o seleccione Proyecto Archivar. De forma predeterminada, se aadirn todos los archivos de un proyecto. Si no quiere incluir alguno en el archivo, pulse en l con el botn derecho en la vista de Archivos y proyectos, y deseleccione la opcin de Incluir en el archivo. La operacin de archivado se realiza actualmente ejecutando la orden tar desde la carpeta del proyecto (donde se encuentra el archivo .kilepr

11.5.

Opciones del proyecto

Kile tiene algunas opciones relacionadas con su proyecto que pueden ser conguradas. Para cambiarlas, pulse con el botn derecho del ratn en el ttulo de su proyecto y seleccione Opciones del proyecto, y tendr la opcin de cambiar: El ttulo de su proyecto. Extensiones de archivo por defecto. El documento maestro. La orden para compilacin rpida. Las opciones makeidx. 56

Manual de Kile

11.6.

Cerrando un proyecto

Para cerrar un proyecto, seleccione la vista de Archivos y proyectos de la barra de herramientas vertical, pulse con el botn derecho del ratn en el ttulo del proyecto y seleccione Cerrar. Esto cerrar su proyecto y todos los archivos asociados con su proyecto y tambin aadir el nombre del proyecto que acaba de cerrar a Abrir un proyecto reciente... en el men Proyecto.

57

Manual de Kile

Captulo 12

Codicacin del documento

El editor de Kile le permite leer, convertir y congurar el texto a la codicacin que su documento necesite. Esto le permite utilizar smbolos y letras no estndar. Puede utilizar, por ejemplo, caracteres acentuados para el italiano o el francs. Puede seleccionar la codicacin de su documento de dos maneras: Otra forma de establecer la codicacin del documento es utilizar el submen Preferencias Congurar Kile... Editor, donde podr establecer la codicacin de caracteres predeterminada para todos los archivos.

Una segunda forma de establecer la codicacin del documento es elegir la codicacin deseada desde el asistente para crear un nuevo documento. LA TE X en s mismo solo comprende ASCII, que representa un conjunto de caracteres muy limitado. Por lo tanto, no es posible utilizar directamente caracteres acentuados. Para usarlos a pesar de ello, se invent una sintaxis especial: como por ejemplo \e para . El paquete inputenc se encuentra disponible para ayudarle con esto. Se incluye en el prembulo utilizando \usepack age[latin1]{inputenc}, donde el argumento opcional especica la codicacin que desea utilizar (en la actualidad la ms usada es utf8). Esto le dice a LA TE X que traduzca todas las que usted escriba a \e antes de realizar la compilacin. Por favor, consulte la documentacin de inputenc para ms informacin. Por ltimo, pero no menos importante: recuerde estar seguro

58

Manual de Kile

de que su archivo realmente est guardado con la misma codicacin que haya especicado para el paquete inputenc. Esta multitud de diferentes tablas de codicacin de caracteres ha generado numerosos problemas: por ejemplo, no puede escribir un curso de turco en francs sin perder los caracteres especiales de uno de los idiomas. Hay una aceptacin general de que, ms tarde o temprano, todo el mundo se cambiar a Unicode. Existen muchas implementaciones de Unicode, y UTF-8 es la ms utilizada en Linux; Windows(R) en cambio se basa en la ms incmoda y menos exible UCS2. La mayora de las distribuciones ya han empezado a denir su codicacin predeterminada como UTF-8, y por lo tanto usted podra estar muy interesado en utilizar utf8 como argumento para el paquete inputenc.

12.1.

El paquete ucs

Si no tiene instalado el paquete ucs puede proceder de la siguiente forma: Obtenga el paquete ucs desde CTAN. Para instalarlo, desempaquete el archivo descargado y colquelo en un directorio listado en su variable de entorno $TEXINPUTS. Tambin lo puede hacer dentro de kile.
\ usepackage { ucs } \ usepackage [ utf8 ]{ inputenc }

12.2.

XeLaTeX

Si est utilizando XeLaTeX, puede cargar simplemente el paquete xltxtra. Cargar todos los paquetes requeridos.
\ usepackage { xltxtra }

12.3.

Soporte CJK

Aadir soporte para idiomas ideogrcos es un poco difcil. Sin embargo, una vez que lo haya conseguido, funcionar bastante bien. Instalar otros paquetes le permitir trabajar con conguraciones extra.

SUGERENCIA
Su distribucin Linux puede contener ya algn paquete de CJK (chino, japons, coreano) preparado, y por tanto no vale la pena que lo instale de forma manual. Comprubelo antes seguir adelante!

Existe la posibilidad de utilizar el paquete ucs para escribir pequeos trozos de texto de CJK, pero esta opcin est muy limitada y no podr manejar, entre otras cosas, lneas nuevas. No obstante instalar el paquete completo CJK-LA TE X y har que funcione para ambos, para LA TE X y para PDFLA TE X. Gran parte de este material est inspirado en la pgina sobre como congurar PDFLATEX de Pai H. Chou. 1. Descargue el paquete CJK. Copie los archivos desempaquetados a una subcarpeta apropiada de $TEXTMF, y haga lo mismo que en el caso del paquete ucs (Vea Seccin 12.1). Los archivos sern desempaquetados en una carpeta CJK/X_Y.Z, aunque esto no es importante una vez que los haya desempaquetado, aunque probablemente su mantenimiento s sea ms ordenado y fcil. 59

Manual de Kile

2. A continuacin debe descargar un tipo de letra que soporte todos los caracteres de CJK que necesite. Puede elegir cualquier archivo *.ttf que necesite, aunque en este caso utilizaremos Cyberbit. Descomprima el archivo y renombre Cyberbit.ttf a cyberbit.ttf, puesto que las maysculas pueden confundir al sistema. Coloque cyberbit.ttf en una carpeta con Unicode.sfd, y genere los archivos *.tfm y *.enc con la orden $ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@. Por alguna razn, algunas veces esto no proporciona los cientos de archivos necesarios. Si este es su caso debera descargar los archivos *.tfm y *.enc. Coloque los archivos *.tmf en una carpeta adecuada, como $TEXMF /fonts/tfm/bitstrea m/cyberbit/ . Los archivos *.enc se instalarn en $TEXMF /pdftex/enc/cyberbit/ . 3. Ahora necesitamos un archivo de mapa para conectar los archivos *.enc con la fuente. Descargue cyberbit.map e instlelo en $TEXMF /pdftex/config/ . 4. Descargue otro archivo, c70cyberbit.fd, y colquelo en la carpeta adecuado. Puede seleccionar, por ejemplo, $TEXMF /tex/misc/ . 5. El ltimo archivo que debemos generar es un tipo de letra PostScript de Tipo 1, necesaria para leer los archivos DVI generados con LA TE X. Ejecute la orden $ ttf2pfb cyberbi t.ttf -o cyberbit.pfb, y copie el resultado cyberbit.pfb en una carpeta, como por ejemplo, $TEXMF /fonts/type1/cyberbit/ . 6. Coloque ahora cyberbit.ttf en un lugar en el que LA TE X pueda encontrar este tipo de letra. Puede colocarla, por ejemplo, en una carpeta llamado $TEXMF /fonts/truetype/ . 7. Verique el archivo de conguracin que se encuentra en $TEXMF /web2c/texmf.cnf, y asegrese de que la lnea que contiene TTFONTS est descomentada y apunte a la carpeta en que haya guardado cyberbit.ttf. 8. Para hacer posible que PDFLA TE X utilice sus fuentes CJK, es necesario aadir la siguiente lnea al archivo de conguracin $TEXMF /pdftex/config/pdftex.cfg. Aada map +cybe rbit.map al archivo para completar la conguracin para PDFLA TE X. 9. Para congurar LA TE X y poder generar archivos DVI con caracteres CJK, debe aadir una lnea al archivo ttfonts.map. El archivo puede encontrarse en una carpeta llamada $TEXMF /ttf2pk/ , aunque probablemente deba buscarlo. Aada la lnea cyberbit@Unicode@ cyberbit.ttf en l. 10. A continuacin ejecute la orden texhash y el sistema debera estar listo. Para vericar si su conguracin es correcta, puede intentar compilar este archivo de test.

12.3.1.

Problemas con CJK

Existen algunas cosas que pueden ir mal cuando se congura el soporte CJK de forma manual. Si algunas cosas parecen no funcionar, la siguiente lista puede ayudarle. Obviamente, si ejecuta LA TE X como usuario y no como root, debe permitir a los usuarios normales acceder a los archivos nuevos. Asegrese de que todos los archivos y carpetas estn accesibles utilizando la orden chmod. Si LA TE X escribe un DVI sin problemas, pero no puede verlo, es posible que existan problemas en la generacin automtica de los tipos de letra *.pk. Se supone que se generarn al vuelo cuando se est viendo un archivo DVI, pero esto puede fallar por una serie de razones: Verique nuevamente ttfonts.map de la primera lnea personalizada. Puede suceder que su orden ttf2pk, que suele ser llamada por el visor DVI se haya compilado sin soporte para las bibliotecas kpathsea. Si este es su caso ttf2pk --version har que no se creen referencias a kpathsea. Como el soporte para estas bibliotecas es necesario, debera encontrar un paquete nuevo, o recompilar FreeType 1 por s mismo. 60

Manual de Kile

12.3.2.

Cmo puedo hacer entradas CJK en Unicode?

Existen diferentes motores de entrada, y escoger entre uno u otro depender de sus preferencias personales. El autor utiliza Skim, que se ha portado a KDE a partir del motor Scim. Vea la documentacin de su distribucin para aprender cmo instalar estos programas. La conguracin de estos programas puede ser complicado, en el caso de Skim debe denir la variable de entorno XMODIFIERS=@im=SCIM antes de iniciar las X.

61

Manual de Kile

Captulo 13

Crear guiones
13.1. Guiones en Kile

La funcionalidad de guiones para Kile permite la ejecucin de cdigo ECMAScript. Los guiones se pueden administrar a travs del panel de guiones de la barra lateral.

13.2.

Referencia del API

En esta seccin descibimos la interfaz de programacin de guiones para Kile.

IMPORTANTE
Tenga en cuenta que el API de guiones todava no se ha terminado. El API descrito a continuacin puede cambiar en futuras versiones de Kile.

En primer lugar, el entorno de ejecucin de guiones de Kile proporciona un objeto global llamado kile, que contiene los siguientes mtodos: (kile).currentTextDocument() Devuelve un objeto KileTextDocument que reeja el documento de texto activo actual. Devuelve null si no hay documento de texto activo. (kile).getInputValue((ttulo, , etiqueta)) Abre un dilogo con el ttulo y la etiqueta. Devuelve el valor que ha introducido el usuario. Los objetos del tipo KileTextDocument representan los documentos de texto en Kile. Tienen las siguientes propiedades: (KileTextDocument).backspace() Borra el caracter que se encuentra localizado inmediatamente antes de la posicin del cursor actual y mueve el cursor una posicin hacia atrs en el texto. (KileTextDocument).cursorLeft() Mueve el cursor una posicin hacia atrs en el texto. (KileTextDocument).cursorRight() Mueve el cursor una posicin hacia delante en el texto. 62

Manual de Kile

(KileTextDocument).insertText((texto)) Inserta el texto contenido en la variable texto en el documento en la ubicacin actual del cursor. (KileTextDocument).insertBullet() Inserta una vieta en la posicin actual del cursor. (KileTextDocument).nextBullet() Selecciona la primera vieta que haya en el documento inmediatamente despus de la posicin actual del cursor. (KileTextDocument).previousBullet() Selecciona la primera vieta que haya en el documento inmediatamente antes de la posicin actual del cursor. (KileTextDocument).up() Mueve el cursor una lnea hacia arriba en el documento. (KileTextDocument).down() Mueve el cursor una lnea hacia abajo en el documento. (KileTextDocument).cursorLine() Devuelve la lnea en la que se encuentra el cursor. (KileTextDocument).cursorColumn() Devuelve la columna en la que est situado el cursor. (KileTextDocument).setCursorLine((lnea)) Mueve el cursor a la lnea nmero lnea. (KileTextDocument).setCursorColumn((columna)) Mueve el cursor a la columna nmero columna.

63

Manual de Kile

Captulo 14

Ayuda
14.1. Documentos de ayuda

LA TE X es un sistema sosticado en el que las funcionalidades bsicas se pueden expandir a travs de una gran variedad de paquetes adicionales. Kile proporciona mucha ayuda diferente para dar asistencia al usuario. Referencia de LaTeX Un ndice alfabtico con la mayor parte de las rdenes comunes de LA TE X. Documentacin de TeX teTE X/TeX Live incluye una cantidad enorme de documentos de ayuda. Esto incluye la documentacin para todos los paquetes incluidos y una referencia adicional de LA TE X. LaTeX Una referencia completa para TE X y compaa. No es solo una descripcin de todos los programas, sino que tambin se mencionan algunos paquetes importantes. Incluye un manual de referencia completo de las rdenes LA TE X ideal para buscar un formato concreto mientras escribe un documento. Como este documento es realmente extenso, Kile lo separa en tres apartados. rdenes LaTeX Otro ndice alfabtico de las rdenes ms importantes de LA TE X. Asunto LaTeX Una descripcin de los asuntos importantes de LA TE X. Entorno LaTeX Un ndice alfabtico de los entornos ms importantes de LA TE X.

14.2.

Ayuda sensible al contexto

Kile tambin soporta ayuda sensible al contexto, que se llama con Ctrl+Alt+H,K. En Preferencias Congurar Kile... Kile+Ayuda puede seleccionar si desea utilizar la referencia LA TE X de Kile o la ayuda del sistema de teTE X/TeX Live, que es la conguracin predeterminada.

64

Manual de Kile

14.3.

Buscando palabras clave

No es siempre sencillo encontrar el documento correcto, ya que teTE X/TeX Live incluye una cantidad enorme de documentos de ayuda. Como posible ayuda, teTE X/TeX Live proporciona un pequeo programa, texdoctk. Este incorpora una base de datos con todos los documentos de ayuda, para lo que Kile ofrece una sencilla interfaz de usuario.

Todos los documentos se agrupan en categoras. Adems, se puede buscar por el nombre del paquete o por palabras clave. Kile mostrar solo los documentos de ayuda que coincidan con la cadena de bsqueda.

65

Manual de Kile

Una doble pulsacin del ratn o la tecla Espacio iniciar el visor para el documento seleccionado. Este puede ser cualquier documento, no solo un documento DVI, PS, PDF o HTML. Kile utilizar la conguracin de KDE para iniciar el visor adecuado.

14.4.

Ayuda denida por el usuario

Adems de la documentacin esttica de teTE X/TeX Live , Kile soporta tambin otra va ms exible para los documentos de ayuda del usuario. En el men de Ayuda de Kile se encuentra un submen especial Ayuda de usuario, en el que el usuario puede aadir aquellos documentos que l mismo elija. Estos pueden ser ms importantes que la documentacin de teTE X/TeX Live , e incluso documentos escritos por l mismo. Incluso es posible introducir URL. Vaya a Preferencias Congurar Kile... Kile+Ayuda y seleccione el botn Congurar para congurar este men de Ayuda de usuario. Podr aadir, eliminar o navegar por las entradas del men, as como insertar separadores para obtener una estructura mejor.

66

Manual de Kile

Pulsando el botn Aadir se abrir otro dilogo en el que podr editar el nombre de la entrada de men, y seleccionar el correspondiente archivo o URL de la web. El segundo botn a la derecha del campo de texto inicia Konqueror, que se puede usar para determinar la URL; correcta.

Despus de terminar la conguracin, todas las entradas elegidas aparecern en el men Ayuda de Kile como la entrada especial del men Ayuda del usuario.

67

Manual de Kile

68

Manual de Kile

Captulo 15

Crditos y licencia
Kile es un programa de cdigo abierto amigable para el usuario para editar cdigo fuente LA TE X/TE X. Se ejecutar en sistemas con el entorno de escritorio KDE instalado. KDE est disponible para diversas arquitecturas, que incluyen Linux y otros sistemas similares a Unix. Damos muchas gracias a aquellos que se esfuerzan en continuar el proyecto Kile, y las muchas horas de contribucin realizadas por aquellos que sacrican su tiempo en desarrollar herramientas que todos podamos usar bajo la licencia GNU. Se puede encontrar informacin actualizada sobre los colaboradores en el dilogo Acerca de Kile en el men Ayuda. Muchas gracias a todos aquellos implicados! Traducido por Rafael Rodrguez Martn apt-drink@telefonica.net, Santiago Fernndez santi@kde-es.org, Kira J. Fernndez kirajfdez@gmail.comy Ral Gonzlez raulgf83@gmail.com. Esta documentacin est sujeta a los trminos de la Licencia de Documentacin Libre GNU. Este programa est sujeto a los trminos de la Licencia Pblica General GNU.

69