PDF de programación - Una introducción breve a JabRef

JabRef

ExpoLATEX 2014

Una breve introducci´on a

JabRef

Lic. Carlos Torres Ninahuanca

[email protected]

1.

Introducci´on

LATEX es un sistema de tipograf´ıa avanzado que usa el lenguaje TEX, un lenguaje y motor
de composici´on de texto. LATEX fue desarrollado inicialmente por Leslie Lamport hace tres
d´ecadas aproximadamente, mientras que TEX por Donald Knuth, matem´atico norteamericano
de prestigio internacional.

Actualmente la mayor´ıa de personas que usan una computadora o aparatos similares (tablet,
notebook, laptop, etc) para desarrollar sus trabajos, usan un procesador de textos espec´ıfico,
como por ejemplo Microsoft Word, que se basan en una estructura que se define como What
you see is what you get (WYSIWYG), es decir, que uno puede ver en tiempo real lo que
va ingresando a la computadora y ver el producto final al instante. Sin embargo, LATEX no
se define como WYSIWYG porque previo a la visualizaci´on del producto final, debemos
ingresar diversos comandos e instrucciones definidas mediante lenguaje TEX para componer
mediante macros definidos por LATEX un documento de calidad igual o superior que la mayor´ıa
de procesadores de textos comerciales en el medio. La calidad de LATEX es tan buena que
revistas de alto prestigio cient´ıfico lo utilizan y piden a sus aportantes escribir sus art´ıculos o
papers basados en este sistema. Al respecto, es necesario aprender a usar un sistema de referencia
bibliogr´afica acorde a necesidades espec´ıficas.

En este art´ıculo se desarrollar´a en forma breve una introducci´on al software de gesti´on de refe-
rencias conocido como JabRef (que usa la herramienta auxiliar a LATEX denominada BibTEX),
cuya caracter´ıstica principal reside en su interfaz simple pero muy potente para los objetivos
de un estudiante, docente, investigador y todo aquel que desee aprender a utilizar referencias
con facilidad. Es necesario mencionar que se dar´a una explicaci´on para usuarios del sistema MS
Windows y con el editor TexnicCenter.

2. La bibliograf´ıa por defecto

El sistema LATEX cuya instalaci´on carga por defecto un entorno de bibliograf´ıa denominado
thebibliography. Este entorno gestiona las refencias bibliogr´aficas ubic´andolas al final del
documento. La estructura del comando para este entorno es el siguiente

Carlos Torres

P´ag. 1

JabRef

ExpoLATEX 2014

\begin{thebibliography}{leyenda de muestra}

...
\bibitem[Leyenda]{Etiqueta} Texto
...
\end{thebibliography}

Figura 1: Formato de entrada bibliogr´afica

Veamos algunos ejemplos

\begin{thebibliography}{1}
\bibitem{Callejo:1993}

Callejo, M.(1993) \textit{Un club matem´atico para la

diversidad.} Col. Secundaria para todos. Narcea, Madrid.
\end{thebibliography}

Figura 2: Ejemplo 2.1 Formato de entrada del ejemplo

Figura 3: Ejemplo 2.2 Formato de salida del ejemplo

El el ejemplo 2.1 muestra una aplicaci´on del entorno thebibliography. Podemos ver que la
entrada va predecidida del comando \bibitem seguido de la etiqueta que la identificar´a. Para
citar una entrada determinada se utiliza el comando \cite{etiqueta}. Para el ejemplo 2.1,
el comando a utilizar ser´a \cite{Callejo:1993} y generar´a como resultado la figura (3). La
numeraci´on de las sucesivas entradas es generada de forma autom´atica por LATEX, salvo que se
indique lo contrario.

Carlos Torres

P´ag. 2

JabRef

ExpoLATEX 2014

3. Gestionar la bibliograf´ıa

El uso del entorno thebibliography tiene los siguientes incovenientes:

1. El usuario es responsable de que el formato de todas y cada una de las entradas bibliogr´afi-
cas sea acorde al formato exigido o deseado seg´un el destino del documento. Asimismo,
es tambi´en el responsable de que todas las referencias guarden un formato uniforme. En
caso de querer cambiar alg´un aspecto del formato, el usuario deber´a corregir manualmente
todas y cada una de las entradas.

2. El usuario es responsable de ordenar las entradas ya sea por orden alfab´etico o por orden

de aparici´on en el texto.

3. La diversidad de formatos bibliogr´aficos es muy limitada. Es necesario cargar otros pa-
quetes, como por ejemplo el paquete apacite cuyo comando \usepackage{apacite} nos
permite utilizar el sistema de referencia APA.

Sin embargo, existe otra posibilidad para resolver el problema de la gesti´on de las referencias
bibliogr´aficas. Se trata de generar una especie de registro o base de datos con todas las referencias
que puedan ser de utilidad y al que LATEX (a trav´es de una herramienta asociada llamado
BibTEX) busque las ´unicas entradas que se necesite. Asimismo, en esta base de datos se se˜nala,
en forma separada, los elementos que componen una entrada (nombre y apellido del autor, t´ıtulo,
a˜no, editorial, ...) seg´un el estilo de cita a usar ya sea APA, Chicago, MLA, CBE, etc.

Las bases de datos son archivos de texto plano, con extensi´on .bib y con un formato determi-
nado. Estos datos se pueden modificar manualmente, pero es mejor y m´as sencillo utilizar un
instrumento espec´ıfico para este trabajo. Una opci´on altamente recomendada es JabRef.

