refdbib - Online en la nube

PROGRAMA:

NOMBRE

refdbib - el cliente de bibliografía de RefDB

SINOPSIS

refdbib [-d base de datos] [-D directorio-estilo-especificación] [-e destino de registro] [-E codificación]
[-f stdin] [-h] [-i Dirección IP] [-l nivel de registro] [-L archivo de registro] [-m] [-N número]
[-p Puerto] [-q] [-r] [-S style] [-t Tipo de salida] [-T time] [-u nombre ] [-v] [-V]
[-w la contraseña] [-x] [-y confiar] nombre de archivo

DESCRIPCIÓN

refdbib es un cliente de línea de comandos para generar bibliografías con RefDB(7). refdbib lee
los contenidos de nombre de archivo, que contiene una lista de citas como documento XML según
a listadecitacionesx.dtdy envía una bibliografía en el formato solicitado a stdout. Si no
se especifica el archivo de entrada, refdbib intenta leer los datos de stdin. A menos que se suprima,
también escribe un archivo de especificación de estilo (ya sea una hoja de estilo DSSSL o XSLT) y un CSS
hoja de estilo para la salida HTML a su disco.

refdbib es una herramienta de bajo nivel. Es recomendable utilizar uno de los envoltorios enviados con
RefDB. babero(1) es un script de shell que crea la lista de citas, ejecuta refdbib en
esta lista y transforma el documento. refdbnd(1) es un sistema basado en Makefile que
encapsula convenientemente la generación de bibliografía y la transformación de documentos.

Esta página de manual describe solo las opciones de inicio de refdbib. Consultar RefDB
manual (ver a continuación) para una descripción de los formatos de entrada y salida, así como para
instrucciones de posprocesamiento que se requieren para algunos tipos de salida.

OPCIONES

-d base de datos
El nombre de la base de datos predeterminada. Puede cambiar la base de datos en cualquier momento durante una
sesión interactiva.

-D directorio-estilo-especificación
Especifique una ruta completa o. para usar el directorio de trabajo actual para la salida
de la especificación de estilo y archivos CSS. El último caso es lo que normalmente desea si
ejecuta refdbib desde el directorio donde está almacenado su documento LaTeX o SMGL / XML.
Este también es el predeterminado si no especifica un directorio en absoluto.

-e destino de registro
log-destination puede tener los valores 0, 1 o 2, o las cadenas equivalentes stderr,
syslogo presentar, respectivamente. Este valor especifica a dónde va la información del registro.
0 (cero) significa que los mensajes se envían a stderr. Están disponibles de inmediato en el
pantalla, pero pueden interferir con la salida del comando. 1 enviará la salida al
facilidad de syslog. Tenga en cuenta que syslog debe estar configurado para aceptar mensajes de registro
de los programas de usuario, consulte el syslog(8) página de manual para obtener más información. Tipo Unix
los sistemas generalmente guardan estos mensajes en /var/log/user.log. 2 enviará los mensajes a
un archivo de registro personalizado que se puede especificar con el -L .

-E codificación
Seleccione una codificación de caracteres de salida. Si no se utiliza esta opción, los datos de bibliografía
utilizará la codificación de caracteres de la base de datos. Ver iconov_abierto(3) para obtener una lista de
codificaciones disponibles.

-f stdin
Esta es una muleta para hacer posible la lectura de datos de stdin en plataformas que no
permiten la detección automática de datos en stdin, como Windows / Cygwin. En otras plataformas,
refdbib lee automáticamente los datos de stdin si hay datos disponibles.

-h
Muestra la pantalla de ayuda y uso, luego sale.

-i Dirección IP
Configure la dirección IP de la caja que está ejecutando el servidor de aplicaciones refdbd(1).
En lugar de la dirección IP, también puede especificar el nombre de host siempre que sea posible
correctamente resuelto por su sistema.

-l nivel de registro
Especifique la prioridad hasta la que se registran los eventos. Este es un número entre 0
y 7 o una de las cuerdas emergentes, alerta, crit, equivocarse, advertencia, para, info, depurar,
respectivamente (consulte también Definiciones de nivel de registro). -1 deshabilita el registro por completo. Un bajo
un nivel de registro como 0 significa que solo se registran los mensajes más críticos. Un registro más alto
nivel significa que también se registran los eventos menos críticos. 7 incluirá depuración
mensajes. Este último puede ser detallado y abundante, por lo que desea evitar este nivel de registro
a menos que necesite localizar problemas.

