AT X Bibliograf a en L E

Una gu a concisa de BibTEX

Miguel Mata P erez miguel@yalma.fime.uanl.mx
Versi on 0.3, 23 de septiembre de 2011

A Resumen: L TEX es una poderosa herramienta para la edici on de documentos estructurados. AgreA gar una bibliograf a a un documento en L TEX tampoco es complicado. Existen cuando menos dos opciones: el entorno thebibliography y la herramienta BibTEX. Optar por una u otra depende de la naturaleza del trabajo que se est e realizando. En este documento se describen ambas en forma concisa, de tal manera que sirva como una referencia r apida. Es importante mencionar que este peque no manual A presupone que el lector est a familiarizado con los conceptos b asicos de L TEX.

Contenido

1. El entorno thebibliography 1.1. Algunas notas sobre el idioma . . . . . . . . . . . . . . . . . . . . . . . 1.2. Citas bibliogr acas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3. Compilaci on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. Usando BibTEX 2.1. Compilaci on . . . . . . 2.2. Creando archivos .bib 2.3. Campos . . . . . . . . 2.4. Tipos de entrada . . . 2.5. Notas importantes . . 2.6. Estilo de la bibliograf a 3. El paquete natbib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 2 3 4 4 5 5 6 7 9 11 12

El presente material es libre y puede ser usado, distribuido y comunicado bajo las u nicas condiciones de atribuci on (dar cr edito y citar apropiadamente) y no comercializaci on (no lucrar u obtener benecio alguno de su uso). Cualquier asunto relacionado con este material, si entase en libertad de ponerse en contacto con el autor en la direcci on de correo-e proporcionada.

A Bibliograf a en L TEX

1.

El entorno thebibliography

A El entorno thebibliography es nativo de L TEX y puede preferirse cuando el documento llevar a pocas citas bibliogr acas, cuando el documento pasar a por la edici on de diversas personas y se diculte la coordinaci on, o cuando no se dispone de una biblioteca para BibTEX con la bibliograf a requerida y, por alguna raz on, no se desea hacer una.

La bibliograf a deber a editarse directamente en el documento con el entorno thebibliography, que se colocar a en el lugar donde se desea que aparezca la bibliograf a. Cada entrada bibliogr aca se har a mediante la instrucci on \bibitem. Por ejemplo:
\begin{thebibliography}{X} \bibitem{Baz} \textsc{Bazaraa, M.S., J.J. Jarvis} y \textsc{H.D. Sherali}, \textit{Programaci on lineal y flujo en redes}, segunda edici on, Limusa, M exico, DF, 2004. \bibitem{Dan} \textsc{Dantzig, G.B.} y \textsc{P. Wolfe}, <<Decomposition principle for linear programs>>, \textit{Operations Research}, \textbf{8}, p ags. 101--111, 1960. \end{thebibliography}

Lo anterior crear a la siguiente salida en el documento. La numeraci on es creada por A L TEX, adem as del encabezado ((Referencias)).

Referencias
[1] Bazaraa, M.S., J.J. Jarvis y H.D. Sherali, Programaci on lineal y ujo en redes, segunda edici on, Limusa, M exico, DF, 2004. [2] Dantzig, G.B. y P. Wolfe, ((Decomposition principle for linear programs)), Operations Research, 8, p ags. 101111, 1960. El par ametro X al inicio del entorno es un n umero que no sea excedido por la cantidad de entradas bibliogr acas, en este caso podr a ser 9. Lo que se encuentra entre llaves despu es de cada \bibitem es una etiqueta con la cual se citar a la entrada bibliogr aca.

1.1.

Algunas notas sobre el idioma

El nombre de la secci on bibliogr aca que aparece en forma autom atica (en este caso ((Referencias))) depende del tipo de documento en que se est e trabajando y del idioma que se haya denido y puede ser sustituido por otro cualquiera empleando la instrucci on \renewcommand\refname{Nombre} (para documentos de clase article) y \renewcommand\bibname{Nombre} (para documentos de clase book).

A Bibliograf a en L TEX

