% -*- mode: latex; coding: utf-8-unix; TeX-PDF-mode: t; fill-column: 78 -*- \documentclass[a4paper,11pt]{article} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage[english,spanish]{babel} \usepackage{mathptmx} \usepackage{helvet} \usepackage{enumerate} \usepackage{url} \usepackage[pdftex]{hyperref} \parskip=3pt\clubpenalty=10000\widowpenalty=10000 \footnotesep=\baselineskip \addtocounter{tocdepth}{-1} \def\btx-{\textsc{Bib\TeX}} \def\ltx-{\LaTeX} \def\ltr#1-{<<\texttt{#1}>>} \def\tpf#1-{\ltr.#1-} \def\cmd#1-{``\texttt{\textbackslash#1}''} \newcommand{\flecha}{\ensuremath{\rightarrow}} \hypersetup{ colorlinks = true, pdftitle = {Guía casi completa de BibTeX}, pdfauthor = {Joaquin Ataz López}, pdfsubject = {Uso de BibTeX para la gestión de las referencias bibliográficas en LaTeX.}, pdfkeywords = {LaTeX BibTeX}, } \begin{document} \renewcommand{\thefootnote}{\fnsymbol{footnote}} \title{Guía \emph{casi} completa de \btx-\footnotemark} \footnotetext[1]{Copyright \copyright{} 2006. Joaquín Ataz López.\\ \selectlanguage{english} Permisssion is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by de Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A Copy of the license is included in the section entitled ``GNU Free Documentation License''.\\\selectlanguage{spanish} \emph{Se otorga permiso para copiar, distribuir o modificar este documento en los términos de la Licencia GNU para Documentación Libre, versión 1.2 o cualquier versión postrior publicada por la Free Software Foundation; sin secciones invariantes, sin textos de la cubierta frontal y sin textos de la cubierta posterior. Una copia completa de la licencia (en inglés) se incluye en el apéndice titulado ``GNU Free Documentation License''}. } \author{Joaquín Ataz López} \date{Versión 1, \today\\\footnotesize Para sugerencias y correcciones: \texttt{jal@um.es}} \maketitle \renewcommand{\thefootnote}{\arabic{footnote}} \begin{abstract} \btx- es un programa auxiliar de \ltx-, diseñado para facilitar el manejo de la bibliografía. Pero es más que eso: es también una herramienta que permite a \ltx- extraer datos de una base de datos e insertarlos adecuadamente formateados en un documento. Este texto pretende abordar todos los aspectos de \btx-, desde los más básicos a los más complejos, haciendo además hincapié en su \emph{españolización}, pues \btx-, como tantas otras herramientas, presupone que será usada para trabajar con documentos en inglés. \end{abstract} {\parskip=0pt\small\tableofcontents} \section*{Preliminar} \label{sec:preliminar} \addcontentsline{toc}{section}{Preliminar} \btx- es un programa que amplia notablemente las capacidades de \ltx- con el manejo de la bibliografía. Las grandes ventajas que ofrece su uso\footnote{ \btx- nos ayuda a gestionar nuestra bibliografía de manera independiente a los documentos en los que debe aparecer, al tiempo que nos permite generar listas de referencias bibliográficas formateadas de manera consistente y cambiar fácilmente determinadas características de las mismas. } se incrementan cuando se maneja una lista bibliográfica amplia y cuando con la misma bibliografía hay que escribir varios documentos. No hay mucha documentación sobre \btx- en español. Publicadas en papel sólo conozco dos obras, ambas de los mismos autores. La primera, \cite{cascales00}, sin duda constituye la más completa información sobre \btx- en nuestro idioma: mas de 40 páginas en las que se incluyen incluso los aspectos más avanzados. La segunda, \cite{cascales03}, no es tan extensa, pero constituye una buena introducción en la que se cubren todos los aspectos básicos y algunos aspectos avanzados. En formato electrónico y en nuestro idioma conozco otros dos documentos. Uno de Luis Seidel, \cite{seidel98} que es una buena introducción, aunque no resulta muy extenso. Otro de José Manuel Mira, \cite{mira04}, que no está pensado para quienes se aproximen por primera vez a esta herramienta, pues en él se explica un \emph{paquete} (\ltr flexbib-) cuyo uso presupone que ya conocemos lo básico del trabajo con \btx-. Como es lógico, en inglés hay mucha más documentación. Los textos principales son el apéndice B del Libro sobre \ltx- de Lamport, \cite{lamport86}, y los dos documentos que sobre \btx- escribió su autor, Oren Patashnik: \cite{patashnik88} y \cite{patashnik88-2}. El primero se ocupa de los aspectos más básicos, y está concebido como una \emph{corrección} del mencionado apéndice B, y el segundo se ocupa de los aspectos más avanzados. El problema que tienen estos documentos es que el trabajo de Lamport es difícil de localizar para el público español. Además de los documentos anteriores, en Internet pueden localizarse varios textos, la mayoría en inglés, algunos introductorios y otros no tanto. De entre ellos me parecen destacables \cite{young02} (un documento bastante equilibrado) y \cite{markey05}, dirigido a un público más avanzado que los otros textos mencionados. \begin{center}***\end{center} El objetivo fundamental de este documento es el de, partiendo de la documentación que se acaba de citar, salvo \cite{lamport86} al que no he tenido acceso, y alguna otra que no se ha mencionado todavía, como \cite{kopla}, poner al alcance del público hispanoparlante un documento en el que se aborden todos los aspectos de \btx-, desde los más básicos a los más avanzados. De ahí el título que he elegido, que tal vez a alguien le suene a pretencioso. Desde luego esta guía no es completa, porque hay aspectos sobre los que se pasa casi de puntillas\footnote{Como por ejemplo las herramientas para gestionar ficheros \tpf bib-, numerosos estilos bastante extendidos, o los paquetes de ampliación para trabajar con \btx-.}. Tal vez ni siquiera sea \emph{casi} completa. Pero sí es la más completa que conozco\footnote{Quizás con la salvedad de \cite{cascales00}. Aunque el problema de ese libro es que hoy no es ya fácil de localizar.}. La materia a tratar ha sido distribuida en tres partes, atendiendo a su nivel de complejidad y detalle: % \btx- es un programa escrito originalmente por Oren Patashnik, que amplía % notablemente las capacidades de \ltx- en relación con el manejo de % bibliografía. Resulta especialmente adecuado cuando se maneja una amplia % lista bibliográfica y cuando con la misma bibliografía hay que escribir % varios documentos. % Documentación sobre \btx- en el idioma español apenas hay. Publicado en % papel sólo conozco dos obras, las dos de los mismos autores, % \cite{cascales00} y \cite{cascales03}: en ambas se dedican varias páginas a % exponer los aspectos principales de \btx-; aunque la información de la % primera es bastante más extensa y muy posiblemente merezca ser considerada % la más amplia información en español existente sobre \btx- hasta ahora. En % formato electrónico, conozco dos trabajos en español: uno de Luis Seidel, % \cite{seidel98}, accesible desde el ftp que dedicado a TeX existe en la % Universidad de la Rioja (<<\url{ftp://ftp.tex.unirioja.es}>>), y en el que % se explican las ideas básicas, pero poco más, y un trabajo publicado en el % número 6 de TeXemplares, \cite{mira04}, (accesible desde la página Web de % CervanTeX), obra de José Manuel Mira y que explica el funcionamiento del % paquete \ltr flexbib-, diseñado para remediar alguno de los principales % problemas que el uso de \btx- plantea en relación con su falta de % estandarización y parametrización. Es un artículo muy interesante pero no % está dirigido a quienes se aproximen por primera vez al uso de esta % herramienta. % En inglés existe una más amplia documentación electrónica. Fundamentalmente % los dos documentos que sobre \btx- escribió el autor del programa, % \cite{patashnik88} y \cite{patashnik88-2} y que se instalan como % documentación del mismo. El primero se dedica a los aspectos % básicos\footnote{A este documentos puede reprochársele el que en él se asume % que el lector ha tenido acceso a \cite{lamport86}, y está redactado como % \emph{modificaciones} o cambios sobre lo que allí se dice. Es decir: no % plantea una explicación \emph{completa} y ordenada de \btx-.} y el % segundo cubre los más avanzados. Pero también es posible localizar por % Internet algunos otros documentos entre los que es de destacar el texto de % Young, \cite{young02}, disponible en % <<\url{wwwmaths.anu.edu.au/\~{}chrisw/LaTeX/}>>, así como el trabajo de % Markey, \cite{markey05}, disponible en la CTAN y que es sin duda el % documento más extenso que conozco sobre \btx-; además de, claro está, la % documentación que acompaña a los paquetes que amplían las posibilidades de % \btx-, y que suele encontrarse en inglés. % El objetivo fundamental de este documento es el de reunir toda la % documentación que acabo de citar y a partir de ella, y de algún otro texto % como \cite{kopla}, generar un documento en español que cubra todos los % aspectos de \btx-, desde los más simples a los más avanzados. De ahí el % título que he elegido, que tal vez suene a pretencioso. Desde luego esta % guía no es completa y es posible que tampoco sea \emph{casi} completa; % aunque desde luego es la más completa que conozco, si bien para algunos % aspectos, fundamentalmente los más avanzados de programación de estilos, es % superada por \cite{cascales00} y por \cite{markey05}\footnote{Porque en % ambos textos se recogen ejemplos de programación de estilos, cosa que yo % no hago. Pero en lo relativo a la información sobre la programación de % estilos en sí misma considerada, no hay en este documento menos % información que en aquellos, aunque aquí la información es ordenada a mi % modo y explicada a mi manera. }. % La materia tratada la he distribuido en tres partes, atendiendo a su nivel % de complejidad y detalle: \begin{enumerate} \item \textbf{\btx- básico:} Cubre los aspectos básicos del funcionamiento de \btx- que afectan a las instrucciones que hay que incluir en el documento principal de \ltx-, al diseño y mantenimiento de la base de datos, y a los distintos estilos estándar existentes, así como a los procedimientos para \emph{españolizarlos}. Es la parte más extensa del documento. Se supone que sólo con leer esta parte estaremos totalmente preparados para trabajar con \btx-. \item \textbf{\btx- intermedio:} En esta parte se describen aspectos que no son imprescindibles para trabajar con \btx-, pero cuyo conocimiento nos proporcionará un mayor control. En particular se aborda el uso de makebst para generar nuestro propio fichero de estilo. \item \textbf{\btx- avanzado:} Esta última parte entra a fondo en los ficheros de estilo de \btx-. En ella se describe el lenguaje que estos ficheros usan internamente. \end{enumerate} Para entender este documento no hay que ser un La\TeX perto, pero sí hay que saber lo suficiente de \ltx-, y del procedimiento estándar que en él se implementa para trabajar con referencias bibliográficas. En general el contenido de este documento valdrá para cualquier distribución de \ltx- que incluya \btx- (o sea, todas las distribuciones). Pero hay algunos aspectos que dependen de la concreta instalación que se haya hecho del sistema como, por ejemplo, la localización de los directorios en los que \btx- lee las bases de datos o los ficheros de estilo. En tales casos la explicación que doy no vale para cualquier sistema, sino exclusivamente para el mío, que es una instalación estándar de \ltx- hecha en un sistema donde funciona Ubuntu versión 6.06. Aunque, en general, estos aspectos dependientes del concreto sistema utilizado son tratados en nota a pie de página. Asimismo, a lo largo del presente documento se citan en ocasiones determinados paquetes para \ltx- o ficheros con estilos adicionales para \btx-. Salvo que se diga lo contrario, todos los paquetes y estilos citados están disponibles en la CTAN, (<<\emph{Comprehensive TeX Archives Network}>>) y deben buscarse en: \begin{itemize} \item <<\url{http://www.ctan.org/tex-archive/macros/latex/contrib/}>> \item <<\url{http://www.ctan.org/tex-archive/biblio/bibtex/contrib/}>> \end{itemize} \clearpage \part{\btx- básico} \label{part:btx-basico} \section{Dinámica general del sistema} \label{sec:entender-la-dinamica} \subsection{Preparar nuestro documento principal para usar \btx-} \label{sec:prep-nuestro-docum} \paragraph{Las órdenes bibliography y bibliographystyle:\\[\baselineskip]} \label{sec:las-orden-bibl} Para usar \btx- necesitamos dos cosas: \begin{enumerate} \item Tener almacenadas en un fichero aparte, las referencias bibliográficas que pensemos usar. \item En el lugar del documento principal en el que queramos que aparezca la lista con las referencias bibliográficas, debemos insertar las siguientes dos órdenes de \ltx-: {\small \begin{verbatim} \bibliography{MiBiblio} \bibliographystyle{MiEstilo} \end{verbatim} } Estas órdenes provocan que tras las oportunas compilaciones (véase la sección \ref{sec:como-generar-la}, página \pageref{sec:como-generar-la}), se genere una lista con las referencias bibliográficas usadas en el documento en la que, además, a cada una de ellas se le asignará una \emph{etiqueta} identificativa\footnote{\textbf{NOTA TERMINOLÓGICA:} En la documentación en castellano de \ltx- el término etiqueta se suele usar para hacer referencia a la cadena de texto que usan en las órdenes que sirven para tratar con referencias cruzadas tales como \cmd cite-, \cmd label-, \cmd index- o \cmd glosary-. Este tipo de \emph{etiquetas} son de uso puramente interno, es decir: \ltx- las usa como marcadores para apuntar a distintas partes del documento, pero no se imprimen en él. Junto a estas \emph{etiquetas} también se usa a veces el mismo término para hacer referencia al rótulo identificador de una entrada concreta de la lista de referencias bibliográficas, que se imprime en el documento. Para evitar confusiones, en este documento he reservado el término \emph{etiqueta} para las que llegan a imprimirse en el documento final, mientras que para referirme a las usadas internamente como marcadores, he reservado el término \emph{clave}. }. Los datos correspondientes a tales referencias serán buscados en el fichero \ltr MiBiblio.bib-, y la lista se formateará de acuerdo con las indicaciones de estilo que se contengan en el fichero de estilo \ltr MiEstilo.bst- y se insertará en el lugar del documento en el que se encuentre \cmd bibliography-. Las instrucciones de estilo controlarán asimismo el tipo de etiqueta identificativa que se asignará a las obras incluidas en la lista de referencias. Si queremos usar más de una base de datos podemos indicarlas, separadas por comas, como argumento de \cmd bibliography-. El efecto de esto último será que las distintas bases de datos indicadas se concatenerán en el orden en el que se indicaron\footnote{Lo que tiene importancia, porque en los ficheros \tpf bib- hay utilidades que sólo funcionan si el orden en el que ciertos elementos se encuentran dentro del fichero es el correcto. Por ejemplo, las abreviaturas deben estar definidas antes de ser usadas, de modo que si tenemos un fichero que recoja una serie de abreviaturas para \btx- y una base de datos que las use, siempre habrá que indicar el fichero de abreviaturas antes que la base de datos.}. \end{enumerate} \subsubsection*{Nombres de ficheros y directorios:} \label{sec:nombres-de-ficheros} El argumento de \cmd bibliography- y el de \cmd bibliographystyle- es el nombre de un fichero. Ambos nombres deben indicarse sin especificar la extensión, pues se asume que esta será la asignada al tipo de fichero de que se trate. De hecho \btx- no funciona correctamente cuando el nombre de la base de datos no tiene la extensión \tpf bib-, ni tampoco cuando en dicho nombre existe un espacio en blanco o algún carácter no anglosajón como eñes o vocales acentuadas\footnote{Así ocurre en mi sistema. Es posible que en otros sistemas operativos no exista este problema, aunque creo que ocurrirá lo mismo, al menos en lo relativo a la extensión de los ficheros; porque \cmd thebibliography- se limita a copiar en el fichero \tpf aux- el texto que recibe como argumento, y \btx- le añade a dicho texto la extensión \tpf bib-, salvo en el caso de que ya termine así.}. Los ficheros, el de bibliografía y el de estilo, deben encontrarse en el directorio de trabajo (el mismo en el que se encuentre el documento principal), o en alguno de los directorios en los que \ltx- busca por defecto, los cuales varían dependiendo de la distribución de \ltx- concreta de que se disponga\footnote{\label{nota:cnf}En \ltr web2c-, que es la distribución de \ltx- estándar para sistemas Unix/Linux, el árbol de ficheros de \TeX{} se encuentra en \ltr /usr/share/texmf- Allí hay un fichero denominado \ltr texmf.cnf- en el que se almacenan las variables que controlan las rutas de búsqueda por defecto de \ltx- y sus programas auxiliares. Aunque a veces dicho fichero se encuentra en el directorio \ltr web2c-, o en \ltr /etc/texmf/-. En dicho fichero se encuentran las dos variables que afectan a los directorios relativos a \btx-: BIBINPUTS (directorios en los que se buscarán los ficheros \tpf bib-) y BSTINPUTS (directorios en los que se buscarán los ficheros de estilo). }. Si los ficheros que queremos usar no están en alguno de estos directorios deberemos incluir, junto con el nombre del fichero, la ruta de acceso al mismo, en cuyo caso para dicha ruta se aplican las mismas reglas que para el nombre de los ficheros: no podrá contener espacios en blanco ni caracteres no anglosajones. \paragraph{Contenido de la lista de referencias a generar:\\[\baselineskip]} \label{sec:contenido-de-la} Las características \emph{formales} y de ordenación de la lista bibliográfica que se generará, dependen del estilo concreto usado, y se explican en la sección \ref{sec:los-estil-bibl}. Aquí me concentraré exclusivamente en los siguientes dos aspectos de la misma: \begin{description} \item[Qué referencias se incluyen en la lista:] En ella se contendrán todas las referencias bibliográficas que, a lo largo de nuestro documento, se hayan referenciado mediante los comandos \cmd cite- y \cmd nocite-: \begin{itemize} \item El comando \cmd cite[DatosAdicionales]\{clave\}- produce un doble efecto. En primer lugar, la referencia bibliográfica identificada en la base de datos mediante la clave recibida como parámetro, se incluirá en la lista bibliográfica. En segundo lugar, en el punto del documento donde se encontrara el comando, se imprimirá la etiqueta asignada a tal referencia en la lista de referencias junto con los datos adicionales que eventualmente hayamos incluido en el argumento opcional del comando. \item El comando \cmd nocite\{clave\}- produce el primero de los efectos indicados, pero no el segundo, es decir: la obra identificada por la clave será incluida en la lista bibliográfica final, y en ella se le asignará asimismo una etiqueta (como a todas las obras de la lista), pero en el lugar del documento en el que se encuentra el comando \cmd nocite- no se imprimirá nada. \end{itemize} Ambos comandos pueden recibir, como parámetro, las claves de varias referencias distintas, separadas mediante comas. Y en el caso concreto de \cmd nocite-, si se escribe \cmd nocite\{*\}- el efecto será incluir en la lista bibliográfica final todas las referencias bibliográficas incluidas en la base de datos. \item[Qué título tendrá la lista de referencias:] Dependiendo del tipo de documento de que se trate, el título de la lista de referencias está controlado por dos variables de nombre distinto\footnote{Lo que, en mi opinión, es una inconsistencia del sistema. El paquete \ltr chbibref- incluye un comando que permite cambiar el título de la lista de referencias con independencia de que se trate de un documento tipo \ltr book- o de un documento tipo \ltr article-.}. En documentos tipo \ltr book- para cambiar el título de la lista debe modificarse el comando \cmd bibname-, mientras que en documentos tipo \ltr article- el comando \ltx- que hay que modificar es \cmd refname-. El paquete \ltr babel-, por otra parte asigna a cada uno de estos comandos un valor dependiente del idioma. En español los nombres son ``Bibliografía'' para los libros y ``Referencias'' para los artículos. Si, por ejemplo, deseamos que la lista de referencias se titule ``Bibliografía citada'' y nuestro documento es de tipo \ltr book- tendremos incluir en el cuerpo de nuestro documento\footnote{Y es que, según mi experiencia, esta orden no produce efectos si se incluye en el preámbulo. Posiblemente por la interacción que la carga del paquete \ltr babel- produce.} la siguiente orden: \verb|\renewcommand{\bibname}{Bibliograf\'ia citada}| Asimismo, si se desea que en el índice de contenido de nuestro documento aparezca una entrada para la bibliografía, hay que incluirla a mano mediante la orden \cmd addscontentline- de \ltx-\footnote{El paquete \ltr tocbibind- hace que los índices y la lista de referencias se incluyan automáticamente en la tabla de contenido.}, la cual debe insertarse \emph{antes} de \cmd bibliography-, ya que si se inserta detrás, en el índice del documento aparecerá como página de la bibliografía la página en la que esta termina, y no la página en la que empieza\footnote{Véase más adelante en la sección \ref{sec:elementos-preamble}, a propósito de los elementos \ltr @preamble- de los ficheros \tpf bib-, cómo podemos incluir en un fichero \tpf bib- el código necesario para cambiar automáticamente el título a la lista de referencias y asegurarnos de que se incluye en la tabla de contenido.}. \end{description} \subsection{Cómo generar la lista de referencias bibliográficas} \label{sec:como-generar-la} Una vez que nuestro documento (llamémosle \ltr MiDoc.tex-) está preparado, en los términos que se acaban de exponer, debemos seguir los siguientes pasos: \begin{enumerate}[1º] \item Compilar con \ltx- nuestro documento \tpf tex-. Ello hará que se genere un fichero de extensión \tpf aux-, en el que se incluirá información sobre la base de datos a usar, el fichero de estilo a usar, y las referencias bibliográficas que hay que incluir en la lista de referencias. \item Ejecutar, desde la línea de comandos\footnote{Numerosas herramientas para \ltx- incorporan la posibilidad de ejecutar desde el mismo editor tanto \ltx- como cualquiera de sus programas auxiliares, en cuyo caso no sería preciso ejecutar \btx- \emph{desde la línea de comando}.}, la orden \ltr bibtex MiDoc-. Ello hará que \btx- lea el fichero \tpf aux-\footnote{De hecho \btx- se ejecuta sobre el fichero \tpf aux-, y no sobre el fichero \tpf tex-. Este detalle puede escapársenos porque \btx- no exige que se escriba la extensión. Pero si en el comando incluimos la extensión comprobaremos que \ltr bibtex MiDoc.tex- generaría un error, mientras que \ltr bibtex MiDoc.aux- funcionaría correctamente.}, generado por la anterior compilación del documento, extrayendo de él la información que necesita para trabajar: qué base de datos debe usar, qué estilo, y qué referencias hay que buscar en la base. Y así, tras extraer de la base de datos los registros precisos, y formatearlos de acuerdo con el estilo indicado, \btx- genera un fichero de extensión \tpf bbl- en el que se contienen los comandos de \ltx- necesarios para escribir la lista de referencias bibliográficas que hay que insertar en el documento principal. \btx- genera también un fichero adicional, de extensión \tpf blg- que es un fichero \tpf log-\footnote{Es decir: en él se almacenan todas las salidas generadas por \btx-, incluyendo los mensajes de advertencia o error. En caso de que algo no haya funcionado como esperábamos es imprescindible la consulta de este fichero para ver qué es lo que ha podido fallar.}. \item Compilar de nuevo el documento principal con \ltx-. En esta segunda compilación, al leer la orden \cmd bibliography-, se insertará en su lugar el contenido del fichero \tpf bbl- generado en el paso anterior. Asimismo la nueva compilación reescribe el fichero \tpf aux-, añadiendo a la información que ya existía en él la generada ahora, que es más completa pues incluye los datos de la lista bibliográfica final que se acaba de insertar en el documento. \item Esta última información es usada en una nueva compilación con \ltx- para escribir correctamente los rótulos que hay que colocar en lugar de los comandos \cmd cite-. Y eventualmente puede ser necesaria una nueva compilación: cuando alguno de los campos de la base de datos contenga algún comando de \ltx- que implique el uso de referencias cruzadas. En particular, el comando \cmd cite-. \end{enumerate} ¿Parece complicado? No lo es. Lo que ocurre es que lo he explicado incluyendo detalles sobre cómo interactúan entre sí los distintos ficheros generados durante las compilaciones de \ltx-. Simplificando y sin entrar en tales detalles, lo que hay que hacer es, tras haber indicado en el documento principal el nombre de la base de datos y del estilo, realizar una primera compilación con \ltx-, ejecutar \btx- y luego compilar de nuevo con \ltx- dos veces (o, en ciertos casos, tres). Esta doble (o triple) compilación final no es ninguna especialidad de \btx-, sino que es requerida por \ltx- siempre que trabaja con referencias cruzadas. Asimismo habrá que repetir el proceso cada vez que incorporemos a nuestro documento principal un comando que suponga una modificación de lista bibliográfica final, bien por cambiarle el estilo, bien por incluir o eliminar referencias bibliográficas. \section{Las bases de datos bibliográficas} \label{sec:las-bases-de} \subsection{Reglas generales sobre la escritura y codificación de los ficheros \tpf bib-} \label{sec:ficheros-.bib-1} Los ficheros \tpf bib- usados por \btx- son ficheros de texto sometidos a las siguientes reglas generales: \begin{enumerate} \item El tratamiento de los espacios en blanco, tabuladores y saltos de línea es similar al que estos caracteres reciben en \ltx-\footnote{Hay, no obstante, una diferencia, y es que en \ltx- una línea en blanco es relevante pues sirve para indicar un cambio de párrafo. En los ficheros \tpf bib-, una línea en blanco es tan irrelevante como un salto de línea simple.}. Son simples delimitadores de palabras y la regla es que da igual cuántos delimitadores haya entre dos palabras\footnote{Podríamos, en teoría, escribir todo el fichero \tpf bib- como una sola e inmensa línea en la que las palabras estuvieran separadas entre sí por un solo espacio en blanco. Pero tal fichero sería, para los seres humanos, más difícil de leer que otro en el que hayamos usado los tabuladores, espacios y saltos de línea para mejorar el aspecto visual (llamado \emph{legibilidad}) del fichero.}. \item \btx- no distingue entre mayúsculas y minúsculas\footnote{La no distinción entre mayúsculas y minúsculas se aplica a los elementos de \btx- (nombres de registros o campos, abreviaturas, etc), pero no al contenido de los campos de los registros. }. \end{enumerate} \subsubsection*{Uso de caracteres españoles en los ficheros \tpf bib-} \label{sec:uso-de-caracteres} La versión original de \btx- no era capaz de trabajar con caracteres no anglosajones (como eñes o vocales acentuadas). En la actualidad existe una versión de \btx- que sí puede hacerlo. No obstante se suele recomendar que para representar esos caracteres que requieren 8 bits se sigan las reglas generales de \ltx- y así, por ejemplo, en lugar de escribir \ltr Pág- escribamos ``\verb|P\'ag|''\footnote{El problema de representar caracteres no anglosajones directamente en un fichero de texto, es que estos caracteres no están incluidos en la tabla ASCII que todos los ordenadores reconocen, sino en otras tablas o \emph{codificaciones}. Y, desgraciadamente para los hablantes de idiomas distintos al inglés, existen \emph{muchas} codificaciones distintas para representar los mismos caracteres: ``utf8'', ``latin1'', ``cp850'', etc.; y para trabajar con un documento que contenga este tipo de caracteres es preciso saber exactamente qué codificación se usó para almacenarlo pero, desgraciadamente, los ficheros de texto no guardan información sobre su propia codificación. Además, en el caso concreto de los ficheros \tpf bib-, el uso de una codificación u otra puede afectar a la ordenación alfabética de los registros almacenados en la base de datos.}. Y aunque es cierto que escribir de ese modo nuestro idioma es incómodo, hay herramientas que lo facilitan\footnote{Como, por ejemplo \ltr pybliographer-, una utilidad de gestión de ficheros \tpf bib- para sistemas Unix/Linux, en la que podemos teclear normalmente cualquier carácter, pero antes de guardar el fichero, los caracteres no anglosajones son convertidos a la secuencia \ltx- necesaria para representarlos. De esta herramienta se vuelve a hablar en la sección \ref{sec:herr-graf}.}. En todo caso, si decidimos introducir caracteres no anglosajones directamente en el fichero \tpf bib-, debemos tener en cuenta que como el contenido de este fichero puede eventualmente incorporarse a un documento \tpf tex-, si en ambos el tipo de codificación no coincidiera se generaría un error. Por ello, para usar estos caracteres deben cumplirse los siguientes requisitos: \begin{enumerate}[a)] \item Debemos guardar el fichero \tpf bib- con la misma codificación con la que vayamos a guardar el fichero \tpf tex- en el que se hará uso de la base de datos. \item En el fichero \tpf tex- debe usarse la orden \cmd usepackage[cod]\{inputenc\}- donde ``cod'' significa una cadena representativa de la codificación usada en el fichero \tpf bib- (y en el \tpf tex-): \ltr utf8-, \ltr latin1-, etc. \item Debemos asegurarnos de que estamos usando la versión de \btx- de 8 bits. \end{enumerate} \subsection{Registros y campos bibliográficos} \label{sec:registros-y-campos} Un fichero \tpf bib- almacena una base de datos bibliográfica. En toda base de datos hay dos nociones fundamentales: \begin{description} \item[Campo:] Un dato aislado y básico. Por ejemplo, el año de edición de un libro, o el nombre del autor de un artículo de revista, o la página del libro de las actas de un congreso en donde empieza una determinada ponencia... \item[Registro:] Un conjunto de campos que permiten describir de forma completa un ejemplar del tipo de realidades a que se refiere la base de datos. En nuestro caso, tratándose de una base de datos bibliográfica, cada registro describe una referencia bibliográfica concreta (y completa). \end{description} Es decir: todos los campos que contienen datos de una misma referencia bibliográfica, constituirán un registro. Y la base de datos, en sí misma considerada, no será sino un conjunto de registros, cada uno de los cuales consta de varios campos. \subsubsection{Formato general de los registros y los campos} \label{sec:formato-general-de} En los ficheros \tpf bib- se usa el carácter ``@'', seguido de una palabra representativa del tipo de registro de que se trate, para indicar que empieza un registro. Asimismo se usan llaves para delimitar el contenido del registro. En consecuencia el formato de un registro es el siguiente: {\small \begin{verbatim} @TipoRegistro{clave, Campo1, Campo2, ... CampoN, } \end{verbatim} } Donde \emph{TipoRegistro} es el nombre que identifica a un concreto tipo de registro, y puede escribirse indistintamente en mayúsculas o minúsculas. En el contenido del registro, hay básicamente dos elementos: \begin{description} \item[La clave de identificación del registro] es siempre su primer elemento. Se usa para distinguir a un registro concreto del resto de los registros de la base de datos, y por ello en una misma base de datos no debe haber dos registros que tengan claves iguales, y tampoco deben unirse o manejarse en un mismo documento dos o más bases de datos si ello implica que alguna clave vaya a repetirse\footnote{Digo que no \emph{deben} usarse claves iguales; no que no pueda hacerse. Ello es porque \btx- no genera ningún error cuando en un fichero dos o más registros tienen la misma clave. Simplemente, en tal caso, toma en consideración exclusivamente la primera aparición de la clave, ignorando las restantes. Y, a tales efectos, téngase en cuenta que para el control de las claves \btx- no distingue entre mayúsculas y minúsculas.}. La clave puede consistir en cualquier combinación de letras, números y ciertos signos de puntuación. No se admiten ni los caracteres no anglosajones (vocales acentuadas y los caracteres ``¡¿ñÑçÇ'') ni ciertos signos de puntuación como la coma (que se usa para indicar que la clave ha terminado). En las citas hechas en el documento \tpf tex- habrá que usar esta clave para identificar al registro al que se quiere hacer referencia. \item[Los campos:] A \btx- le es indiferente en qué orden se escriban los campos de un determinado registro, así como si se usan cero, uno o más saltos de línea entre dos campos. \end{description} Para escribir un campo dentro de un registro podemos usar indistintamente cualquiera de los dos formatos siguientes: {\small \begin{verbatim} NombreCampo = { Contenido }, NombreCampo = " Contenido ", \end{verbatim} } En ambos casos intervienen los siguientes elementos: \begin{description} \item[Nombre del campo:] Normalmente será uno de los campos, obligatorios u opcionales, previstos para el tipo de registro de que se trate. Si el nombre no coincide con ninguno de los que el estilo ha previsto para el tipo de registro que sea, su contenido será ignorado. Si el mismo campo se introduce más de una vez en el mismo registro, sólo será tomada en consideración su primera aparición. \item[Delimitadores de contenido:] Se exige el uso de delimitadores para el contenido del campo siempre que este no tenga un valor puramente numérico o consista en una abreviatura previamente definida como tal mediante la función \ltr @String- (véase la sección \ref{sec:uso-de-abreviaturas}). Como delimitadores se pueden usar las llaves o las comillas dobles. La diferencia entre usar unas u otras es sólo una: cuando usamos comillas dobles como delimitadores, dentro de la cadena delimitada no podemos usar comillas dobles, salvo que las encerremos entre llaves. Por ejemplo: {\small \begin{verbatim} title = {Comentarios a "El Buscón" de Quevedo}, title = "Comentarios a {"}El Buscón{"} de Quevedo", \end{verbatim} } servirían para incluir un título que a su vez incluya dobles comillas. \item[El contenido de los campos:] cualquier cosa que se incluya en un campo puede, eventualmente, incorporarse a un documento \ltx-, y por lo tanto: \begin{enumerate} \item Es posible incluir, como contenido de un campo, comandos de \ltx-, aunque ello sólo está recomendado en casos muy especiales, y nunca es una buena idea que esos comandos sean de \emph{formato} de texto, pues la idea que está detrás de \btx- es que el formateo de las listas de referencias se haga depender del estilo usado. \item Dentro del contenido del campo hay que respetar las reglas generales de \ltx-, no usar sus caracteres reservados (salvo cuando se trate de un uso legal) y recordar que \ltx-, a diferencia de \btx-, sí distingue entre mayúsculas y minúsculas. \item Las llaves que pueda haber en un campo deben estar equilibradas. Es decir: toda llave abierta debe ser cerrada. Y ello se aplica incluso para llaves que se deben imprimir\footnote{Lo que se debe a que \btx- no interpreta los comandos de \ltx-, por lo tanto si en un campo se lee el texto \ltr \textbackslash\{-, \btx- no ve un caracter imprimible, sino una llave abierta que debe ser cerrada dentro del campo. Por ello en el raro caso de que debamos incluir como contenido de un campo el carácter ``\{`` (o ``\}'') habría que usar el comando \ltx- \cmd leftbrace- (o \cmd rightbrace-).}. \end{enumerate} Existen reglas especiales para el contenido de algunos campos concretos, pero estas se exponen más adelante, cuando se explican los campos reconocidos por los estilos estándar de \btx-. \item[La coma final:] Indica que el contenido del campo ha terminado y \emph{puede} empezar otro campo distinto. No es obligatoria en el último campo de un registro; pero no se produce ningún error por el hecho de introducirla también en él. \end{description} Desde el punto de vista de un concreto estilo bibliográfico, los campos presentes en un registro se incluirán en uno de los siguientes grupos: \begin{description} \item[Campos obligatorios:] Son aquellos que el estilo en cuestión espera encontrar en un determinado tipo de registro, de manera que si en un registro concreto alguno de ellos no está presente, se generará una advertencia en la salida estándar y en el fichero \tpf blg- generado por \btx-. En algunas ocasiones la falta de uno de estos campos puede provocar un error, aunque eso no debería ocurrir en un estilo bien diseñado. \item[Campos opcionales:] Son aquellos para los que el estilo en cuestión ha previsto algún tipo de acción, pero se ha previsto también su posible ausencia, y esta no tiene especial trascendencia. \item[Campos ignorados:] Cualquier otro campo presente para el que el estilo en cuestión no ha previsto ningún tipo de acción. \end{description} \subsubsection{Tipos de registros bibliográficos} \label{sec:registr-bibl} Las referencias bibliográficas pueden ser de distinta naturaleza, y en consecuencia se distinguen diferentes tipos de registros. A continuación expondré los nombres de los distintos tipos de registro previstos en \btx-, indicando para cada uno de ellos sus campos obligatorios y opcionales específicos\footnote{Con \emph{específicos} quiero decir que, para evitar repeticiones, en la relación que sigue no se ha incluido en cada uno de los registros los nombres de dos campos opcionales que están presentes en todos los registros, sean del tipo que sean: \ltr key- y \ltr note-. }. Para que \btx- pueda reconocer adecuadamente los registros y campos, los nombres de estos deben ser usados en inglés, y por ello los mencionaré en ese idioma. Entre paréntesis añadiré, para los tipos de registro, lo que significa su nombre. En la próxima sección se explica para qué sirve cada campo. \begin{description} \item[Article (artículo):] Un artículo publicado en una revista. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{journal} y \texttt{year}. Opcionales: \texttt{volume}, \texttt{number}, \texttt{pages} y \texttt{month}. \item[Book (libro):] Un libro \emph{normal}. Campos obligatorios: \texttt{author} o \texttt{editor}, \texttt{title}, \texttt{publisher} y \texttt{year}. Opcionales: \texttt{volume} o \texttt{number}, \texttt{series}, \texttt{address}, \texttt{edi\-tion} y \texttt{month}. \item[Booklet (folleto):] Un trabajo impreso y distribuido pero sin que conste la editorial o institución que lo patrocina. Campo obligatorio: \texttt{title}. Campos opcionales: \texttt{author}, \texttt{howpublished}, \texttt{address}, \texttt{month} y \texttt{year}. \item[Conference (conferencia):] Idéntico a InProceedings. Se incluye exclusivamente para mantener la compatibilidad con el formato \emph{Scribe}. \item[InBook (dentro de un libro):] Una parte de un libro, que puede ser un capítulo (o sección o similar) o un rango de páginas, o ambas cosas. Campos obligatorios: \texttt{author} o \texttt{editor}, \texttt{title}, \texttt{chapter} y/o \texttt{pages}, \texttt{publisher} y \texttt{year}. Opcionales: \texttt{volume} o \texttt{number}, \texttt{series}, \texttt{type}, \texttt{address}, \texttt{edition} y \texttt{month}. El campo \texttt{title}, en estas referencias, se refiere al título del libro, no al título del capítulo o grupo de páginas a que se refiere el registro. \item[InCollection (en una colección):] Una parte de un libro que tiene su propio título. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{booktitle}, \texttt{publisher} y \texttt{year}. Opcionales: \texttt{crossref}, \texttt{editor}, \texttt{volume} o \texttt{number}, \texttt{series}, \texttt{type}, \texttt{chapter}, \texttt{pages}, \texttt{address}, \texttt{edition} y \texttt{month}. \item[InProceedings (en las actas):] Una conferencia, artículo o ponencia en las actas de un congreso o, o, en general, en un libro que agrupe varios trabajos de autores distintos y con títulos independientes. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{booktitle}, \texttt{year}. Campo opcionales: \texttt{crossref}, \texttt{editor}, \texttt{volume} o \texttt{number}, \texttt{series}, \texttt{pages}, \texttt{address}, \texttt{month}, \texttt{organization} y \texttt{publisher}. \item[Manual:] Documentación técnica. Campo obligatorio: \texttt{title}. Campos opcionales: \texttt{author}, \texttt{organization}, \texttt{address}, \texttt{edition}, \texttt{month} y \texttt{year}. \item[MasterThesis (Proyecto fin de carrera):] Lo que en el mundo académico norteamericano se denomina ``\emph{Master Thesis}'' o ``\emph{Minor Thesis}'' y que en España equivale a las llamadas ``\emph{Tesinas de licenciatura}'' y a los \emph{Proyectos de fin de carrera}; es decir: un trabajo de investigación menor, leído en una institución académica. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{school} y \texttt{year}. Opcionales: \texttt{type}, \texttt{address} y \texttt{month}. \item[Misc (miscelánea):] Este tipo está previsto para ser usado cuando ninguno de los otros tipos encaje bien. Su peculiaridad es que carece de campos obligatorios. Campos opcionales: \texttt{author}, \texttt{title}, \texttt{howpublished}, \texttt{month} y \texttt{year}. \item[PhdThesis (tesis doctoral):] Lo que en el mundo académico norteamericano se denomina ``\emph{PhD Thesis}'', ``\emph{Major Thesis}'' y que equivale a las tesis doctorales españolas, es decir: un trabajo de investigación original y extenso que permite obtener el título de doctor que constituye la más alta graduación académica existente. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{school} y \texttt{year}. Opcionales: \texttt{type}, \texttt{address} y \texttt{month}. \item[Proceedings (libro de actas):] El libro de actas donde se encuentra una conferencia o ponencia en un congreso, aunque yo lo uso con carácter general para todos aquellos libros que agrupan trabajos, cada uno de ellos con distintos autores. Campos obligatorios: \texttt{title} y \texttt{year}. Opcionales: \texttt{booktitle}, \texttt{editor}, \texttt{volume} o \texttt{number}, \texttt{series}, \texttt{address}, \texttt{month}, \texttt{organization} y \texttt{publisher}. \item[TechReport (informe técnico):] Un informe publicado por un centro académico o institución similar, normalmente numerado dentro de una serie. Campos obligatorios: \texttt{author}, \texttt{title}, \texttt{institution} y \texttt{year}. Campos opcionales: \texttt{type}, \texttt{number}, \texttt{address} y \texttt{month}. \item[Unpublished (no publicado):] Un documento que tiene un autor y un título pero que formalmente no ha sido publicado. Campos obligatorios: \texttt{author}, \texttt{title} y \texttt{note}. Opcionales: \texttt{month} y \texttt{year}. \end{description} A los campos mencionados hay que añadir, en todos los tipos de registro, un campo \texttt{key} y un campo \texttt{note}, ambos opcionales, salvo en las referencias tipo \ltr Unpublished-, donde \texttt{note} es obligatorio. \subsubsection{Significado de los distintos campos bibliográficos} \label{sec:campos-de-datos-1} \begin{description} \item[Address:] Este campo está pensado para almacenar la dirección de la editorial o institución responsable de una publicación. Es siempre opcional y conviene usarlo, sobre todo, cuando las editoriales sean pequeñas o poco conocidas. En la mayor parte de los casos, además, no se incluye aquí la dirección completa, sino exclusivamente la ciudad donde reside la editorial. Hay especialidades científicas donde es costumbre identificar las obras publicadas más bien por la ciudad que por la editorial, en cuyo caso puede ser buena idea indicar la ciudad no en el campo \ltr address-, sino en \ltr publisher-. \item[Author:] Como este es el campo más complejo, dividiré su explicación en varios apartados: \paragraph{La autoría de las referencias:} \label{sec:la-autoria-de} Toda referencia bibliográfica ha de tener una \emph{autoría} y en tal sentido, en todos los tipos de registros hay algún campo dirigido a recogerla. Ese campo es normalmente \ltr author-, aunque: \begin{enumerate}[a)] \item En \ltr Proceedings- la autoría viene recogida por el campo \ltr editor-, porque este tipo de registro recoge un libro sin autor propiamente dicho, que recopila o agrupa varios trabajos que sí tienen autor. \item En los tipos \ltr Book- e \ltr InBook-, el campo \ltr author- puede ser sustituido por \ltr editor-. Si se especifican ambos campos simultáneamente, el contenido del campo \ltr editor- es ignorado. \item En las referencias de tipo \ltr Manual-, a falta de campo \ltr author-, la autoría se atribuirá al campo \ltr organization-. \end{enumerate} En cualquiera de estos casos, la recomendación es que el nombre del autor se escriba tan completo como se conozca, es decir: que no se usen iniciales para sustituir al nombre propio, ya que ese efecto podemos obtenerlo mediante el estilo bibliográfico. Pero si en la base de datos no consta el nombre completo no hay estilo bibliográfico que sea capaz de adivinarlo. \paragraph{Varios autores:} \label{sec:caso-en-el} Si hay más de un autor, para separar unos de otros hay que usar necesariamente la palabra ``and'' para que \btx- sepa donde empieza un autor y donde acaba otro. Si usamos la conjunción española equivalente, ``y'', \btx- no formateará correctamente el contenido de este campo porque no sabrá separar a los distintos autores. El hecho de usar ``and'' dentro del fichero \tpf bib- no significa que en nuestros documentos se vaya a usar dicha palabra, pues eso depende del fichero de estilo. Si \emph{dentro} del nombre de uno de los autores aparece la palabra ``and'', hay que encerrar entre llaves (distintas de las genéricas llaves para delimitar el contenido del campo) el nombre completo. Así, en los siguientes ejemplos: {\small \begin{verbatim} author = "{McArthur And Inc.}", author = {{McArthur And Inc.}}, author = {Thomas R. Delan And {McArthur And Inc.}}, \end{verbatim} } El nombre que contiene, como parte de él, la palabra ``And'' va siempre entre llaves, con independencia de qué tipo de delimitador se haya escogido para el campo y de si hay o no mas nombres. \paragraph{Distinción entre nombre y apellidos:} \label{sec:dist-entre-nombre} El nombre de una persona tiene varias partes de las que las principales (en los nombres españoles) son el nombre propio (también llamado nombre de pila, o nombre a secas) y los apellidos. \btx- descompone los nombres para determinar qué parte de los mismos hay que atribuir al nombre propio, cuál a los apellidos, y cual a las restantes partes que \btx- reconoce en un nombre\footnote{En realidad \btx- descompone los nombres en cuatro partes: Nombre de pila (en inglés, \emph{First name)}, Partícula de separación, Apellidos (en inglés \emph{Last name} o \emph{Surname} y partícula ``Jr.'', muy habitual en los nombres anglosajones. En las líneas que siguen he omitido lo referente a esta última partícula, inexistente fuera del mundo anglosajón. No obstante si en nuestra base de datos debe introducirse algún nombre propio que incluya dicha partícula, normalmente esta será reconocida por \btx- y su presencia no alterará las reglas que a continuación se exponen.}. Para ello se siguen las siguientes reglas: \begin{enumerate}[1ª.] \item Si el texto introducido consta de una sola palabra, se asignará al apellido. \item \label{Regla:2} Si consta de dos o más palabras, se considerará que la última es el apellido y el resto es el nombre de pila. Esta regla se basa en que fuera de la Península Ibérica (y paises de tradición cultural ibérica), es usual tener un solo apellido y varios nombres de pila. \item En el caso de que el apellido conste de varias palabras y alguna de las palabras interiores estuviera escrita con minúsculas, se considerará que tal palabra es una partícula que separa el nombre del apellido por lo que se asignará al apellido todo lo que esté detrás de tal partícula, y al nombre lo que esté antes. Y así, por ejemplo, \btx- interpretará correctamente el nombre {\small\verb|Miguel de Cervantes Saavedra|} siempre y cuando escribamos el ``de'' y lo hagamos en minúsculas. Pero si escribimos: {\small \begin{verbatim} Miguel Cervantes Saavedra Miguel De Cervantes Saavedra miguel de cervantes saavedra \end{verbatim} } como \btx- no podrá identificar la partícula aplicará la regla \ref{Regla:2}, y considerará que ``Saavedra'' es el apellido y el resto nombre propio\footnote{Por ello si queremos que en nuestra lista bibliográfica las partículas se impriman en mayúsculas, pero que \btx- las reconozca correctamente, habría que escribir: ``\texttt{Miguel \{\textbackslash uppercase\{d\}e\} Cervantes Saavedra}''.}. \item Si solo conocemos el apellido, y este consta de varias palabras, para evitar que las primeras se asignen al nombre de pila, hay que encerrar todo el nombre entre llaves (además de las delimitadoras del campo). Por ejemplo: {\small\verb|author = "{Ortega y Gasset}",|} \item Si en un nombre se usa una coma, \btx- asignará al apellido todo lo que esté antes que la coma, y al nombre propio todo lo que esté detrás. Esta regla prevalece sobre todas las anteriores. \end{enumerate} Para nombres españoles, con dos apellidos, lo más seguro es usar una coma entre el apellido y el nombre para impedir que \btx- realice malas interpretaciones. Porque aunque en ocasiones la partícula nos puede ayudar (como en ``Miguel de Cervantes Saavedra'') la mayoría de los nombres carecen de partícula, y en muchas ocasiones la partícula produciría un error, como en ``Félix Lope de Vega y Carpio''. \item[Booktitle:] Es el título de un libro, parte del cual está siendo citado. Se usa, por lo tanto en las referencias que sirven para citar una parte de un libro que tenga un título distinto del título del libro, es decir: \ltr InCollection- e \ltr InProceedings-. Este campo también está presente en las referencias de tipo \ltr Proceedings-, aunque en ellas se usa exclusivamente para las referencias cruzadas (véase la sección \ref{sec:refer-cruz-entre}). A este campo le son de aplicación las reglas que más adelante se exponen sobre el campo \ltr title-. \item[Chapter:] Contiene un número de capitulo, sección o unidad estructural de un libro. Se usa en las referencias de tipo InBook e InCollection para identificar una parte de un libro. \item[Crossref:] Contiene una etiqueta en la base de datos para generar referencias cruzadas internas (véase la sección \ref{sec:refer-cruz-entre}). \item[Edition:] Se trata del número de edición de un libro. Es siempre un campo opcional; y de hecho sólo suele rellenarse cuando no se trata de la primera edición. Los estilos estándar presuponen que se escribirá con una palabra en mayúsculas (y en inglés). Por ejemplo ``Second'', aunque si se escribe en español (``Segunda''), o con un ordinal expresado en forma numérica (``2ª''), no pasa nada\footnote{En los estilos estándar detrás de este campo se añade la palabra ``edition'' y, si están españolizados, la palabra ``edición'', por ello no conviene usar directamente un número que no sea un ordinal, ya que entonces la referencia contendría la expresión ``2 edición'', que no es correcta.}. Lo que sí es importante, para generar listas bibliográficas consistentes, es que siempre lo escribamos del mismo modo. \item[Editor:] Este campo ya ha sido mencionado a propósito del campo ``author''. El editor de un libro es el que, sin ser su autor propiamente dicho, lo impulsa y hace nacer. Esta figura es importante hasta el punto de que sobre él recae la \emph{autoría} (a efectos de la base de datos) en determinado tipo de obras como puede ser una antología, un estudio crítico de alguna obra antigua, etc. Por ejemplo: una edición crítica de la poesía barroca española, o el conocido ``\emph{Las mil mejores poesías de la lengua castellana}''. Las reglas relativas a este campo son similares a las del campo ``author''. \item[Howpublished:] Este campo se usa en las referencias de tipo ``Booklet'' y ``Misc'' que recogen libros que no han sido publicados por una editorial o institución ``normal''. En este campo puede indicarse cómo se llegó a publicar la obra de que se trate. La primera palabra debe ir en mayúsculas. \item[Institution:] Este campo existe exclusivamente en los informes técnicos (referencias \ltr TechReport-) y recoge el nombre de la institución que ha financiado el informe de que se trate. \item[Journal:] Para artículos publicados en revistas este campo recoge el nombre de la revista. En determinados campos del conocimiento existen abreviaturas estándar para las revistas más conocidas, por lo que puede usarse la abreviatura en lugar del nombre completo de la revista. Sobre el uso de abreviaturas en los ficheros \tpf bib- véase la sección \ref{sec:uso-de-abreviaturas}. \item[Key:] Está disponible como campo opcional en todos los tipos de referencias. Se usa en relación con la generación de etiquetas, en aquellos estilos en los que estas se generan a partir del nombre del autor, como por ejemplo ocurre en el estilo \ltr alpha-. En tales casos, el valor del campo \ltr key- será usado para la generación de la etiqueta si no consta ningún valor para el campo \ltr author-, incluso aunque si conste algún valor para alguno de los campos que en ciertos tipos de referencias pueden suplir a dicho campo (véase lo que, al explicar el campo \ltr author- se dijo sobre la autoría, en pág. \pageref{sec:la-autoria-de}). \item[Month:] En artículos de revista se usa para designar el mes en el que salió el número que contiene dicho artículo. En otro tipo de trabajos el mes en el que fueron publicados o terminados (para trabajos no publicados). La documentación oficial de \btx- recomienda introducir este campo mediante unas abreviaturas estándar en inglés\footnote{\label{meses}Se trata de: \ltr jan-, \ltr feb-, \ltr mar-, \ltr apr-, \ltr may-, \ltr jun-, \ltr jul-, \ltr aug-, \ltr sep-, \ltr oct-, \ltr nov- y \ltr dec-.}, en cuyo caso usando la abreviatura, no habría que usar delimitadores para el campo (por las razones que se explican cuando se habla de las abreviaturas en la sección \ref{sec:uso-de-abreviaturas}). En teoría aquí ocurre igual que en el campo \ltr author-, respecto de la partícula ``and'' usada para separar entre sí a los distintos autores, y es que aunque hayamos introducido el mes en inglés (o mediante una abreviatura del nombre inglés), luego, usando el estilo bibliográfico correcto, en las referencias que se inserten en nuestros documentos aparecerá el nombre en español. Aunque, a diferencia de lo que ocurre con el campo \ltr author-, si aquí introducimos la información directamente en español, no se produce ningún error. \item[Note:] Cualquier tipo de información adicional que no tenga cabida en el resto de los campos\footnote{Yo lo he usado, por ejemplo, para recoger el nombre de los traductores (en traducciones), o en ediciones que han sido actualizadas por personas distintas del autor original, para recoger el nombre de estos últimos, o en documentación electrónica, para recoger la dirección de Internet donde se encuentra. Aunque para esto último es preferible usar un campo adicional de nombre \ltr url-, pues existen varios estilos no estándar para \btx- que preven la existencia de este campo y son capaces de formatearlo correctamente. Incluso el paquete makebst es capaz de generar automáticamente un estilo bibliográfico que reconozca este campo. Véase la sección \ref{sec:makebst}.}. En los estilos bibliográficos estándar el contenido de este campo se transcribe al final de la referencia y su primera palabra debería empezar en mayúsculas. \item[Number:] Puede tener distintos significados. En los informes técnicos recoge el número de informe de que se trate. En artículos de revista se usa en revistas cuyos distintos ejemplares se identifiquan mediante un \emph{número}, o mediante un número y un volumen. En libros sólo se usa si el libro forma parte de una serie o colección. En los registros de tipo \ltr Book- y \ltr Proceedings- (así como en sus derivados: \ltr InBook-, \ltr InCollection- e \ltr InProceedings-) el contenido de este campo sólo es tomado en consideración si el campo \ltr volume- se ha dejado en blanco. \item[Organization:] La organización que financia una conferencia o que publica un manual. En los registros de tipo \ltr Manual- este campo designa la \emph{autoría} si \ltr author- carece de contenido. \item[Pages:] Se usa en artículos y en partes de libro para designar las páginas concretas en las que un trabajo se encuentra. Los estilos estándar de \btx- esperan que se pongan aquí las páginas inicial y final, separadas por uno o dos guiones. De hecho estos estilos convierten el guión sencillo en uno doble, que es el utilizado en \ltx- para designar intervalos de páginas. Si se quiere indicar sólo la primera página, se utiliza el carácter ``+'' que significa ``desde esa página en adelante''. Como los estilos estándar suponen que se trata de más de una página, en la lista bibliográfica final, a veces al número aquí puesto se le añade la palabra ``páginas'' (\emph{pages}), o la abreviatura ``págs.'' (pp) en plural. \item[Publisher:] La editorial encargada de la publicación de un libro. Su contenido suele complementarse con el del campo \ltr address-. \item[School:] Nombre de la Escuela, Facultad o Instituto en donde se ha confeccionado un trabajo académico (tesis doctoral o tesina de licenciatura). \item[Series:] En libros que forman parte de una colección, se usa para recoger el nombre de la misma. \item[Title:] Es un campo presente en todos los tipos de referencias bibliográficas, y es siempre obligatorio (salvo en las referencias de tipo \ltr Misc-). Designa el título del trabajo al que nos estamos refiriendo, salvo en las referencias tipo \ltr InBook-, donde designa el título del libro del que forma parte el capítulo o rango de páginas al que nos estamos refiriendo. En teoría los estilos bibliográficos estándar \emph{normalizan} (o pueden normalizar) el uso de las mayúsculas y minúsculas en los títulos. Y por ello en las referencias generadas a partir de nuestra base de datos no siempre se escribirán los títulos tal y como aparecen en la base de datos. Para preservar una letra en mayúsculas hay que encerrarla entre llaves. Las llaves pueden ponerse también alrededor de una o varias palabras. Esto es especialmente importante si en el título se usan comandos de \ltx-, ya que en ellos una alteración de las mayúsculas y minúsculas se traduciría en un error. \item[Type:] Este campo existe en \ltr InBook-, \ltr InCollection-\footnote{La documentación oficial de \btx- y los textos que he leído coinciden en que en los registros \ltr InCollection- el campo \ltr type- es opcional. Las pruebas que yo he hecho me llevan a pensar que en estos registros este campo es ignorado. }, \ltr MasterThesis-, \ltr PhdThesis- y \ltr TechReport-. En los tres últimos tipos mencionados los estilos estándar añaden a la referencia, como texto aclaratorio, el nombre del registro. Por ejemplo: en una tesis doctoral, se escribe: ``\emph{Tesis doctoral}''. Si en el campo \ltr type- hay algún texto, se usará este texto en lugar del predeterminado. En los registros \ltr InBook-, aunque por defecto no se escribe ningún texto, sí se escribirá lo que se diga en este campo. Por lo tanto aquí puede escribirse una pequeña aclaración respecto del tipo de trabajo de que se trata, como: ``Conferencia'', ``Disertación'', etc. \item[Volume:] En artículos de revista se usa para indicar en qué tomo de la revista se ha publicado dicho artículo. En libros que formen parte de una serie, para indicar el tomo o volumen, dentro de la serie en cuestión. En este último caso si se da algún valor al campo \ltr volume- los estilos estándar ignorarán el contenido del campo \ltr number-. \item[Year:] El año de la edición del libro o de publicación del artículo. Es otro de los datos presentes (de forma obligatoria u opcional) en todos los tipos de registros. Hay incluso estilos bibliográficos en donde las referencias se ordenan por el valor de este campo, y las citas en el texto lo incluyen también. \end{description} \subsubsection{Algunos consejos sobre tipos de registros y campos} \label{sec:algun-cons-sobre} Cuando empezamos a manejar \btx- la gran cantidad de tipos de registros existentes (catorce en total) puede abrumar. A continuación expongo algunos consejos, dictados por la experiencia, sobre cómo debemos proceder. \begin{enumerate} \item Hay tres tipos de referencia básica: artículos de revista (\ltr article-), libros completos (\ltr book-) y partes de libro. Para las partes de libro a su vez hay tres posibilidades: Si la parte se identifica por un número de sección o de páginas, la referencia correcta es \ltr InBook-, si se identifica por un título, yo distingo, a su vez, según cada parte del libro tenga un autor distinto, en cuyo caso utilizo \ltr InProceedings-, o todo el libro pertenezca al mismo autor, en cuyo caso prefiero usar \ltr InCollection-. Ello es porque no me tomo demasiado en serio el nombre del tipo de referencia, y atiendo más bien al contenido de los campos\footnote{Y no hay que escandilarse por ello. El propio autor de \btx- recomienda en \cite{patashnik88} no tomarse excesivamente en serio los nombres de registros y campos. }. \item Tampoco hay que tomarse demasiado en serio el nombre de los campos. En ocasiones puede ser conveniente, por ejemplo, incluir la ciudad de edición junto con el campo reservado a la editorial, y en otros casos puede ser preferible usar para ello el campo \ltr address-. Lo importante es que seamos consistentes en nuestras decisiones. \item La distinción entre campos obligatorios y opcionales es importante sólo para confirmarnos que hemos elegido el tipo de registro adecuado. Pero tampoco es una tragedia que en un caso concreto, algún campo obligatorio se quede sin rellenar. \item Para la información que consideremos relevante pero para la que no haya ningún campo que la haya previsto, podemos usar el campo \ltr note-. Pero también podemos usar campos específicos creados por nosotros. En tal caso los estilos estándar de \btx- la ignorarán, pero podremos crear un estilo bibliográfico propio que la tenga en cuenta. Yo, por ejemplo, utilizo muchas traducciones, y estimo que el nombre del traductor es un dato importante para la referencia. Empecé usando para ello el campo \ltr note-, pero al final diseñé un campo opcional llamado \ltr traductor-. Sobre la escritura de estilos bibliográficos propios, véase la última parte de este documento. Aunque cuando decidamos crear un campo adicional, si el tipo de datos que queremos incluir en él es relativamente corriente, puede merecer la pena que antes de bautizar el campo, nos demos un paseo por Internet; porque es muy posible que alguien haya ya sentido la necesidad de recoger tales datos, haya creado ese campo y, lo que es más importante, haya escrito un estilo bibliográfico que sepa qué hacer con él. \item También es interesante la creación de campos adicionales para información que es importante para nosotros tener recopilada, pero que no importa a los lectores de nuestros documentos y no tiene por qué incluirse en las referencias bibliográficas generadas. Por ejemplo yo uso para los libros un campo llamado \ltr tejuelo- en el que almaceno la ``etiqueta'' o ``tejuelo'' asignada a determinado libro en la biblioteca de mi centro de trabajo, lo que me ayuda a localizar físicamente el libro con rapidez. \item Por último, aunque he señalado que no hay que tomarse demasiado en serio ni los nombres de los tipos de registro, ni los de los campos, ni su naturaleza obligatoria u opcional, y he añadido que puede ser interesante crear campos propios, todo ello no debe llevarnos a diseñar y escribir una base de datos que sólo nosotros seamos capaces de entender y utilizar. El sentido último de las herramientas de \ltx- (y en general del software libre) es el de \emph{compartir} el trabajo: Que lo que ya ha sido hecho no tenga por qué repetirse (si está bien hecho y el autor autoriza su uso por otros). Cuando empezamos a escribir nuestra base de datos no hay forma de saber si terminará siendo tan importante que merezca la pena compartirla con otros y por ello es mejor empezar a escribirla con la mente puesta en que tal vez en el futuro debamos compartirla. \end{enumerate} \subsection{Otras cuestiones relativas a los ficheros \tpf bib-} \label{sec:otras-cuest-relat} \subsubsection{Uso de abreviaturas y concatenación de cadenas} \label{sec:uso-de-abreviaturas} En un fichero \tpf bib- es posible definir abreviaturas que simplifiquen la escritura de los registros y eviten errores. Para usar una abreviatura, primero hay que definirla de acuerdo con el siguiente formato: \verb|@String{Abreviatura = "Texto sin abreviar"}| El nombre de la abreviatura debe empezar por una letra y no puede contener caracteres en blanco ni ninguno de los siguientes caracteres: \verb|" # % ' ( ) , = { }| El texto sin abreviar se debe especificar entre comillas. Las llaves para delimitar el contenido de ``\texttt{@String}'' son obligatorias. La definición se puede hacer en cualquier lugar del fichero \tpf bib- que no sea el interior de un registro (o de algún otro elemento admitido en este tipo de ficheros). El único requisito en este punto es el de que la definición de una abreviatura debe hacerse \emph{antes} de que ésta sea usada en algún campo. Las abreviaturas no pueden usarse para los nombres de campo o de registro, sino exclusivamente en el contenido del campo. Y como las abreviaturas no pueden estar encerradas dentro de los delimitadores de campo, cuando todo el contenido del campo es una abreviatura, ese campo no requerirá delimitadores de contenido. Así en el siguiente ejemplo: {\small \begin{verbatim} @STRING{TeX = "The {T}e{X} {B}ook"} @Book{eijkhout, author = {Victor Eijkhout}, title = {TeX by topic}, publisher = {Addison Wesley}, year = 1992, } @Book{knuth, author = {Donald E. Knuth}, title = TeX, publisher = {Addison Wesley}, year = 1986, } \end{verbatim} } \noindent Hemos definido la abreviatura ``TeX'' y dos registros, en el título del primero de ellos aparece la cadena ``TeX'', pero \btx- no la toma como una abreviatura, porque tal cadena se encuentra dentro de unas llaves que delimitan el contenido de un campo. Por el contrario, en el segundo registro, el texto ``TeX'' usado como contenido del campo título, es tomado como un uso de la abreviatura, dado que no está dentro de ningún tipo de delimitadores de contenido de campo\footnote{En el ejemplo he escrito para la abreviatura ``TeX'', pero, como \btx- no distingue entre mayúsculas y minúsculas, habríamos obtenido el mismo resultado escribiendo ``TEX'' o ``tex'' tanto en la definición de la abreviatura como más tarde cuando ésta es usada. Podríamos también haber definido ``TEX'' y luego usar ``tex'' o ``TeX''. }. Si la abreviatura no cubre todo el contenido del campo, entonces debemos escribir entre delimitadores normales el contenido no cubierto por la abreviatura, y \emph{concatenar} dicho contenido con el de la abreviatura. En los ficheros \tpf bib- el carácter para concatenar cadenas de texto es ``\#''. Este carácter permite concatenar abreviaturas entre sí, cadenas de texto entre sí y abreviaturas con cadenas de texto. Por ejemplo, si en el fichero \tpf bib- de nuestro anterior ejemplo tuviéramos un libro llamado ``\emph{Comentarios a `The TeX Book' de Knuth}'', y quisiéramos aprovechar la abreviatura que hemos definido para ``\emph{The TeX Book}'', podríamos escribir el campo \ltr title- de dicho libro de la siguiente manera: \verb|title = {Comentarios a `} # TeX # {' de Knuth},| Hay tipos de datos, como el nombre de las revistas científicas, para los que es muy corriente el uso de abreviaturas. De hecho en ciertos campos de conocimiento circulan ficheros en el que se recogen las abreviaturas corrientemente usadas para las revistas más importantes. En tales casos podemos usar dichos ficheros simplemente indicando su nombre en la orden \cmd bibliography- antes del nombre de nuestra base de datos bibliográfica, y separando ambos nombre por una coma. La siguiente línea, por ejemplo, provocaría que ``\texttt{MiBiblio.bib}'' (que cabe suponer que es nuestra base de datos) se concatenara con el fichero distribuido por la \emph{American Mathematical Society} que contiene las abreviaturas habitualmente usadas para las revistas matemáticas: \verb|\bibliography{mrabbrev,MiBiblio}| En los estilos estándar de \btx- hay ya varias abreviaturas definidas por defecto: Están definidos los nombres de los meses del año en inglés (véase las abreviaturas que mencioné al hablar del campo \ltr month- en la nota \ref{meses}), así como el nombre de varias revistas dedicadas al campo de la informática\footnote{Las abreviaturas definidas en el estilo plain son las siguientes: acmcs (ACM Computing Surveys), acta (Acta Informatica), cacm (Communications of the ACM), ibmjrd (IBM Journal of Research and Development), ibmsj (IBM Systems Journal), ieeese (IEEE Transactions on Software Engineering), ieeetc (IEEE Transactions on Computers), ieeetcad (IEEE Transactions on Computer-Aided Design of Integrated Circuits), ipl (Information Processing Letters), jacm (Journal of the ACM), jcss (Journal of Computer and System Sciences), scp (Science of Computer Programming), sicomp (SIAM Journal on Computing), tocs (ACM Transactions on Computer Systems), tods (ACM Transactions on Database Systems), tog (ACM Transactions on Graphics), toms (ACM Transactions on Mathematical Software), toois (ACM Transactions on Office Information Systems), toplas (ACM Transactions on Programming Languages and Systems), tcs (Theoretical Computer Science)}. \subsubsection{Referencias cruzadas entre registros} \label{sec:refer-cruz-entre} En los ficheros \tpf bib- se admiten dos tipos de referencias cruzadas: \begin{enumerate} \item Usando el comando de \ltx- \cmd cite-. \item Mediante el campo \ltr crossref-. \end{enumerate} En cuanto al uso de \cmd cite-, podemos usarlo dentro de un campo para hacer referencia a otro registro. Normalmente esto se hace en el campo \ltr note-, pero se puede hacer en cualquier otro. Esto provocará que al citar en nuestro documento \ltx- una referencia que a su vez cita a otra, ambas se consideren citadas en el documento, y se incluyan las dos en la lista de referencias bibliográficas\footnote{Este es uno de los casos en los que \btx- requerirá una compilación adicional. Porque el comando \cmd cite- incorporado a un registro bibliográfico no será compilado por \ltx- hasta que se compila una versión que incorpore el contenido del fichero \tpf bbl-. E incluso es posible que al incorporar esta nueva cita, sea preciso, tras la segunda ejecución de \ltx-, ejecutar de nuevo \btx-.}. Pero también es posible usar referencias cruzadas de otra manera: para que \btx- sepa que el valor de ciertos campos que normalmente forman parte del contenido de un determinado tipo de registro, pero que en un registro concreto no han sido incluidos, debe ser tomado de otro registro distinto. Por ejemplo, si tenemos un libro homenaje a cierto autor, en el que varios autores han colaborado, cada uno de ellos con un artículo. Si quisiéramos volcar todos estos artículos a nuestra base de datos, podríamos: \begin{enumerate} \item Crear tantos registros como artículos haya e incluir en cada uno de ellos todos los datos requeridos, gran parte de los cuales serán idénticos en todos los registros. \item Abreviar mediante referencias cruzadas, para los datos idénticos escribirlos una sola vez. \end{enumerate} Para seguir el segundo procedimiento, deberíamos empezar por crear un registro del tipo ``Proceedings'' para el libro homenaje en sí mismo considerado, rellenar en él el valor de todos los campos que podamos, y luego en el registro correspondiente a cada uno de los artículos extraidos de dicho libro (que serían referencias de tipo \ltr InProceedings-), usar como valor para el campo \ltr crossref-, el de la clave que hayamos asignado al registro \ltr Proceedings-\footnote{De hecho, si lo pensamos bien, el único sentido que tiene la presencia del campo \ltr booktitle- en los registros de tipo \ltr Proceedings- es el de que este campo se use para llenar el campo del mismo nombre en los registros \ltr InProceedings- que apunten a este.}. El efecto de todo ello será que: \begin{enumerate} \item En los registros \ltr InProceedings- que escribamos para cada uno de los artículos contenidos en el libro, podremos no incluir los campos que ya están en el registro correspondiente al libro general, pues al apuntar \ltr Crossref- al registro correcto, \btx- sabrá que los datos que faltan en el primer registro deben ser tomados del segundo. Esto, además de reducir el tamaño de la base de datos, y ahorrar tiempo para la introducción de los mismos, contribuye a garantizar que todas las veces que estos datos aparezcan, estén escritos exactamente igual. \item Si en un documento \ltx- citamos al menos dos artículos que apunten a un mismo registro, automáticamente se incluirá en la lista final de referencias bibliográficas, además de los trabajos directamente citados por nosotros, el registro correspondiente al libro que los contiene. \end{enumerate} Para que lo anterior funcione correctamente, es preciso que el registro \emph{referenciado} mediante el campo \ltr crossref- (el registro \ltr Proceedings-) se encuentre en la base de datos \emph{después} de los registros referenciadores (los registros \ltr InProceedings-). Los estilos estándar de \btx- admiten referencias cruzadas en los siguientes casos: \begin{enumerate} \item Los registros de tipo \ltr InProceedings- pueden hacer referencia a registros \ltr Proceedings- o \ltr Book-. \item Los registros de tipo \ltr InCollection- pueden hacer referencia a registros \ltr Book-. \end{enumerate} \subsection{Herramientas para manejar ficheros \tpf bib-} \label{sec:herr-para-manej} Existen varias herramientas para la creación y mantenimiento de bases de datos de \btx- cuya utilidad fundamental es la de asegurarse de que todos los registros están correctamente escritos y de que no hemos cometido errores ni en el nombre del tipo del registro ni en el de los campos. Como yo trabajo exclusivamente en sistemas Linux, en este apartado me concentraré en herramientas que funcionen en tales sistemas. Para sistemas MS-DOS, Mac-OS o Microsoft Windows existen otras herramientas que yo no he probado y sobre las que, en consecuencia, no puedo opinar. Existen asimismo herramientas escritas en java que, en teoría, funcionan en cualquier plataforma, aunque yo no las he probado. He leído buenos comentarios sobre dos de ellas: ``jbibtexmanager'' y ``jabref'', ambas son fáciles de localizar en Internet. \subsubsection{Herramientas gráficas} \label{sec:herr-graf} Existen varias herramientas gráficas que permiten trabajar con ficheros \tpf bib- mediante ventanas, botones, barras de herramientas, etc. Las utilidades ofrecidas por estas herramientas son bastante similares. Entre ellas he probado (porque están disponibles directamente en Debian): \begin{description} \item[pybliographer:] Posiblemente sea la más completa de todas las que conozco (aunque admito que no es la que más me gusta, pues es muy difícil de manejar sin el ratón, y yo tengo alergia al ratón). Frente a otras herramientas ofrece las siguientes ventajas: que funciona también en modo de consola, que además del formato \btx- puede manejar otros formatos de bases de datos bibliográficas y, lo que es más importante: es capaz de convertir bases de datos desde unos formatos a otros. \item[Gbib:] Es mi herramienta favorita en este grupo\footnote{Lo que no es mucho decir, pues yo soy usuario de GNU Emacs (del que me ocupo en la próxima sección).}. Forma parte del proyecto Gnome, aunque no suele instalarse por defecto. Posiblemente su principal inconveniente esté en el hecho de que no permite controlar el tipo de codificación en el que hay que grabar el fichero, sino que éste es guardado automáticamente en la codificación preestablecida para el sistema\footnote{Esto puede ocasionar una tediosa labor de \emph{reparación}. Sobre todo si se tiene en cuenta que hasta hace poco la codificación estándar para sistemas Linux españoles era \ltr latin1- o \ltr latin15- y en los últimos tiempos las distribuciones empiezan a migrar a \ltr utf8-. De modo que si en un sistema instalado recientemente abrimos una base de datos escrita hace algún tiempo, introducimos cambios en ella y los guardamos, cabe la posibilidad de que, si no tenemos control sobre las codificaciones usadas, todos los caracteres no anglosajones del fichero se transformen en caracteres ininteligibles que luego habrá que restuarar a mano. }, aunque en realidad este defecto es predicable de las tres herramientas que recojo en la presente sección. \item[Tkbibtex:] Una herramienta muy parecida a las anteriores: permite crear bases de datos nuevas, abrir bases existentes, añadir registros, hacer búsquedas, etc. Apenas le he echado un vistazo. \end{description} \subsubsection{El modo \btx- de GNU Emacs} \label{sec:el-modo-bibtex} Dado que los ficheros \tpf bib- son ficheros de texto, otra posibilidad es editarlos con algún editor de texto que esté provisto de alguna extensión que facilite de alguna manera el trabajo con ellos. Desde este punto de vista casi todos los editores de texto ``avanzados'' son capaces de reconocer la sintaxis de un fichero \tpf bib-, y algunos especialmente preparados para trabajar con el formato \ltx-, como por ejemplo kile, incluyen incluso opciones de menú que permiten insertar registros bibliográficos completos, ahorrándonos el tener que recordar de memoria los campos obligatorios y opcionales de cada uno de los registros. No obstante en este grupo mi favorito sin ningún género de dudas es GNU Emacs. De hecho mi afición a dicho editor se puede comprobar en el hecho de que he escrito y puesto en circulación por Internet dos documentos dirigidos a facilitar su aprendizaje: \cite{ataz-emacs} y \cite{ataz-auctex}\footnote{\cite{ataz-emacs} constituye una introducción general a GNU Emacs, para quien se aproxime por primera vez a este potente editor, y \cite{ataz-auctex} contiene una explicación completa de las utilidades de GNU Emacs en relación con el formato \ltx-, dentro de la cual se incluyen las facilidades para trabajar con ficheros de \btx-.}. Sería demasiado largo recoger aquí todo lo que ya he dicho en \cite{ataz-auctex} (donde dedico al trabajo con ficheros \tpf bib- casi diez páginas) , y por lo tanto me remito a dicho documento. \subsubsection{Otras herramientas disponibles en sistemas linux} \label{sec:otras-herr-disp} Además de las indicadas existen muchísimas otras herramientas disponibles. Si nos centramos, por ejemplo, en una instalación estándar de Debian, las herramientas que se incluyen para trabajar con ficheros \btx- son las siguientes: \begin{description} \item[bib2bib:] Utilidad de consola que lee uno o varios ficheros bibliográficos y filtra sus entradas con respecto a un determinado criterio, generando un nuevo fichero bibliográfico que contenga exclusivamente los registros filtrados. \item[bibclean:] Utilidad de consola para imprimir en pantalla y comprobar la sintaxis de una base de datos \btx-. También es muy útil para reformatear todos los registros, unificando su aspecto visual. \item[bibcursed:] Es un editor de ficheros \tpf bib- que funciona en modo de consola (sin necesidad de tener cargado el sistema gráfico). Puede ser útil para los poco amantes de las ventanas. \item[bibindex:] Utilidad de consola que permite crear un índice binario que acelere las búsquedas hechas en una base de datos con biblook. \item[biblook:] Utilidad de consola que permite realizar búsquedas rápidas en un fichero bibliográfico. Las búsquedas pueden además acelerarse mucho si se genera un índice binario para el fichero mediante la utilidad bibindex. \item[bibtex2html:] Utilidad de consola que permite convertir una base de datos bibliográfica al formato HTML \item[bibtool:] Utilidad de consola que permite realizar varias acciones sobre un fichero \tpf bib-. Es una herramienta muy útil que incluye un muy completo manual de referencia. \end{description} Junto con estas herramientas, que he destacado exclusivamente porque están disponibles de modo directo para cualquier usuario de sistemas Debian (o distribuciones basadas en Debian, como Ubuntu), por Internet circulan numerosas utilidades o scripts para manipular bases de datos bibliográficas en formato \btx-, y en la CTAN están disponibles varias de ellas: no todas trabajan en todos los sistemas, y no todas son igual de útiles, pero merece la pena echarles un vistazo, por lo que recomiendo la consulta del \emph{catálogo general} de la CTAN, organizado por materias, en <<\url{http://texcatalogue.sarovar.org/bytopic.html}>>. \section{Los estilos bibliográficos} \label{sec:los-estil-bibl} \subsection{Descripción de los estilos estándar de \btx-} \label{sec:los-estilos-estandar-1} \btx- se acompaña de cuatro estilos llamados \ltr plain-, \ltr abbrv-, \ltr alpha- y \ltr unsrt-. El estilo esencial es el primero, y los otros funcionan como él en todo salvo en uno o dos puntos concretos. A continuación describiré estos estilos atendiendo exclusivamente a sus características principales y sin entrar en excesivos detalles (cuya descripción con palabras, por otra parte, ocuparía demasiado espacio). Mi consejo para ver exactamente las características de cada uno de los estilos es escribir un fichero \tpf bib- de prueba, incluir un registro de cada uno de los tipos admitidos, llenar \emph{todos} los campos posibles de cada registro, e incluir dicha base de datos en un documento de prueba, en el que hayamos incluido un comando \cmd nocite\{*\}-. En la próxima explicación, menciono varias veces la noción \emph{autoría}. Con ella me quiero referir a lo que ya se explicó en la página \pageref{sec:la-autoria-de}. \begin{description} \item[Estilo ``plain''.] Sus características son: \begin{enumerate} \item La lista bibliográfica final se ordena alfabéticamente atendiendo a la autoría, y si hubiera más de una obra del mismo autor, se toma en cuenta al año de las mismas y después el título. Si sigue habiendo igualdad tras aplicar los criterios anteriores, el último criterio es el del orden en el que fueron citadas y, para obras citadas simultáneamente mediante \cmd nocite\{*\}-, el orden que tengan en la base de datos. \item Las obras incluidas en la lista son numeradas consecutivamente y el número asignado a cada una de ellas, entre corchetes, se convierte en la etiqueta identificativa de la misma que será impresa en el lugar en el que se encuentren los comandos \cmd cite- existentes en el cuerpo del documento. \item Los datos de los campos se incluyen completos. \item Para ciertos campos se añaden determinadas palabras o abreviaturas en inglés. Por ejemplo, tras el contenido del campo \ltr edition- se añade la palabra ``\emph{edition}'', y hay tipos de registro en los que el nombre del campo (en inglés) forma parte de la referencia. \end{enumerate} \item[El estilo ``abbrv'':] Es idéntico al estilo \ltr plain- salvo en el hecho de que para ciertos datos se usan abreviaturas y así el nombre de pila de los autores es sustituido por sus iniciales y el nombre de ciertas revistas (que están predefinidas en el estilo y que se refieren a la informática) es sustituido por su abreviatura. Para la mayor parte de los usuarios, que no usan las revistas predefinidas en el estilo, la única diferencia con \ltr plain- es que del nombre propio del autor sólo se usan las iniciales. \item[El estilo ``alpha'':] Se distingue del estilo \ltr plain- exclusivamente en el hecho de que la etiqueta de identificación de cada obra en la lista no es un número, sino un texto generado automáticamente a partir de la \emph{autoría} de la referencia, el año de publicación y, en ocasiones, el inicio del título\footnote{Como regla se toman las tres primeras letras del nombre del autor y las dos últimas cifras del año de publicación. En obras con varios autores se toma la inicial de los tres primeros seguida de un signo ``+'' en formato de superíndice, si hay más de tres autores. Si con estos criterios a dos referencias se les asignara la misma etiqueta, las obras se ordenan relativamente entre sí, atendiendo a los criterios de ordenación del estilo \ltr plain-, y a las etiquetas se añade una letra para diferenciarlas entre sí: una ``a'' a la primera, una ``b'' a la segunda, etc.}. Asimismo la lista bibliográfica se ordena alfabéticamente según las etiquetas asignadas, y el comando \cmd cite- imprime, en el lugar en el que se encuentre, la etiqueta asignada a la obra citada. \item[El estilo ``unsrt'':] Es igual al estilo \ltr plain- salvo en el hecho de que en él la lista bibliográfica no se ordena alfabéticamente, sino según el orden en el que las distintas obras que aparecen en ella fueron citadas por primera vez. En este caso, para las obras incluidas en la lista de referencias mediante un comando \cmd nocite- se considerará que fueron citadas en el lugar en el que se encuentre tal comando. Y para el comando \cmd nocite\{*\}-, se usará el orden en el que las referencias se encuentren en el fichero \tpf bib-, pero sólo para las referencias que no hubieran sido citadas antes de \cmd nocite\{*\}-. \end{description} En cuanto a las características concretas de formateo de los campos son similares en todos estos estilos. Los aspectos más llamativos son: \begin{enumerate} \item Se escribe el nombre de pila antes que el apellido, lo que no deja de ser chocante en aquellos casos en los que la lista de referencias se ordena alfabéticamente a partir de los apellidos (estilos \ltr plain- y \ltr abbrv-, ya que ello provoca una ordenación alfabética tomando como referencia, no la primera palabra de cada párrafo, sino la segunda o la tercera. \item Los distintos elementos de la referencia se separan mediante un punto. Lo que también provoca problemas cuando el contenido de un campo no es numérico y no empieza con una mayúscula, pues los estilos sólo ajustan el uso de las mayúsculas en el campo \ltr title-. \item Todos los campos aparecen con letra normal, salvo el título de los libros y trabajos académicos y el nombre de las revistas, que aparecen en cursiva. \end{enumerate} \subsection{Estilos adicionales} \label{sec:estilos-adicionales} Junto con estos estilos estándar, existen multitud de estilos disponibles. En la CTAN hay varios de ellos preparados para su descarga, y algunas distribuciones de \ltx- incluyen por defecto ciertos estilos adicionales\footnote{Por ello, antes de buscar estilos adicionales, conviene que nos aseguremos de cuáles son los estilos incluidos en nuestra distribución de \ltx-. Lo que se puede hacer por distintos procedimientos que dependen de nuestra concreta instalación. A falta de algún otro procedimiento específico, podemos buscar los ficheros de extensión \tpf bst- existentes en nuestro sistema; o mejor: los existentes en alguno de los directorios en los que \btx- busca los ficheros de estilo. En la nota \ref{nota:cnf} se explica cómo localizar cuáles son esos directorios en un sistema Unix/Linux.}. Entre los estilos adicionales hay algunos cuya instalación es tan corriente que son estilos \emph{casi} estándar. Otros no son tan conocidos, pero resultan interesantes. Muchos de ellos consisten exclusivamente en uno o varios estilos para \btx-, y otros incluyen también un \emph{paquete} que hay que incluir en el documento principal, mediante \cmd usepackage-, para poder usar el estilo. No voy a explicar todos los estilos adicionales, porque ello sería tedioso, sino exclusivamente los más conocidos e interesantes: \begin{description} \item[abstyles:] Son un conjunto de estilos llamados ``\emph{estilos adaptables}''. Su principal peculiaridad es que ciertas características del estilo están \emph{parametrizadas} de tal manera que pueden ser cambiadas desde el documento \tpf tex- mediante ciertos comandos, aunque en este punto la información que ofrece su fichero de ayuda es verdaderamente críptica. Entre sus inconvenientes puede citarse el hecho de que sólo están preparados para trabajar con documentos en alemán o en inglés. Aunque esto tiene arreglo si en lugar de los \ltr abstyles- propiamente dichos usamos ``\texttt{abstyles-babel}'' que es una modificación de \ltr abstyles- para que si en babel el idioma activo es ``spanish'' el estilo bibliográfico se genere en español. Pero como los estilos que proporcionan ambos paquetes tienen el mismo nombre, si tenemos instalados los dos paquetes en nuestro sistema, sólo funcionará uno de ellos: el primero que sea localizado por \btx- cuando busque el fichero de estilo\footnote{Cuál sea el primero depende de la concreta distribución de \ltx- que tengamos instalada, y de la ruta de búsqueda de ficheros que en ella se haya implementado. Cuando \ltx- (o \btx-) busca un fichero, va mirando por orden en diferentes directorios hasta que lo encuentra.}. \item[achicago:] El estilo de citas basado en el ``\emph{Chicago Manual of Style}'' está implementado por varios paquetes: \ltr achicago-, \ltr achicago.bst-, \ltr chicago-, \ltr jas99-, \ltr jas99m- y \ltr newapa-. También el paquete \ltr authordate- produce citas acordes con el manual de estilo Chicago, aunque este último paquete tiene otras peculiaridades. El estilo de citas Chicago es del tipo Autor-año y, personalmente, para obtener citas de estas prefiero el paquete natbib (que se menciona en seguida). \item[Apalike:] Este estilo también fue escrito por Oren Patashnik (el autor de \btx-). Es un estilo de tipo ``Autor-año'' y para su correcto funcionamiento, hay que cargar en los documentos \ltx- el paquete del mismo nombre que el estilo: \ltr apalike-. \item[Harvard:] La familia de estilos Harvard implica también citas del tipo Autor-año. \item[Natbib:] Natbib es al mismo tiempo un estilo y un paquete, aunque quizás en él destaque más la parte de paquete, por la cantidad de modificaciones que incorpora al funcionamiento del comando \cmd cite-. Durante mucho tiempo (hasta que conocí el trabajo de unos compañeros de la Universidad de Murcia que han diseñado \ltr flexbib-), he considerado que \ltr natbib- era la mejor opción. Permite elegir entre citas del tipo Autor-año o citas numéricas. Incluye versiones adaptadas de los estilos estándar (salvo el estilo \ltr alpha-) llamadas \ltr plainnat-, \ltr abbrvnat- y \ltr unsrtnat-; añade un campo \ltr usr-, dispone de una estupenda documentación e incorpora numerosas modificaciones y mejoras en el procedimiento de las citas. \item[Flexbib:] Este paquete ha sido diseñado en la Universidad de Murcia, y no está disponible en la CTAN, sino en <<\url{http://www.latex.um.es/}>>. Incorpora muchas de las ventajas de \ltr natbib- y a ellas añade dos muy importantes: La primera es que este paquete es sensible a \ltr babel-, la segunda es que muchas de las características esenciales del estilo están \emph{parametrizadas}, es decir: pueden cambiarse sin necesidad de cambiar de estilo, porque funcionan como \emph{opciones} del paquete. Una muy buena descripción del paquete, además de en su página web, en \cite{mira04}. \end{description} \subsection{Cómo españolizar los estilos estándar} \label{sec:como-espan-algun} Los estilos estándar de \btx- están pensados para documentos que se vayan a redactar en inglés y por lo tanto usan partículas, palabras y abreviaturas en inglés. Para conseguir que nuestra lista de referencias figure totalmente en español, sin palabras en inglés, existen varios procedimientos. \begin{enumerate} \item Lo más cómodo es usar algún estilo o paquete que añada a los paquetes estándar la sensibilidad a \ltr babel-. Hay varios paquetes que hacen eso, y más cosas. Podemos citar ``\texttt{abstyles-babel}'', diseñado por Tomás Bautista y que es una adaptación de los abstyles, para que sean sensibles a \ltr babel-, o los paquetes \ltr babelbib- y \ltr flexbib-. \item Usar algún estilo diseñado para el idioma español. En Internet se pueden localizar algunos, y en la CTAN está disponible el estilo ``spain.bst'' basado en las indicaciones que sobre referencias bibliográficas se contienen en el ``Diccionario de ortografía técnica'' de J. Martínez de Sousa. \item Podemos también generar nuestro propio estilo bibliográfico, preparado para trabajar en un idioma concreto. Al respecto estúdiese lo dicho en la sección \ref{sec:como-crear-estilos}. \item Por último, podemos modificar el fichero donde se contiene algún otro estilo, y prepararlo para que trabaje en español. Esta última posibilidad exige un mayor conocimiento del funcionamiento interno de \btx-. Conviene por lo tanto aprender muy bien lo que se expone en la parte \ref{part:btx-avanzado} de este documento. \end{enumerate} Para esta parte de la guía, referida al nivel básico, el procedimiento más adecuado es el primero de los mencionados. \clearpage \part{\btx- intermedio} \label{part:btx-intermedio} \section{Generación automatizada de estilos bibliográficos} \label{sec:como-crear-estilos} Si ninguno de los estilos bibliográficos que acompañan a \btx-, o que están disponibles en la CTAN nos convence, podemos generar nuestro propio estilo bibliográfico. Ello se puede hacer escribiendo a mano nuestro propio estilo, lo que exige un profundo conocimiento del lenguaje usado por los ficheros de estilo (véase la parte \ref{part:btx-avanzado}), o mediante algunas herramientas dirigidas a la generación de ficheros \tpf bst-. Estas herramientas, cuando son ejecutadas, empiezan preguntando al usuario por las características que debe tener el nuevo estilo (preguntas en inglés, ¡of course!), y, con las respuestas dadas, se genera un fichero \tpf bst- que contiene el nuevo estilo o, lo que es más normal, un fichero intermedio a partir del cual es posible generar el fichero \tpf bst-. La herramienta que voy a analizar aquí funciona de esa segunda manera: el fichero intermedio tiene la extensión \tpf dbj- y la herramienta se llama \ltr makebst- y forma parte del paquete <<\texttt{custom-bib}>> (disponible en la CTAN). \subsection{Makebst} \label{sec:makebst} Makebst es un programa para \TeX{} diseñado por Patrick W. Daly que permite generar ficheros bibliográficos personalizados. Para instalarlo\footnote{OJO: Hay distribuciones de \ltx- que instalan por defecto este paquete, por lo que lo mejor es, antes de nada mirar en el directorio predeterminado para los paquetes incluidos con la distribución. En mi sistema ese es <<\url{/usr/share/texmf-tetex/tex/latex/}>>. En el caso de que el paquete ya esté instalado, muy posiblemente no sean precisos los pasos que se indican en el texto.} hay que descargarlo desde la CTAN, descomprimirlo en algún directorio y ejecutar, sucesivamente, los siguientes comandos {\small \begin{verbatim} $> latex makebst.dtx $> latex makebst.ins \end{verbatim} } El primero de estos comandos extraerá del fichero \ltr makebst.dtx- la documentación y el fichero \ltr makebst.ins-. El segundo comando genera un fichero llamado \ltr makebst.tex- que será el que usaremos para generar nuestros estilos personalizados. En el paquete de instalación, junto con \ltr makebst.dtx- se encuentran varios ficheros de extensión \tpf mbs-. El nombre MBS proviene de las siglas de <<\emph{Master \btx- Style}>>. Para la generación de nuestro estilo personalizado deberemos usar dos de esos ficheros: \ltr merlin.mbs- que es el fichero maestro, y un segundo fichero \tpf mbs- que contenga las especificaciones adecuadas al idioma en el que se generará el nuevo estilo. Para que el nuevo estilo esté españolizado ese fichero debe ser \ltr spanish.mbs-, pero podemos también generar estilos en otros idiomas: catalán, esperanto, portugués... etc. También podemos generar un estilo sensible a babel, aunque eso sólo funciona con algunos idiomas, entre los que afortunadamente se encuentra el español. Para generar un estilo, simplemente debemos ejecutar \verb|latex makebst.tex| Ello pondrá en marcha un proceso interactivo en el que se nos harán una serie de preguntas respecto del estilo a generar. Las preguntas van en inglés y, una vez que hemos empezado no es posible la marcha atrás, por lo que si nos equivocamos en alguna respuesta, debemos elegir entre interrumpir el proceso y volver a empezar desde el principio (lo que se hace pulsando primero CTRL-C y después X), o seguir adelante para más tarde modificar a mano el error. Al respecto véase la sección \ref{sec:uso-de-los}. Explicar las distintas preguntas, por el orden en el que aparecen, es complejo, puesto que las preguntas planteadas por makebst son interactivas, es decir: dependiendo de la respuesta dada a cierta pregunta, se plantearán o no otras preguntas adicionales. Además no todas las preguntas tienen la misma importancia y las preguntas se plantean a veces de manera desordenada (en mi opinión), lo que dificulta su tratamiento sistemático. Por ello a continuación en lugar de referirme a todas y cada una de las preguntas que se plantean durante el proceso, las agruparé temáticamente por el orden en el que se plantean, explicando, para cada grupo, la utilidad general de las distintas preguntas, y resaltando las que me parecen más importantes. Como no voy a explicar el significado de todas las preguntas, lo que si haré es dar un consejo general para el caso de que no sepamos que respuesta dar a alguna de ellas: Aceptar la respuesta predeterminada, es decir: pulsar ENTER para pasar a la próxima pregunta. Cuando se enumeran varias respuestas posibles, la respuesta por defecto viene marcada con un asterisco. En los demás casos la respuesta por defecto se indica entre paréntesis, tras la pregunta. La única pregunta que no admite una respuesta por defecto es la relativa al nombre del fichero de salida, es decir: el nombre que tendrá el estilo que queremos crear. Las preguntas que makebst nos hace son las siguientes: \begin{enumerate} \item \textbf{Preguntas generales.} En el primer grupo de preguntas (las cinco primeras) se plantean una serie de cuestiones generales que afectan a ciertos aspectos del funcionamiento de makebst, y al fichero de estilo que se generará. De estas preguntas las más importantes son la 2ª y la 3ª que plantean las siguientes cuestiones: \begin{itemize} \item Nombre del fichero maestro. El fichero maestro es el fichero con base en el cual makebst planteará las próximas preguntas y generará el fichero de estilo solicitado. El valor por defecto es merlin.bst, y este es el valor que en el resto de esta sección asumo que hemos introducido. Si lo cambiamos, las preguntas que se plantearán serán distintas a las que aquí recojo\footnote{Además, para cambiarlo, deberíamos tener algún otro fichero que cumpla su función. Yo no lo conozco, y quien sepa escribirlo, con toda seguridad que no necesita ejecutar makebst para crear su propio fichero de estilo.}. \item Nombre del fichero a generar. Es decir: el nombre que tendrá el estilo que estamos generando. Por ejemplo: ``MiEstilo''. El nombre que indiquemos tiene que ser correcto para nuestro sistema operativo. No hay que especificar la extensión que tendrá el fichero, ya que automáticamente se añadirá la extensión \tpf bst-. \end{itemize} Para el resto de las cuestiones planteadas podemos dejar el valor por defecto. \item \textbf{Preguntas relativas a los ficheros externos.} Makebst utiliza (o puede utilizar) dos ficheros externos, en conjunción con el fichero maestro (que por defecto es merlin.bst). Estos ficheros son uno para la definición de idioma, y otro con nombres extra de revistas: \begin{itemize} \item Fichero para la definición de idioma. Este fichero es esencial porque de él depende el idioma en el que nuestro fichero de estilo generará las listas de bibliográficas. Con el paquete custom-bib se incluyen varios ficheros de definición de idioma (catalán, danés, holandés, inglés, esperanto, finés, francés, etc). Para el español hay que usar el fichero \ltr spanish.mbs-. Si aquí no se elige ningún fichero externo de definición de lenguaje, más tarde se nos preguntará si queremos generar un estilo en inglés (idioma por defecto) o un estilo sensible al idioma activo en el paquete babel. Esta sería la vía para generar un estilo multilingüe. Aunque para que este estilo multilingüe funcione, es preciso disponer de un fichero llamado \ltr babelbst.tex-\footnote{En teoría \ltr babel- debería proporcionar un conjunto de ficheros cada uno de los cuales contuviera la traducción a un idioma de las cadenas de texto usadas por \btx-, junto a un fichero general, \ltr babelbst.tex- que se limitara a cargar el fichero correspondiente al idioma activo. Sin embargo babel no proporciona el fichero \ltr makebst.tex- y además son muy pocos los idiomas para los que existe un fichero de definición de idioma para usar con \btx-. Se supone que el nombre de esos ficheros consiste en el código del idioma correspondinte (por ejemplo: ``es'' para el español, ``fr'' para el francés, ``it'' para el italiano, etc) seguido de ``bst.tex''. O sea, el fichero para el español se debe llamar ``esbst.tex''. Y aunque hay pocos ficheros de definición de idioma, afortunadamente el español es uno de ellos. Es decir: el fichero \ltr esbst.tex- existe. Normalmente se encontrará en el directorio en el que tengamos instalado el paquete babel. Pero seguimos sin tener un fichero llamado \ltr babelbst.tex-, necesario para que el estilo creado con makebst funcione. Podemos crearlo de dos formas: Escribiéndolo nosotros (difícil si no se sabe el bastante \TeX), o cambiándole el nombre a \ltr esbst.tex- por \ltr babelbst.tex- (o creando un enlace, o una copia). Si hacemos esto último, tendremos un estilo sensible a babel pero que sólo será capaz de manejar dos idiomas: el inglés y el español. No estoy seguro de que eso merezca el nombre de ``estilo multilingüe'', pero, afortunadamente, a los hispanoparlantes nos sirve.}. \item Ficheros extra con nombres de revista. Se trata de algunos ficheros incluidos en el paquete custom-bib en los que se recogen abreviaturas estándar para las revistas más importantes y conocidas de ciertos campos científicos\footnote{Los ficheros son: \ltr geojour.mbs-: Revistas de geografía física; \ltr photjour.mbs-: Revistas de óptica; \ltr physjour.mbs-: Revistas de física y \ltr supjour.mbs-: Revistas suplementarias.}. Si incluimos estos ficheros haremos que el estilo que estamos generando incluya abreviaturas preestablecidas para las revistas incluidas en tales ficheros. \end{itemize} \item \textbf{Preguntas relativas al estilo de las citas:} Este grupo de preguntas posiblemente sea el que en mayor medida marque el tipo de estilo que estamos generando. Las citas pueden ser básicamente de los siguientes estilos: \begin{enumerate} \item Estilo estándar \ltx-. Es lo que se llama \emph{estilo numérico}: a cada obra incluida en la lista bibliográfica final se le asigna un número, el cual es el que se imprime en los lugares del texto donde dicha obra sea citada mediante el comando \cmd cite-. Este es el estilo de citas que usan tres de los cuatro estilos estándar de \btx-: \ltr plain-, \ltr abbrv- y \ltr unsrt-. También es el estilo que usa \ltx- cuando la bibliografía se construye sin la ayuda de \btx-. Este estilo es el estilo por defecto para makebst. \item Estilo Autor-año. Este estilo es un estándar en determinados campos científicos y admite diferentes modalidades (natbib, apalike, harvard, astronomy, chicago). Básicamente consiste en que para cada obra incluida en la lista de referencias se genera una etiqueta que contiene el apellido completo del autor y el año de publicación. Las distintas modalidades inciden en cómo se separan ambos elementos, y afectan también a qué hacer en el caso de que haya varios autores. Si el mismo autor tiene varias obras el mismo año, se diferencian unas de otras añadiendo una letra al año, como, por ejemplo, en \ltr Ataz 1980a-. \item Estilo \ltr alpha-. En cierto modo se puede considerar una modalidad del estilo Autor-año, porque para cada obra incluida se genera una etiqueta a partir del apellido del autor, año de la obra y, en su caso, inicio del título. Pero la diferencia está en que mientras el estilo Autor-año pretende que el lector sólo con la lectura de la etiqueta se haga una idea aproximada de qué obra se ha citado, en el estilo \ltr alpha-, la etiqueta no pretende tener sentido, sino que simplemente sirve para identificar a cada obra citada en el trabajo de manera única. Por ello normalmente no se usa el apellido completo, ni este se separa del año, el cual tampoco suele ponerse completo. Esta es la razón de que cuando se habla de estilos tipo ``Autor-año'' el estilo \ltr alpha- nunca se entienda incluido en tal expresión. Para el estilo \ltr alpha- makebst admite tres modalidades, en las que la etiqueta se construye de diferente manera. En la primera, cuando hay varios autores, la etiqueta se construye a partir de la inicial de cada autor. En la segunda modalidad, cuando hay varios autores, se usa el apellido del primero, como si hubiera un solo autor. En la tercera modalidad, el apellido del autor se incluye entero en la etiqueta. \item Estilo en el que el contenido de la etiqueta identificativa de las obras en la lista de referencias es igual a la clave interna de la referencia en el fichero \tpf bib-. Este estilo está pensado exclusivamente para cuando se quieran generar listados del contenido de una base de datos bibliográfica. \end{enumerate} Pues bien: en la primera pregunta de este grupo de preguntas deberemos elegir entre uno de estos seis estilos (cuatro estilos básicos de los que uno de ellos admite tres modalidades). Dependiendo del estilo elegido, las siguientes preguntas varían. Y así: \begin{enumerate} \item Si se eligió estilo tipo Autor-Año, se nos preguntará, de las distintas variedades que este estilo tiene (natbib, apalike, harvard, astronomy, chicago) cuál preferimos, pudiendo incluso elegir una variedad innominada, siempre que dispongamos de un fichero \tpf sty- que la implemente. \item Si no se eligió el estilo Autor-Año, se nos preguntará si queremos que se genere salida HTML. Se trata de una utilidad que permite que el fichero de estilo, en lugar de generar un fichero \tpf bbl- construido con comandos \ltx-, genere un fichero HTML, lo que sería una forma fácil de escribir una página HTML que incluya un listado bibliográfico. Aunque la verdad es que hay otras utilidades para eso que me gustan más. En todo caso, si decidimos contestar que sí, podemos elegir tres modalidades para el HTML. En la primera las referencias se separarán por párrafos; en la segunda, las referencias se incluirán en una lista HTML, y en la tercera se incluyen las claves internas de las referencias. Si aceptamos cualquiera de estas posibilidades hay que tener en cuenta que cualquier intento de compilar nuestro documento principal tras haber ejecutado \btx- sobre él y generado el fichero \tpf bbl-, generará un error, porque el tal fichero \tpf bbl- internamente no consta de comandos \ltx-, sino de comandos HTML. \end{enumerate} \item \textbf{Preguntas relativas a campos adicionales:} Las siguientes dos preguntas afectan a los campos en nuestra base de datos. Si hemos construido un fichero \tpf bib- en el que sólo estén los campos estándar, hay que contestar a ambas que no. Pero es posible que hayamos añadido dos campos extra para los registros, y contestando ``y'' (de ``yes'') a estas dos preguntas, conseguiríamos que tales campos sean reconocidos por el estilo. Los campos a que se refieren estas preguntas son los siguientes: \begin{enumerate} \item Campo \ltr language-. Si en nuestra base de datos las referencias tienen un campo llamado \ltr language- cuyo contenido es el nombre del idioma en que está el título de la referencia en cuestión, tal y como hay que referirse a dicho idioma en \ltr babel-, y contestamos que si a esta pregunta, en nuestro estilo se activará el idioma correspondiente a cada referencia antes de incluirla en la lista de referencias. Eso garantiza que la partición en guiones del título sea correcta de acuerdo con las reglas correspondientes al idioma en el que dicho título esté escrito. En caso de que para alguna referencia no constara valor para este campo, se usaría el idioma por defecto para el documento. Téngase en cuenta, además, que para usar esta utilidad, en el encabezamiento de nuestro fichero \tpf tex-, al incluir la orden \cmd usepackage\{babel\}- hay que especificar como idiomas a cargar todos aquellos que se encuentren representados en la base de datos. \item Campo \ltr annote-. Este campo se puede haber incluido para anotaciones extra sobre la referencia a que se refiere un registro. Si disponemos de él, y contestamos que sí a la pregunta que nos haga makebst, su contenido será incluido en la lista de referencias final. \end{enumerate} \item \textbf{Orden de las referencias:} La siguiente pregunta también es muy importante, aunque sólo se hace en el caso de que no hayamos elegido el estilo de citas \ltr alpha-. Se trata del orden en el que queremos que aparezcan las referencias citadas en la lista de referencias. La ordenación posible varía dependiendo del estilo de citas elegido. Si se eligió como cita el estilo numérico (o el basado en la clave), podemos elegir entre: \begin{itemize} \item Orden alfabético de autores. Es la respuesta por defecto. \item Orden de citas. Funciona del modo similar al estilo estándar \ltr unsrt-. \item Orden cronológico (por el valor del campo \ltr year-) y después por autores. \item Orden cronológico inverso, es decir: como el anterior, pero empezando por las referencias más recientes. \end{itemize} Pero si elegimos el estilo de citas Autor-año, entonces la segunda opción es la de ordenar por etiquetas, sistema este que es exigido por algunas revistas y que provoca una ordenación más sensible que la alfabética pura por autores. Las diferencias están en el caso de que haya autores con obras firmadas por ellos solos y con obras en colaboración. \item \textbf{Formateo de los autores y fechas}. A continuación se incluyen varias preguntas (12 en total, creo) relativas a cómo formatear el nombre de los autores y las fechas. Yo supongo que estos campos se tratan antes que los demás, porque son los que se usan en el estilo de citas Autor-año, y porque en la lista de referencias que se generará, el campo autor es siempre el primero. Las cuestiones aquí planteadas son muchas y, si quiero evitar que este documento se haga interminable, no puedo ocuparme de todas de forma pormenorizada. A título de ejemplo enunciaré las siguientes: \begin{itemize} \item Cómo tratar las partículas que separan el nombre de los apellidos. Es decir: ``Miguel de Cervantes'' ¿debe clasificarse en la ``D'' como ``De Cervantes, Miguel'', o en la ``C'' como ``Cervantes, Miguel De''? Recordemos, a efectos de esta pregunta, que \btx- identifica que una parte de un nombre es partícula que separa el nombre de pila de los apellidos en el caso de que dicha parte esté escrita con minúsculas. \item Cómo escribir el nombre de los autores. Podemos elegir entre varias posibilidades que combinan varios factores, como si escribir o no el nombre de pila completo, si colocar o no los apellidos antes que el nombre, si poner o no un punto detrás de las iniciales, etc. En total se ofrecen diez posibilidades para esta pregunta. \item Tipo de letra para el nombre de los autores: Normal, versalitas, negrita, etc. \item Lugar en el que hay que imprimir la fecha. \item Tipo de letra para la fecha. \item Etc. La verdad es que las preguntas son exhaustivas y si me ocupara de todas este documento llegaría al centenar de páginas. Hay preguntas para, por ejemplo, la puntuación entre los nombres de los autores, qué hacer en el caso de que se repitan en la lista dos obras del mismo autor, qué hacer en el caso de que haya demasiados autores para una referencia, cómo debe aparecer el nombre del autor en las etiquetas (si se eligió un estilo de citas tipo Autor-año), qué hacer cuando en algún registro no conste la fecha, qué uso dar al contenido del campo \ltr month-, cómo ordenar los datos que componen la fecha, etc. \end{itemize} \item \textbf{Formateo de los distintos campos}: El siguiente grupo de cuestiones (más de 30) afecta al formateo que recibirán los distintos campos en los diferentes tipos de registro, aunque también se cuelan algunas preguntas extra sobre ciertos campos adicionales a los estándar. Este grupo de preguntas es el que me parece especialmente desordenado, o en el que yo no he sabido descubrir cuál es el orden. Se empieza preguntando por el campo título de los artículos, se sigue preguntando por otros datos sobre artículos y, de pronto, se salta al título en las tesis doctorales, el título y número en los informes técnicos, para volver otra vez a las revistas... Las preguntas son numerosas, pero no muy difíciles de entender si se tienen presentes los tipos de registro y los campos de cada uno de ellos. \item \textbf{Preguntas relativas a la puntuación entre las distintas partes de la referencia bibliográfica}. En este grupo de preguntas (en total cinco) podemos elegir el tipo de puntuación que, de modo general, separará a unas partes de otras en la referencia bibliográfica (punto, coma, punto y coma) y el tipo de puntuación que se usará para separar ciertos campos específicos. Estos campos son: \begin{itemize} \item El campo \ltr author-. Es el primer dato de las referencias, y muchas personas tienen la costumbre de separar este dato del resto mediante el signo de los dos puntos, cuyo uso no tiene sentido para separar el resto de los campos. \item El campo \ltr note-. Suele ser el último dato y podemos elegir para él que siempre vaya precedido de un punto, aunque el resto de los campos se separen entre sí de otra manera. \end{itemize} \item \textbf{Opciones dependientes del idioma:} Si en la pregunta correspondiente elegimos un fichero de definición de idioma, a partir de aquí las preguntas serán extraidas de dicho fichero. En total las preguntas son 9, y en ellas se nos plantea si se deben usar o no ciertas palabras y abreviaturas tales como ``páginas'', ``editor'', etc. Ello implica en ocasiones volver a temas ya tratados como, por ejemplo, el formateo de los nombres de los autores, ahora para ver cómo usar la partícula separadora de dos o más autores, la cual varía dependiendo del idioma. Ese volver a temas anteriores, contribuye a que, como antes dije, se produzca la sensación de que las preguntas se plantean de manera desordenada. \item \textbf{Otras preguntas:} Las siguientes preguntas (cuatro o cinco), acentúan aun más la sensación de desorden de la que hablaba, porque se vuelve otra vez a preguntar sobre posibles campos adicionales en nuestra base de datos. En tal sentido se nos pregunta si usamos o no campos adicionales para REVTeX\footnote{El paquete REVTeX, de la Sociedad Física Americana (APS) da soporte para algunos campos adicionales en las bases de datos: collaboration, eid, eprint, archive, numpages y url.}. Entre estas preguntas es especialmente importante, en mi opinión, la relativa a si usamos o no un campo \ltr url-. Si en nuestra base de datos hemos añadido, para documentos electrónicos, un campo url destinado a almacenar su dirección en Internet, constestamos que sí en esta pregunta el contenido de este campo se incluirá en la referencia bibliográfica y se formateará correctamente, aunque, para esto último, es preciso que en nuestro documento \ltx- hayamos cargado el paquete \ltr url-. \item \textbf{Preguntas relativas a la compatibilidad de los comandos a utilizar en el fichero \tpf bbl-:} Las dos penúltimas preguntas se refieren a qué comandos usar dentro del fichero \tpf bbl- que es generado por \btx-. Ello afecta a la compatibilidad de dicho fichero con las distintas versiones de \ltx-. En concreto las preguntas se refieren a cómo generar la cursiva, y a la compatibilidad o no con plain \TeX. \item \textbf{La última pregunta:} Finalmente se nos informa que se ha generado un fichero \tpf dbj- y se nos pregunta si queremos ejecutarlo. Si respondemos que sí se generará ya nuestro fichero de estilo. Si respondemos que no (respuesta por defecto) para generar el fichero de estilo deberemos ejecutar nosotros mismos el fichero \tpf dbj-, lo que se explica en la próxima sección. \end{enumerate} \subsection{Uso de los ficheros \tpf dbj-} \label{sec:uso-de-los} Al terminar la ejecución de makebst, en el directorio desde donde se le hubiera llamado un fichero con el nombre que hayamos indicado al principio del proceso (en la tercera pregunta) y con extensión \tpf dbj-. Si a la última pregunta respondimos que sí, tendremos además un fichero, del mismo nombre y con extensión \tpf bst-. Este último fichero es nuestro fichero de estilo, y por lo tanto para usarlo basta con copiarloa alguno de los directorios en los que \btx- busca los ficheros de estilo\footnote{Lo que depende de nuestra concreta distribución. En la distribución estándar para sistemas Unix/Linux, ese directorio sería \ltr /usr/local/share/texmf/bibtex/-.}. Pero de momento es mejor concentrarnos en el fichero \tpf dbj-. En él se contiene la información necesaria para generar un fichero de estilo con las características que hemos especificado a lo largo del proceso que se acaba de ver. El fichero de estilo se generará simplemente ejecutando \ltx- sobre el fichero \tpf dbj-. Así, por ejemplo, si nuestro estilo se llama \ltr MiEstilo-, para generar el fichero \ltr MiEstilo.bst- nos basta con, en la línea de comandos, ejecutar \verb|latex MiEstilo.dbj| Por lo tanto, si queremos generar un nuevo fichero de estilo, muy parecido al que acabamos de generar, pero con alguna variante, es mucho más cómodo \emph{modificar} el fichero \tpf dbj- que volver a ejecutar makebst. Asimismo, si durante la ejecución de makebst, en algún momento nos equivocamos, en lugar de interrumpir el proceso y volver a empezar, es más razonable terminarlo y luego modificar el fichero \tpf dbj-. En el fichero \tpf dbj- se almacenan todas las preguntas planteadas por makebst, a partir de las relativas al uso de ficheros externos, con sus correspondientes respuestas. Tanto las preguntas como las respuestas posibles van, en general, precedidas de un signo de comentario (\%). Y para cada pregunta se distingue entre la respuesta por defecto y las restantes. La respuesta por defecto aparece sangrada con respecto a las demás, y en las restantes respuestas, tras el signo \% al principio de la línea, hay una cadena de texto, seguida de una coma y un nuevo signo \% tras el que se contiene el texto de la respuesta. Pues bien: para cada pregunta hecha por makebst y recogida en el fichero \tpf dbj-: \begin{enumerate} \item Si todas las respuestas empiezan con una marca de comentario, significa que la respuesta a esa pregunta coincide con el valor por defecto (siempre la primera respuesta, algo más sangrada que las restantes). \item Si alguna línea no empieza por una marca de comentario, significa que esa fue la respuesta elegida. \end{enumerate} Por lo tanto, para cambiar algún detalle en un estilo, disponiendo del fichero \tpf dbj- es más sencillo modificar a mano este fichero que volver a ejecutar makebst. Tras modificar el fichero \tpf dbj-, ejecutando \ltx- sobre él se generará un nuevo fichero de estilo con la nueva característica activada. Por ejemplo: Imaginemos que tenemos un estilo, llamado ``MiEstilo'' en el que el nombre de los autores se escribe en letra normal, y queremos que se escriba en negrita. Debemos abrir el fichero \ltr MiEstilo.dbj- y buscar la pregunta correspondiente al formato del nombre del autor. Una vez localizada veremos lo siguiente: {\small \begin{verbatim} %TYPEFACE FOR AUTHORS IN LIST OF REFERENCES: %: (def) Normal font for author names % nmft,nmft-sc,%: Small caps authors % nmft,nmft-it,%