-L archivo de registro
Especifique la ruta completa a un archivo de registro que recibirá los mensajes de registro. Normalmente esto
sería / var / log / refdba.

-m
Este interruptor convierte los errores causados ​​por referencias faltantes (es decir, citados pero no disponibles en
la base de datos) en advertencias, lo que hace que refdbib devuelva 0 en lugar de un código de error.

-N número
Utilice esta opción para especificar dónde se supone que debe comenzar la numeración de las referencias.
El valor predeterminado es 1. Esta opción es útil si necesita improvisar compuestos
Bibliografías o bibliografías por capítulo que aún deben numerarse
consecutivamente.

-p Puerto
Configure el puerto de la caja que ejecuta el servidor de aplicaciones.

-q
Empiece sin leer los archivos de configuración. El cliente usará el tiempo de compilación
valores predeterminados para todos los valores que no establezca con los modificadores de la línea de comandos.

-r
Utilice esta opción para solicitar una bibliografía cruda en lugar de cocida. Bibliografías en bruto
no están formateados de ninguna manera y se procesan con el DocBook o TEI estándar
hojas de estilo en lugar de con los archivos del controlador RefDB.

-S style
Especifica el estilo de la bibliografía. Esto controla el formato de la bibliografía y
las citas en el texto cuando se procesa el documento.

-t Tipo de salida
Seleccione el tipo de salida. Usar db31 para generar bibliografías DocBook SGML, db31x for
Bibliografías DocBook XML (basadas en DTD, hasta 4.3), db50x para Docbook V5 XML
bibliografías (basadas en esquemas), tejo para bibliografías XML TEI P4, tei5x para TEI P5
Bibliografías XML, bibtex para bibliografías BibTeX, y rtf para bibliografías RTF.
El tipo de salida también determina el tipo de archivo de especificación de estilo, si lo hay, que
se generará además de la bibliografía para fines de formato. Este es
solo es motivo de preocupación si desea procesar un documento DocBook XML con el DSSSL
hojas de estilo: en este caso debe utilizar db31 con esta opción. La bibliografía SGML
El elemento también es un elemento XML válido, pero obtendrá un archivo de controlador DSSSL en lugar de un
Archivo de controlador XSL cuando utiliza db31x.

Nota: En la implementación actual, el -t tejo La opción también devolverá un DocBook
bibliografía que necesita ser transformada en una bibliografía TEI con la
bibdb2tei.xsl hoja de estilo. los -t tei5x La opción crea un TEI directamente utilizable
bibliografía.

-T time
Establezca el tiempo de espera para el diálogo cliente / servidor de aplicaciones en segundos. Una conexión con
Los intentos fallidos de lectura o escritura se considerarán muertos y eliminados después de
ha transcurrido esta cantidad de tiempo.

-u nombre
Establezca el nombre de usuario para el acceso a la base de datos. Nota: este nombre de usuario no tiene por qué ser idéntico a
el nombre de inicio de sesión del usuario. Este es el nombre de usuario requerido para acceder a la base de datos.
servidor.

-v
Imprime la versión y la información de copyright, luego sale.

-V
Cambia al modo detallado.

-w la contraseña
Establezca la contraseña para el acceso a la base de datos. Nota: No es necesario que esta contraseña sea idéntica a
la contraseña de inicio de sesión del usuario. Esta es la contraseña requerida para acceder a la base de datos.
servidor.

-x
Envíe contraseñas sin cifrar.

-y confiar
Especifique el directorio donde se encuentran los archivos de configuración global. Nota: De forma predeterminada, todos
Las aplicaciones RefDB buscan sus archivos de configuración en un directorio especificado
durante el paso de configuración al crear el paquete. Es decir, no necesitas el -y
opción a menos que utilice binarios precompilados en ubicaciones inusuales, por ejemplo, reubicando un
paquete rpm.

La diagnostica

El código de salida es 0 si todo salió bien. Será 1 si el comando devolvió un error, o si
Hubo una condición de error general durante el inicio como falta de memoria disponible.

CONFIGURACIÓN