En este documento se est a usando la opci on spanish del paquete babel (algo m as que recomendable para hispanohablantes), por ello aparece el encabezado ((Referencias)) en A espa nol, en lugar del t pico ((References)) ingl es dado por defecto en L TEX. De igual manera, spanish ha sustituido autom aticamente los signos << y >> por las comillas angulares ((( y ))). Cuando se carga spanish, se cuenta adem as con una manera integral para redenir el nombre de las referencias (y que evitar a posibles conictos) que es, para el caso de refname, \addto\captionsspanish{\def\refname{Nombre}} (igual para bibname).

1.2.

Citas bibliogr acas

Ahora, para hacer una cita bibliogr aca ha de usarse la instrucci on \cite{}.
Como se puede ver en \cite{Baz} ...

Con lo cual se obtiene el siguiente resultado. Como se puede ver en [1] ... Tambi en se pueden agregar algunas notas extras al citar una obra, por ejemplo
Como se puede ver en \cite[p ag 21]{Baz} ...

Con el siguiente resultado. Como se puede ver en [1, p ag. 21] ... La disposici on de las entradas y su formato est a completamente a nuestra libertad A (y responsabilidad). L TEX numerar a las entradas bibliogr acas seg un aparezcan en el entorno thebibliography. Conforme las entradas sean agregadas o quitadas de la lista, A L TEX actualizar a autom aticamente la numeraci on de las obras en la bibliograf a y en los lugares en que fueron citadas. Tambi en se pueden personalizar las claves con que aparecen las citas, agregando a cada entrada de la bibliograf a la clave deseada de la siguiente manera.
\bibitem[DanWol60]{Dan60} \textsc{Dantzig, G.B.} y ...

A Bibliograf a en L TEX

Ahora se produce el siguiente efecto al citarlo, se sigue citando igual (con la etiqueta asignada y no con la clave), en este caso \cite{Dan}. Como se puede ver en [DanWol60] . . .

1.3.

Compilaci on

Es importante hacer notar que para ver correctamente las citas bibliogr acas que se han hecho tal vez haga falta compilar dos o tres veces el documento. Esto, debido a que en una primera compilaci on se genera un archivo .aux donde se informan las citas hechas que despu es, en una segunda compilaci on, se traducen en los n umeros (o etiquetas) que A L TEX (o el usuario) ha asignado a dichas referencias.

2.

Usando BibTEX

A Tambi en se puede emplear BibTEX, una poderosa herramienta hermana de L TEX especialmente dise nada para el apoyo a la bibliograf a. Esta herramienta se recomienda para bibliograf as muy extensas o cuando algunos recursos se citan con frecuencia ya que el trabajo de capturar una referencia bibliogr aca se hace s olo una vez y se puede aprovechar tantas veces como sean necesarias en todos los documentos que se desee.

Lo u nico que necesitamos para emplear BibTEX es una biblioteca virtual, esto un archivo (o una colecci on de archivos) con extensi on .bib en el que se encuentra la bibliograf a que requiere nuestro documento (la creaci on de estos archivos se discutir a m as adelante). A estos archivos les llamaremos librer as. Despu es basta indicar en el documento las librer as que ser an usadas. Si son m as de una se deben separar por comas. Por ejemplo, supongamos que tenemos dos archivos donde se encuentra la bibliograf a a emplear, librero1.bib y librero2.bib, entonces, para indicar a BibTEX que la bibliograf a ha de buscarse en tales archivos es necesario agregar la siguiente linea.

\bibliography{librero1,librero2}

Y BibTEX agregar a de tales archivos s olo aquellas entradas que hallan sido citadas mediante un \cite{etiqueta}. Si, por alguna raz on, desea incluirse en la bibliograf a una entrada que no es citada puede emplearse la orden \nocite{etiqueta} la cual no aparecer a en el documento. Y si alguno quiere incluir indiscriminadamente toda la bibliograf a contenida en los archivos .bib, le bastar a colocar \nocite{*} en cualquier parte del documento.

A Bibliograf a en L TEX

2.1.

Compilaci on