4. Primeros pasos con JabRef

JabRef es una gestor de referencias bibliogr´aficas que genera archivos .bib utilizados por LATEX.
Se trata de un programa de software libre disponible para los sistema operativos m´as usuales
(GNU/Linux, MAC OS X y MS Windows).

El programa puede descargarse libremente desde su p´agina web http://jabref.sourceforge.
net/download.php haciendo clic en el bot´on Download latest stable version. Tras una sencilla
instalaci´on, al ejecutarlo por primera vez obtendremos simplemente la ventana mostrada en la
figura 4.

4.1. Creaci´on de archivo .bib con JabRef

Primero debe crearse una base de datos haciendo clic en el bot´on nuevo (New BibTEXdatabase).
Ahora ya puede generarse una entrada bibliogr´afica haciendo clic en el bot´on nueva entrada
(New BibTEXentry). Al hacerlo, surgir´a el cuadro de di´alogo mostrado en la figura 5 que permite
seleccionar el tipo de entrada de entre numerosas posibilidades. Al seleccionar una de ellas,

Carlos Torres

P´ag. 3

JabRef

ExpoLATEX 2014

Figura 4: Interfaz inicial de JabRef

JabRef solicita ´unicamente los campos relevantes a la selecci´on. La figura 6 muestra la ventana
del programa durante el proceso de creaci´on del archivo .bib de un art´ıculo de investigaci´on.

Figura 5: Cuadro de di´alogo para la selecci´on de nueva entrada

Un campo de vital importancia que debe caracterizar a todos los documentos a citar es el
campo Bibtexkey. Aqu´ı debe indicarse la etiqueta del documento, que servir´a posteriormente
para citarlo utilizando el comando \cite{etiqueta}. El texto de la etiqueta es de libre elecci´on,
pero debe intentarse que sea lo m´as informativo posible para facilitar la elaboraci´on posterior
del documento.

La base de datos debe ser guardada en un archivo .bib en la misma carpeta del archivo TEX en
cual se citan los documentos del archivo .bib, posteriormente esta podr´a ser abierta y modificada
en cualquier momento utilizando JabRef, otras aplicaciones similares, o incluso de forma manual.

Carlos Torres

P´ag. 4

JabRef

ExpoLATEX 2014

Figura 6: Seleccionar un documento a citar

4.2. Caracteres a tener en cuenta

Siguiendo el ejemplo de la figura 6, es necesario indicar que se debe utilizar camandos especiales
para caracteres que son de uso exclusivo de un idioma determinado. As´ı para los casos m´as
comunes, por ejemplo los acentos, di´eresis y la letra ˜n, se debe optar por utilizar comandos
espec´ıficos de LATEX. Siguiendo los ejemplos anteriormente mencionados se presenta {\’a} para
la tilde aguda sobre un car´acter, {\’’a} para la di´eresis y {\~n} para la ˜n.

Por otro lado, en diversas fuentes se encuentran listas de caracteres especiales que podemos
utilizar en LATEX as´ı como sus comandos respectivos (ver http://www.rpi.edu/dept/arc/
training/latex/LaTeX_symbols.pdf para tener una lista considerable.)

5. Especificar el estilo de bibliograf´ıa

Otro aspecto importante es el estilo de bibliograf´ıa autilizarse. Aqu´ı haremos una distinci´on
entre las opciones por defecto presentadas por LATEX y paquetes especiales para un estilo de
referencia espec´ıfico.

5.1. Estilo de referencia por defecto

LATEX muestra un estilo b´asico que se caracteriza primordialmente en el formato del campo
autores y JabRef permite hacer esa distinci´on al seleccionar una nueva entrada . Las principales
regla a tener en cuenta son las siguientes:

Carlos Torres

P´ag. 5

JabRef

ExpoLATEX 2014

En funci´on del estilo seleccionado para el documento, ser´a LATEX el encargado de dar
formato a los autores. El formato podr´a indicar que se especifique nombre y apellido
completos (Jeremy Kilpatrick), inicial punto apellido (J. Kilpatrick), apellido coma nombre
(Kilpatrick, Jeremy), etc. En todo caso, y para que LATEX pueda realizar este trabajo, la
entrada bibliogr´afica debe contener, en medida de lo posible, toda la informaci´on en el
formato indicado en los puntos siguientes.

El nombre puede indicarse de la forma Nombres Apellido (v´alido ´unicamente para un ´unico
apellido) o de la forma Apellido(s), Nombre(s). Esta ´ultima forma es la que debe utilizarse
siempre que el autor tenga m´as de un apellido, dado que en el caso de la primera forma,
s´olo la ´ultima palabra ser´a considerada apellido. Respecto al nombre, por el contrario,
pueden indicarse varios nombres en cualquiera de las formas.

En el caso de que existan varios autores, todos deben separarse entre s´ı utilizando la
palabra and, y como se ilustra en la figura 6.

5.1.1. Generaci´on de la bibliograf´ıa con BibTEX

Finalmente, una vez generado el archivo (o los archivos) .bib con todas las entradas bibliogr´afi-
cas necesarias, s´olo queda introducirlas en el documento y hacer que sea procesada por LATEX
realizando los siguientes pasos:

1 Citar los documentos. Se incluye en la bibliograf´ıa utilizando el comando \cite{etiqueta}.

´Unicamente ser´an introducidos en la bibliograf´ıa aquellas entradas citadas en el texto co-
rrespondiente. Existe tambi´en el comando \n