refdbib evalúa el archivo de configuración refdbibrc al inicio para inicializarse.

Mesa 1. refdbibrc
┌───────────────┬────────────────────────┬──────── ───────────────────┐
│Variable │ Predeterminado │ Comentario │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│refdblib │ (ninguno) │ La ruta de un directorio │
│ │ │ que contiene │ para compartir
│ │ │ archivos como DTD, HTML │
│ │ │ plantillas, etc. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│defaultdb │ (ninguno) │ La base de datos predeterminada. │
│ │ │ refdbib usará esto │
│ │ │ base de datos a menos que │
│ │ │ especifique las bases de datos en │
│ │ │ los elementos de cita de │
│ │ │ sus documentos. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│pager │ stdout │ La línea de comando de un │
│ │ │ buscapersonas que acepta el │
│ │ │ salida de refdb en stdin │
│ │ │ para permitir el desplazamiento y │
│ │ │ otras cosas ingeniosas. │
│ │ │ “stdout” envía los datos │
│ │ │ a stdout. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│passwd │ * │ La contraseña que es │
│ │ │ utilizado para la autenticación │
│ │ │ con la base de datos │
│ │ │ servidor. Es │
│ │ │ potencialmente malvado para │
│ │ │ almacenar sin cifrar │
│ │ │ contraseñas en archivos de disco. │
│ │ │ Al menos asegúrese de que │
│ │ │ el archivo de inicio no es │
│ │ │ legible para cualquiera │
│ │ │ más. El predeterminado │
│ │ │ el ajuste causa refdbib │
│ │ │ para solicitar su contraseña │
│ │ │ de forma interactiva. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│port │ 9734 │ El puerto en el que refdbd │
│ │ │ escucha. Cambiar esto por │
│ │ │ todos los clientes y el │
│ │ │ servidor si este valor │
│ │ │ interfiere con otro │
│ │ │ programa usando este puerto. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│serverip │ 127.0.0.1 │ La dirección IP o │
│ │ │ nombre de host de la máquina │
│ │ │ donde se ejecuta refdbd. Utilice │
│ │ │ el predeterminado (localhost) │
│ │ │ dirección si los clientes │
│ │ │ y refdbd se ejecutan en │
│ │ │ misma máquina. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│timeout │ 180 │ El tiempo de espera en segundos. │
│ │ │ Después de este tiempo │
│ │ │ transcurrido, un estancado │
│ │ │ se toma la conexión │
│ │ │ abajo. Incrementa esto │
│ │ │ valor si encuentra │
│ │ │ frecuentes errores de tiempo de espera │
│ │ │ debido a una red alta │
│ │ │ tráfico o refdbs │
│ │ │ sobrecarga. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│nombre de usuario │ nombre de inicio de sesión │ El nombre de usuario que es │
│ │ │ utilizado para la autenticación │
│ │ │ con la base de datos │
│ │ │ servidor. Esto puede ser │
│ │ │ diferente al inicio de sesión │
│ │ │ nombre del usuario. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│verbose │ f │ Ajústelo en t si │
│ │ │ prefiero el error detallado │
│ │ │ mensajes. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│logfile │ /var/log/refdbib.log │ La ruta completa de un │
│ │ │ archivo de registro personalizado. Esto es │
│ │ │ se usa solo si logdest es │
│ │ │ configurado correctamente. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│logdest │ 1 │ El destino del │
│ │ │ información de registro. 0 = │
│ │ │ imprimir en stderr; 1 = usar │
│ │ │ la facilidad syslog; 2 = │
│ │ │ use un archivo de registro personalizado. │
│ │ │ Este último necesita un │
│ │ │ ajuste adecuado de │
│ │ │ archivo de registro. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│loglevel │ 6 │ El nivel de registro hasta │
│ │ │ qué mensajes serán │
│ │ │ enviado. Un ajuste bajo (0) │
│ │ │ permite solo lo máximo │
│ │ │ mensajes importantes, un │
│ │ │ el ajuste alto (7) permite │
│ │ │ todos los mensajes incluidos │
│ │ │ mensajes de depuración. -1 significa │
│ │ │ no se registrará nada. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│outtype │ db31 │ El tipo de salida │
│ │ │ generado. Usar db31 para │
│ │ │ DocBook SGML │
│ │ │ bibliografías, db31x │
│ │ │ para DocBook XML │
│ │ │ bibliografías, tejo para │
│ │ │ Bibliografías XML TEI, │
│ │ │ y bibtex para BibTeX │
Bibliografías │ │ │. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│formato │ (ninguno) │ El estilo bibliográfico │
│ │ │ que se utilizará para │
Salida │ │ │. Este es el nombre │
│ │ │ de un estilo como era │
│ │ │ previamente agregado al │
│ │ │ base de datos. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│stylespecdir │. │ Una ruta a un directorio │
│ │ │ (incluido el final │
│ │ │ separador de directorio) │
│ │ │ que recibirá el │
│ │ │ archivos de controlador de hoja de estilo. │
│ │ │ La configuración predeterminada será │
│ │ │ dirija los archivos del controlador │
│ │ │ al trabajo actual │
│ │ │ directorio que más │
│ │ │ probablemente contiene el │
│ │ │ archivos de entrada. Debería │
│ │ │ rara vez es necesario │
│ │ │ use una configuración diferente. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│startnumber │ 1 │ El número donde │
│ │ │ numeración de referencia │
│ │ │ comienza en. Esta opción │
│ │ │ es sobre todo útil para │
│ │ │ compilación avanzada │
│ │ │ bibliografías o para C │
│ │ │ boneheads que insisten │
│ │ │ que el conteo comienza en │
│ │ │ cero. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│toencoding │ (la codificación de la base de datos) │ La codificación de caracteres │
│ │ │ para la bibliografía │
Salida │ │ │. Si esto no es │
│ │ │ especificado, los datos │
│ │ │ usa la misma codificación que │
│ │ │ la base de datos. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│ignore_missing │ f │ Si se establece en "f", │
│ │ │ referencias faltantes (es decir, │
│ │ │ citado pero no en el │
│ │ │ base de datos) arrojará un │
│ │ │ error. Si se establece en "t", │
│ │ │ recibirás una advertencia pero │
│ │ │ las referencias faltantes serán │
│ │ │ no causa refdbib a │
│ │ │ devuelve un error. │
├───────────────┼────────────────────────┼──────── ───────────────────┤
│no_encrypt │ f │ Si se establece en 't', contraseñas │
│ │ │ se transmiten │
│ │ │ sin cifrar. El predeterminado │
│ │ │ es cifrar contraseñas. │
└───────────────┴────────────────────────┴──────── ───────────────────┘