Con una l ogica similar a la usada para la herramienta thebibliography, para compilar un documento en el que se usar a BibTEX se requiere compilar una o dos veces con latex el documento (.tex) seguido de compilar una o dos veces el archivo .aux que se genera pero esta vez con bibtex y despu es compilar nuevamente con latex, una o dos veces el archivo .tex. Finalmente se puede pasar el .dvi a PDF con la t ecnica usual. En el caso de que se est e usando un entorno gr aco para la edici on de documentos en A L TEX, es com un que existan botones u opciones en los men us para las compilaciones tanto de latex como de bibtex. En caso de que se haga desde consola, las instrucciones son:
> latex MiDocumento.tex > bibtex MiDocumento.aux > latex MiDocumento.tex

Y el resultado deseado debe ser satisfactoriamente obtenido.

2.2.

Creando archivos .bib

Como se dec a, un archivo .bib es una base de datos de entradas bibliogr acas, el cual contiene las referencias en determinado formato. Este archivo bibliogr aco, al igual que A cualquier documento de L TEX, debe estar escrito en texto plano, pero con la extensi on .bib. Por ejemplo, para agregar las entrada usadas en la secci on anterior (un art culo y un libro) al archivo, ha de hacerse como sigue:
@ARTICLE{Dan, author = {Dantzig, G.B. and P. Wolfe}, year = 1960, title = {Decomposition principle for linear programs}, journal = {Operations Research}, volume = 8, pages = {101--111} } @BOOK{Baz, author = {Bazaraa, M.S. and J.J. Jarvis and H.D. Sherali}, year = 2004, title = {Programaci\on lineal y flujo en redes}, edition = 2, publisher = {Limusa}, adress = {M\exico, DF} }

A Bibliograf a en L TEX

Cada entrada consiste de tres partes: el tipo de entrada (en este caso ARTICLE y BOOK); una etiqueta con que ha de citarse (en el ejemplo Dan y Baz); y los campos, es decir, la informaci on de la entrada. Los campos deben ser separados por comas, tambi en la clave debe ser seguida de una coma. Debe tenerse en cuenta que en este archivo debe emplearse la escritura est andar A de L TEX (atenci on con los acentos y otros signos) independientemente de los paquetes que se hayan cargado al documento.

2.3.

Campos

Para cada entrada debe denirse una serie de campos. Cada tipo de publicaci on contiene informaci on diferente, por ejemplo, un libro y una revista requieren diferentes campos. Para cada tipo de entrada los campos se dividen en tres clases. Requeridos: Si se omite un campo de este tipo se producir a un mensaje de advertencia y, algunas veces, el formato de la entrada en la bibliograf a ser a incorrecta. Si la informaci on de este campo no est a disponible, es posible que no est e empleando el tipo de entrada correcto por lo que quiz a ser a mejor cambiar de tipo o, en u ltima instancia, ignorar la advertencia. Opcional: La informaci on de un campo de este tipo ser a usada si est a disponible, pero puede ser omitida y no causar a el menor problema. Ignorado: La informaci on de un campo de este tipo ser a ignorada aunque est e disponible. Todo campo que no sea requerido u opcional ser a ignorado, por lo que no ser a agregado a la entrada bibliogr aca. Sin embargo, no es mala idea agregar tanta informaci on relevante como sea posible en una entrada. Por ejemplo, podr a agregarse el resumen, con lo cual el lector podr a hacer b usquedas bibliogr acas m as f acilmente consultando los archivos .bib. A continuaci on se describen los campos reconocidos por los estilos de bibliograf a est andares. Cualquier entrada puede incluir otros campos, los cuales ser an ignorados por esos estilos. address: Usualmente la direcci on de la editorial. author: Nombre(s) del (de los) autor(es). booktitle: T tulo del libro. chapter: El n umero de un cap tulo (o secci on, etc.). edition: La edici on de un libro, por ejemplo, segunda.

A Bibliograf a en L TEX

