Cómo usar los scripts proporcionados con Pybliographer.
Zoltán Kóta
zoltank@gmail.com
Frédéric Gobry
frederic.gobry@epfl.ch

Creative Commons Compartir Igual 3.0

# Scripts existentes

Algunos scripts se proporcionan con Pybliographer, como ejemplos y herramientas útiles. Son bastante cortos y deberían entenderse con un conocimiento básico de Python.

# pybcheck

          	Esta herramienta coge una lista de de archivos o carpetas y comprueba si son válidos (sintaxis, que no haya entradas con la misma clave, etc.)

Es posible usar su salida directamente en un búfer de compilación de emacs, para saltar directamente a los errores encontrados. Para hacerlo, escriba M x compile, y el comando pybcheck yourfiles, y use el botón central para saltar al archivo que ha fallado.

# pybcompact

    	Esta herramienta extrae las citas hechas en un documento LaTeX y genera un archivo BibTeX que las contiene.

Generalmente, uno almacena sus bibliografías en uno o varios archivos BibTeX grandes, y permite que bibtex extraiga las entradas usadas en un documento LaTeX. Pero a veces es conveniente crear un paquete autocontenido (por ejemplo, para compartirlo de forma nativa con alguien, o para almacenarlo), con un archivo BibTeX minimalista que explote exactamente las entradas usadas en LaTeX. Esta herramienta hace exactamente eso: lee un archivo LaTeX.aux y extrae las entradas correspondientes de las bases de datos BibTeX especificadas.

# pybconvert

    	Esta herramienta convierte de un formato bibliográfico a otro.

La sintaxis general es muy sencilla. Por ejemplo, para convertir de Refer a BibTeX ejecute:

    	bash$ pybconvert refer..bibtex toto.refer toto.bib

# pybformat

    	Este script genera una bibliografía siguiendo un estilo bibliográfico, y lo genera en un formato específico (similar a HTML, LaTeX, …) como debería aparecer en un documento.

El formato general del comando es

    	bash$pybformat [opciones] base de datos...

Este comando sin opciones usará el estilo denominado alfa para crear una bibliografía en formato Texto. Hay disponibles varias opciones para crear estos documentos:

--style=... o -s ...: especifica un estilo bibliográfico. Éste puede ser una ruta completa a un archivo XML existente o a un nombre que se buscará en los lugares habituales. El predeterminado es «Alpha».

--format=... o -f ...: especifica un formato de salida (HTML, LaTeX, Raw, Text, Textau, Textnum). El predeterminado es «Text». (Textau y Textnum son versiones ligeramente modificadas de Text. Consulte la para obtener más detalles.)

--output=... o -o ...: especificar un nombre de archivo de salida. El predeterminado es la salida estándar (STDOUT).

--header=... o -H ...: define un archivo que se antepondrá al archivo de salida.

--footer=... o -F ...: define un archivo que se añadirá al archivo de salida.

--list=output o -l output: lista los formatos de salida disponibles

# pybtex

    	Esta herramienta busca las citas en un documento LaTeX y genera un archivo bibliográfico en LaTeX.

Esta herramienta lee un archivo .aux de LaTeX, extrae las entradas correspondientes de las bases de datos de BibTeX y crea un archivo .bbl de LaTeX.

El formato del comando es

    	bash$ pybtex archivo-latex [archivos-bibtex...]

# pybtext

    	Esta herramienta procesa un archivo de texto que contenga citas y añade una bibliografía siguiendo un estilo dado.

El script busca citas como [clave] o [clave1,clave2...] en un archivo de texto (por ejemplo: ...Esto es un fragmento de texto con citas [AKM95,MPJ+03] insertadas desde pybliographer...). Primero, de acuerdo con la primera clave encontrada en el archivo de texto, genera una lista de referencias. Usando un estilo adecuado (vea más abajo), reemplaza las claves de la base de datos en el cuerpo del texto con las claves nuevas generadas por el módulo de estilo y, finalmente, añade la lista de referencias al texto resultante en un archivo nuevo.

Las claves de las entradas seleccionadas se puede copiar fácilmente desde pybliographer en un editor de texto o en una terminal usando copiar y pegar o arrastrar y soltar.

El formato general del comando es

    	bash$ pybtext [-o archivo_de_salida] [-s style] archivo_de_texto archivos_bib...

Este comando sin opciones usará el estilo denominado Abbrev y archivo_de_texto.pyb como archivo de salida que procesar. archivo_de_texto es el nombre del archivo que procesar y archivos_bib son uno o más archivos de bases de datos bibliográficas.

Hay tres estilos diferentes diseñados para pybtext. Usando abbrvbib las claves son como se han definido en la base de datos. Con el estilo abbrvau, se puede generar las claves tipo autor-año (ej. Jackson et al., 2004). Usando abbrvnum, el script produce una lista numerada. Para «abbrvau» y «abbrvnum», se usan los formatos «Textau» y «Textnum» respectivamente. Son simples modificaciones del formato «Text», optimizado para esos estilos. Usando otros estilos (Alpha, Abbrev o apa4e), el cuerpo del texto no se procesa, pero la lista de referencia se añade al formulario que corresponde al estilo usado.