EJEMPLOS

El primer ejemplo muestra cómo crear un archivo de bibliografía DocBook SGML.

$~
refdbib -d misrefs -S "Br.J.Pharmacol". -t db31 -D "." mipapel.id.xml > mipapel.bib.sgml

Este comando utilizará la base de datos "myrefs" para recuperar las referencias definidas en
mypaper.id.xml. Se formatearán de acuerdo con el estilo de bibliografía denominado
"Br.J.Pharmacol". y será redirigido al archivo de bibliografía mypaper.bib.sgml. los
Archivo de controlador DSSSL (se nombrará automáticamente según el estilo de bibliografía, es decir
Br.J.Pharmacol.dsl) se almacenará en el directorio de trabajo actual.

El segundo ejemplo muestra cómo crear la bibliografía BibTeX a partir de su documento LaTeX
(se supone que corriste látex al menos una vez antes de este comando.

$~
refdbib -d misrefs -S "nombre" -t bibtex mipapel.aux > mipapel.bib

Este comando utilizará la base de datos "myrefs" para recuperar las referencias definidas en
mypaper.aux. La base de datos de bibliografía intermedia se almacenará en mypaper.bib y
servir como archivo de entrada para bibtex.

Nota
En aras de la coherencia con bibtex, es posible especificar el archivo auxiliar
sin la extensión .aux (mypaper en el ejemplo anterior).

Si está trabajando en un documento extenso que cita las mismas referencias una y otra vez,
puede ser prudente preprocesar el archivo .aux para eliminar duplicados (duplicados
no confundir bibtex pero desperdician espacio):

$~
sort mipapel.aux | uniq | refdbib -d misrefs -S "nombre" -t bibtex > mipapel.bib

Nota
El script runbib hace exactamente este tipo de preprocesamiento automáticamente.

Utilice refdbib en línea utilizando los servicios de onworks.net