editor: Nombre(s) del (de los) editor(es). howpublished: Forma en que fue publicada la obra. institution: Instituci on responsable de un informe t ecnico. journal: Nombre del peri odico o revista. key: Empleado para la alfabetizaci on, referencias cruzadas y para crear una clave cuando la informaci on del autor no est a disponible. No debe confundirse con la etiqueta usada en el \cite y que debe colocarse al inicio de la entrada. month: El mes de publicaci on o, para un trabajo in edito, en el que fue escrito. note: Cualquier informaci on adicional que pueda ayudar al lector. number: El n umero del peri odico, la revista, el informe t ecnico o del trabajo en una serie. organization: La organizaci on responsable de una conferencia o que publica un manual. pages: N umeros de p aginas. publisher: El nombre de la editorial. No debe confundirse con el editor. school: Nombre de la escuela donde fue escrita una tesis. series: El nombre de una serie o conjunto de libros. title: El t tulo del trabajo. type: El tipo de un informe t ecnico. volume: El volumen de un peri odico o una revista, o de alg un libro que conste de vol umenes. year: El a no de publicaci on. Para un trabajo in edito, el a no en que fue escrito. Generalmente debe consistir de cuatro d gitos, por ejemplo 2007.

2.4.

Tipos de entrada

A continuaci on describimos los tipos de entrada. ARTICLE: Un art culo de un peri odico o una revista. Campos requeridos: author, title, journal, year. Campos opcionales: volume, number, pages, month, note.

A Bibliograf a en L TEX

BOOK: Un libro con una editorial expl cita. Campos requeridos: author o editor, title, publisher, year. Campos opcionales: volume o number, series, address, edition, month, note. BOOKLET: Un trabajo impreso y distribuido, pero que no tiene una editorial o instituci on responsable. Campos requeridos: title. Campos opcionales: author, howpublished, address, month, year, note. INBOOK: Una parte de un libro, como un cap tulo, una secci on, un rango de p aginas, etc. Campos requeridos: author o editor, title, chapter o pages, publisher, year. Campos opcionales: volume o number, series, type, address, edition, month, note. INCOLLECTION: Una parte de un libro con t tulo propio. Campos requeridos: author, title, booktitle, publisher, year. Campos opcionales: editor, volume o number, series, type, chapter, pages, address, edition, month, note. INPROCEEDINGS: Un art culo de las memorias de un congreso. Campos requeridos: author, title, booktitle, year. Campos opcionales: editor, volume o number, series, pages, address, month, organization, publisher, note. MANUAL: Documentaci on t ecnica. Campos requeridos: title. Campos opcionales: author, organization, address, edition, month, year, note. MASTERSTHESIS: Una tesis de maestr a. Campos requeridos: author, title, school, year. Campos opcionales: type, address, month, note. MISC: Para cuando el resto falla. Campos requeridos: Ninguno. Campos opcionales: author, title, howpublished, month, year, note. PHDTHESIS: Tesis de doctorado. Campos requeridos: author, title, school, year. Campos opcionales: type, address, month, note. PROCEEDINGS: Las memorias de un congreso. Campos requeridos: title, year. Campos opcionales: editor, volume o number, series, address, month, organization, publisher, note. TECHREPORT: Un informe publicado por una instituci on. Campos requeridos: author, title, institution, year. Campos opcionales: type, number, address, month, note. UNPUBLISHED: Un documento (in edito), con un autor y un t tulo, pero que no ha sido formalmente publicado. Campos requeridos: author, title, note. Campos opcionales: month, year.

A Bibliograf a en L TEX

2.5.

Notas importantes

Agregamos algunas notas que no debe dejar de leer para crear correctamente su archivo .bib. Autor: Las indicaciones que se dan en este apartado aplican para los campos author y editor, sin embargo, nos referiremos indistintamente como autor. En caso de ser m as de uno, cada par de autores debe separarse por la palabra reservada and, sin importar si son m as de dos. Si son demasiados, puede recurrirse a terminar la lista con un and others, y cualquier estilo est andar imprimir a un et al.1 Respecto a la forma de escribir el nombre de cada autor, es necesario aclarar que, para BibTEX cada nombre consiste de cuatro partes: Nombre, von, Apellido y Jr. Cada parte consiste de una lista (que puede ser vac a) de palabras. La parte Apellido deber a incluirse siempre que ninguna otra parte est e, de tal manera que cuando s olo una palabra aparece, esta ser a siempre la parte Apellido. En general, BibTEX permite tres formas de escribir el nombre: Nombre von Apellido von Apellido, Nombre von Apellido, Jr, Nombre La primera forma no debe usarse si hay una parte Jr o la parte Apellido tiene m as de una palabra y no hay parte von. Por ejemplo, el nombre de Juan Hern andez P erez deber a estar escrito como:
author = {Hern\andez P\erez, Juan},

De esta manera, la parte Nombre estar a dada por Juan; la parte Apellido estar a formada por dos palabras, Hern andez y P erez; mientras que las partes von y Jr est an vac as. Si en cambio se escribiera:
author = {Juan Hern\andez P\erez},

BibTEX tomar a (err oneamente) Juan y Hern andez como la parte Nombre y P erez como la parte Apellido.
1

La abreviatura et al. viene del lat n (y otros) y es aceptado en las publicaciones internacionales.

A Bibliograf a en L TEX

10

T tulo: Algunos estilos de la bibliograf a modican los t tulos colocando la inicial de cada palabra en may uscula (salvo algunas palabras, con reglas no siempre claras). Otros estilos hacen exactamente lo contrario, colocar cada letra que no sea la inicial del t tulo en min uscula. Ambos estilos suelen dar problemas pues en m as de una ocasi on debe respetarse la escritura de algunas palabras. Por ejemplo, siglas del tipo ONU, corren el riesgo de ser transformadas en Onu, o en onu; n umeros cardinales como XIII podr an sufrir un maltrato parecido. Para evitar este efecto, podemos colocar entre llaves aquellas formas que se desea sean respetadas tal como las colocamos. Ejemplos:
booktitle = {{XXXVIII} Congreso Nacional de la {SMM}}, organization = {Consejo Nacional de Ciencia y Tecnolog\ia ({CONACyT})},

Cabe mencionar que en el idioma espa nol s olo la primera palabra y los nombres propios deben iniciar con may uscula, por lo que iniciar cada palabra de un t tulo con may uscula es incorrecto. Esta regla debe observarse incluso si se est a citando una obra cuyo t tulo aparece con ese estilo. Como excepci on, se escriben con may uscula los sustantivos y adjetivos que forman parte del nombre de publicaciones peri odicas o de colecciones. Comentarios: En un archivo .bib el s mbolo % no es un caracter de comentario A como en L TEX, por lo que puede usarse directamente en caso de necesitarse. Ahora, para colocar un comentario en el archivo .bib, basta colocarlo sin signo alguno, pues BibTEX considera como comentario toda entrada que no inicie con una @. El campo key: Cuando se emplean determinados estilos bibliogr acos (como el alpha, ver la secci on 2.6), BibTEX suele construir la clave con la informaci on del campo author, por ejemplo, quedar a [Baz04] para nuestro primer ejemplo. Para los tipos en que no hay un autor, como MANUAL o PROCEEDINGS, la clave se construye con la informaci on del campo organization. Es com un que en estos casos se desee proponer una clave. Por ejemplo para una organizaci on como
organization = {The Association for Computing Machinery},

es muy com un que exista una abreviatura con la cual la organizaci on es reconocida, en este caso es preferible denir la entrada

A Bibliograf a en L TEX

11

key = {ACM},

Sin el campo key el estilo alpha tomar a las primeras tres letras de la organizaci on para construir la clave (ignorando el art culo), por lo que se crear a la desafortunada clave [Ass86]. Con el campo key, en cambio, la clave ser a [ACM86] lo cual ser a m as informativo para el lector. No siempre ser a necesario crear una clave con key, por ejemplo, la organizaci on
organization = {Unilogic, Ltd.},

puede razonablemente conservar la clave que se crear a por defecto, [Uni86]. Editores de archivos .bib: Existen varias herramientas que ayudan en la gesti on de librer as BibTEX, si no se desea hacer un archivo .bib a mano. Una herramienta de la que se suele hablar bien es BibDB, tambi en en su versi on WinBibDB. Disponibles en CTAN:support/bibdb, o bien en su p agina http://www.mackichan.com/BibDB/default.htm Otra herramienta popular es bibtex.el, que es el modo BibTEXpara emacs. Usualmente ya viene incluido con emacs. En todo caso se puede obtener en su p agina http://www.ida.ing.tu-bs.de/people/dirk/bibtex/

2.6.

Estilo de la bibliograf a

Las entradas que se agregar an se enlistar an seg un el estilo que sea denido. Para denir el estilo es necesario agregar la siguiente linea.
\bibliographystile{estilo}

Por defecto BibTEX cuenta con los siguientes estilos. plain Dispone las entradas de la bibliograf a por orden alfab etico. A cada una le asigna un n umero entre corchetes. unsrt Dispone las entradas en el orden con que se fueron citando con \cite o \nocite. alpha Ordena las entradas igual que plain pero los marcadores se construyen con una abreviatura del autor o autores y el a no de publicaci on.

A Bibliograf a en L TEX

12

abbrv Ordena las entradas igual que plain y construye los marcadores de la misma forma, pero en la indicaci on de la referencia se emplean abreviaturas para los nombres de pila, meses y, en ocasiones, los nombres de las revistas. Desafortunadamente los estilos predenidos de BibTEX tienen algunos inconvenientes. El primero que salta a la vista es que su idioma por defecto es el ingl es, por lo que, por ejemplo, en una lista de autores aparecer a and precediendo al u ltimo autor. Adem as, la disposici on de las partes de una entrada bibliogr aca (autor, t tulo, publicaci on, a no, etc.) son ordenadas seg un un est andar que no suele coincidir con el existente en otros idiomas, como el espa nol. Para remendar esto, uno puede crearse su propio estilo, un archivo con extensi on .bst. Esto se puede hacer a mano, lo cual requiere mayores conocimientos de TEX, o bien mediante la herramienta custom-bib que permite crear estilos al capricho (soporta idiomas), llenando un (nada breve) cuestionario, personalizando hasta el m nimo detalle, 2 pero de esto no hablaremos en este documento . Una vez que se tiene su propio archivo .bst, digamos miestilo.bst, el estilo tendr a el nombre del archivo, en este caso miestilo, por lo que la l nea para especicar el estilo pasa a ser \bibliographystile{miestilo}.

3.

El paquete natbib

En ocasiones se desea mayor versatilidad para construir las citas bibliogr acas, como por ejemplo, que al citar una referencia en lugar de colocar un n umero entre corchetes, se imprima el nombre del autor y el a no de publicaci on. El paquete natbib hace m as que satisfactoriamente esta y otras tareas. Para ello este paquete dene un par de instrucciones de citado: \citet y \citep. El siguiente ejemplo est a m as que inspirado en el manual de usuario del paquete.
\citet{jon90} \citep{jon90} \citet[cap. 2]{jon90} \citep[ver][]{jon90} \citep[ver][cap. 2]{jon90}

Jones et al. (1990) (Jones et al., 1990) Jones et al. (1990, cap. 2) (ver Jones et al., 1990) (ver Jones et al., 1990, cap. 2)

A Tambi en es posible usar alguno de los que han sido creados por la sociedad hispana ((L TEXera)) y que han puesto a disposici on general por la red, por ejemplo, en la p agina de CervanTEX. El autor de este modesto manual tambi en ha creado algunos.

A Bibliograf a en L TEX

13

Para poder usar el paquete natbib basta cargarlo en el pre ambulo de la forma usual, con la instrucci on \usepackage[opciones]{natbib}. Es posible combinar el uso del paquete natbib con un estilo bibliogr aco (.bst) denido por el usuario. Un par de opciones interesantes son sort y sort&compress. La opci on sort ordena citas m ultiples en la secuencia en que aparecen en la lista de referencias. La opci on sort&compress adem as comprime las citas, siempre que sean num ericas, por ejemplo, la cita m ultiple [4, 6, 15, 5, 3] quedar a transformada en [36, 15]. Para saber m as del paquete natbib y sus opciones (que son bastantes) se recomienda leer [Dal09].

Referencias
[Pat88a] Patashnik, Oren, ((BibTEXing)), documento btxdoc distribuido con el paquete BibTEX, 8 de febrero de 1988. [Pat88b] Patashnik, Oren, ((Designing BibTEX styles)), documento btxhak distribuido con el paquete BibTEX, 8 de febrero de 1988. [Dal09] Daly, Patrick W., ((Natural sciences citations and references (authoryear and numerical schemes))), documento natbib.pdf distribuido con el paquete natbib, versi on 8.31, 16 de julio de 2009.