runbib – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

runbib – erstellt RefDB-Bibliografien

ZUSAMMENFASSUNG

Runbib [-a für Fahrer] [-b HTML-Treiber] [-c xhtml-Treiber] [-d Datenbank] [-E Codierung]
[-G CSS-Datei] [-h] [-i IP-Adresse] [-I Name] [-j jade-args] [-N Anzahl] [-r] [-s]
[-S Stil] [-t Ausgabetyp] [-u Name] [-w Passwort] Dateinamen

BESCHREIBUNG

Dieses Shell-Skript ist ein Wrapper für den Bibliographie-Client refdbib(1) zur Vereinfachung
Erstellung von Bibliographien. Für SGML- und XML-Dokumente führt runbib zunächst openjade oder aus
xsltproc(1), um eine Liste der Zitate aus Ihrem Quelldokument abzurufen. Dann
es läuft refdbib(1) die Bibliographie als externe Einheit basierend auf zu generieren
extrahierte Zitatinformationen. Außerdem werden Stylesheet-Treiberdateien mit erstellt
Formatierungsinformationen für nachfolgende Dokumenttransformationen. Für BibTeX-Dokumente:
runbib verwendet die Informationen in der .aux-Datei, um eine Bibliographiedatei abzurufen, die Sie erstellen können
als Eingabedatei verwenden für Bibtex(1).

OPTIONAL

-a für Fahrer
Der vollständige Pfad einer benutzerdefinierten XSL-Treiberdatei für die Druckausgabe. Diese Datei muss importiert werden
die entsprechende RefDB für die Treiberdatei.

-b HTML-Treiber
Der vollständige Pfad einer benutzerdefinierten XSL-Treiberdatei für die HTML-Ausgabe. Diese Datei muss importiert werden
entsprechende RefDB-HTML-Treiberdatei.

-c xhtml-Treiber
Der vollständige Pfad einer benutzerdefinierten XSL-Treiberdatei für die XHTML-Ausgabe. Diese Datei muss importiert werden
die entsprechende RefDB xhtml-Treiberdatei.

-d Datenbank
Der Name der Standarddatenbank.

-E Codierung
Wählen Sie eine Ausgabezeichenkodierung aus. Wenn diese Option nicht verwendet wird, werden die Bibliographiedaten angezeigt
verwendet die Zeichenkodierung der Datenbank. Sehen iconv_open(3) für eine Liste von
verfügbaren Kodierungen.

-G CSS-Datei
Legen Sie den Pfad oder die URL einer CSS-Datei fest, die von der (x)html-Ausgabe verwendet werden soll

-h
Zeigt den Hilfe- und Verwendungsbildschirm an und wird dann beendet.

-i IP-Adresse
Legen Sie die IP-Adresse der Box fest, auf der der Anwendungsserver ausgeführt wird refdbd(1).
Anstelle der IP-Adresse können Sie ggf. auch den Hostnamen angeben
von Ihrem System ordnungsgemäß gelöst.

-I Name
Ändern Sie den Wert einer Entitätsdeklaration, um markierte Abschnitte einzuschließen. Mehrfache Einträge
Sind möglich. Diese werden als übergeben -i Optionen für Jade/OpenJade.

-j jade-args
Legen Sie zusätzliche Befehlszeilenoptionen für Jade/OpenJade fest

-N Anzahl
Mit dieser Option legen Sie fest, wo die Nummerierung der Referenzen beginnen soll.
Der Standardwert ist 1. Diese Option ist praktisch, wenn Sie Verbundwerkstoffe zusammensetzen müssen
Bibliographien oder kapitelweise Bibliographien, die noch nummeriert werden müssen
nacheinander.

-r
Verwenden Sie diese Option, um eine Roh- statt einer gekochten Bibliographie anzufordern. Rohbibliographien
sind in keiner Weise formatiert und werden mit dem Standard-DocBook oder TEI verarbeitet
Stylesheets statt mit den RefDB-Treiberdateien.

-s
Überspringen Sie den ID-Extraktionsschritt von runbib. Sie müssen eine XML-Datei mit passendem Namen bereitstellen
enthält die angeforderten IDs.

-S Stil
Gibt den Bibliographiestil an. Dies steuert die Formatierung der Bibliographie und
die In-Text-Zitate bei der Bearbeitung des Dokuments.

-t Ausgabetyp
Wählen Sie den Ausgabetyp aus. Verwenden db31 um DocBook SGML-Bibliographien zu generieren, db31x für
DocBook XML-Bibliographien, Teix für TEI-XML-Bibliographien, Bibtex für BibTeX
Bibliographien und rtf für RTF-Bibliographien.

-u Name
Legen Sie den Benutzernamen für den Datenbankzugriff fest. Hinweis: Dieser Benutzername muss nicht identisch sein mit
der Anmeldename des Benutzers. Dies ist der Benutzername, der für den Zugriff auf die Datenbank erforderlich ist
Server.

-w Passwort
Legen Sie das Passwort für den Datenbankzugriff fest. Hinweis: Dieses Passwort muss nicht identisch sein mit
das Login-Passwort des Benutzers. Dies ist das Passwort, das für den Zugriff auf die Datenbank erforderlich ist
Server.

CONFIGURATION

Anstatt die Befehlszeilenschalter zu verwenden, kann runbib auch mithilfe von konfiguriert werden
runbib-Konfigurationsdatei. Wie bei allen refdb-Konfigurationsdateien können Sie eine verwalten
globale Kopie in /usr/local/etc/refdb/ und eine Kopie pro Benutzer in $ HOME. Denken Sie daran, dass die
Die Runbib-Konfigurationsdatei deckt nur die Optionen ab, an die nicht übergeben wird refdbib(1) als
Dieses Tool verfügt über eine eigene Konfigurationsdatei.

Tisch 1. refdbjaderc
┌────────────────┬─────────┬──────────── ────────── ────┐
│Variable │ Standard │ Kommentar │
├────────────────┼─────────┼──────────── ────────── ────┤
│jade_includearg │ none │ Ändern Sie den Wert eines │
│ │ │ Entitätserklärung an │
│ │ │ enthalten markierte Abschnitte. │
│ │ │ Mehrfacheinträge sind │
│ │ │ möglich. Das sind │
│ │ │ übergeben als -i Optionen zu │
│ │ │ Jade/OpenJade. │
├────────────────┼─────────┼──────────── ────────── ────┤
│jadeargs │ keine │ Zusätzlichen Befehl festlegen │
│ │ │ Zeilenoptionen für │
│ │ │ Jade/OpenJade. Verwenden Sie z. B. │
│ │ │ „-E 0“, um das │ zu deaktivieren
│ │ │ maximale Fehlergrenze │
├────────────────┼─────────┼──────────── ────────── ────┤
│outformat │ db31 │ Standardausgabe festlegen │
│ │ │ formatieren. Unterstützte Werte │
│ │ │ sind db31 (DocBook SGML │
│ │ │ 3.1 und höher), db31x │
│ │ │ (DocBook XML 3.1 und │
│ │ │ später), db50x (DocBook │
│ │ │ XML 5.0 und höher), teix │
│ │ │ (TEI P4), bibtex und │
│ │ │ rtf. │
└────────────────┴─────────┴──────────── ────────── ────┘

SGML AUSGABE

refdbib generiert zusätzlich zu der von Jade/OpenJade erstellten ID-Liste zwei Ausgabedateien.
runbib erstellt daraus eine weitere Ausgabedatei. Vorausgesetzt, Sie haben eine Quelldatei foo.sgml
und verwenden Sie den Bibliographiestil J.Biol.Chem. Sie erhalten:

J.Biol.Chem.dsl
Dies ist die DSSSL-Treiberdatei, die einige zusätzliche Formatierungsinformationen kodiert
spezifisch für den gewählten Bibliographiestil zur Verwendung im nachfolgenden Dokument
Transformationen. Diese Datei wird in das aktuelle Arbeitsverzeichnis geschrieben. Der
Die Treiberdatei ist ein Stylesheet mit doppeltem Zweck für HTML und druckbare Ausgabe.

foo.id.xml
Dies ist die XML-Zwischendatei, die die Zitate in foo.sgml kodiert.

foo.bib.sgml
Dies ist die Datei, die das DocBook-Bibliographieelement enthält. Das müssen Sie mit einbeziehen
Datei als externe Entität in Ihr Quelldokument einbinden, um die Bibliographie zu integrieren
in Ihren Text ein.

J.Biol.Chem.css
Dies ist eine CSS-Datei, die Formatierungsinformationen enthält, die von der HTML-Ausgabe verwendet werden.

XML AUSGABE

refdbib generiert erneut zwei Ausgabedateien wie für die DocBook SGML-Ausgabe oben, und wir auch
Zählen Sie die von xsltproc erstellte ID-Liste. Runbib führt jedoch eine kleine Nachbearbeitung durch.
Sie erhalten also am Ende zwei zusätzliche Dateien. Angenommen, Sie haben eine Quelldatei foo.xml und
Verwenden Sie den Bibliographiestil J.Biol.Chem. Sie erhalten:

J.Biol.Chem.fo.xsl
Dies ist die XSL-Treiberdatei, die für die druckbare Ausgabe verwendet wird und zusätzliche Informationen enthält
Formatierungsinformationen, die für den gewählten Bibliographiestil spezifisch sind. Diese Datei wird sein
in das aktuelle Arbeitsverzeichnis geschrieben.

J.Biol.Chem.html.xsl
Dies ist die XSL-Treiberdatei, die für die HTML-Ausgabe verwendet wird und zusätzliche Formatierungen enthält
Informationen, die für den gewählten Bibliographiestil spezifisch sind. In diese Datei wird geschrieben
das aktuelle Arbeitsverzeichnis.

foo.id.xml
Dies ist die XML-Zwischendatei, die die Zitate in foo.xml kodiert.

foo.bib.xml
Dies ist die Datei, die die DocBook- oder TEI-Bibliographie enthält. Das müssen Sie mit einbeziehen
Datei als externe Entität in Ihr Quelldokument einbinden, um die Bibliographie zu integrieren
in Ihren Text ein.

J.Biol.Chem.css
Dies ist eine CSS-Datei, die Formatierungsinformationen enthält, die von HTML oder XHTML verwendet werden
Ausgabe.

BIBTEX AUSGABE

refdbib erstellt eine Ausgabedatei mit den Referenzinformationen. Wenn Ihr Dokument benannt ist
foo.tex, Latex erstellt eine Datei foo.aux, die refdbib als Eingabedatei verwendet. Die refdbib
Die Ausgabedatei erhält dann den Namen foo.bib und kann von verwendet werden Bibtex als Eingabedatei.

RTF AUSGABE

refdbib erstellt eine Ausgabedatei mit den Referenzinformationen. Wenn Ihr Dokument benannt ist
foo.rtf, RTFCitationen extrahiert die Zitate und schreibt sie in foo.id.xml, welches refdbib ist
Wird als Eingabedatei verwendet. Die refdbib-Ausgabedatei erhält dann den Namen foo.bib.rtf und kann sein
genutzt von refdbrtf als Eingabedatei.

BEISPIEL

Sie sollten dieses Skript wie alle anderen in dem Verzeichnis ausführen, in dem Ihre Dokumentdateien gespeichert sind
Die Ausgabe wird standardmäßig in das aktuelle Arbeitsverzeichnis geschrieben.

Der folgende Befehl erstellt eine DocBook SGML-Bibliographiedatei zusammen mit einem DSSSL
Stylesheet-Treiberdatei für das DocBook SGML-Dokument mypaper.sgml. Die Ausgabedateien sind
optimiert, um dem Zitier- und Bibliografiestil des „Journal of Biological“ zu entsprechen
Chemistry“, das zuvor unter dem Namen „J.Biol.Chem.“ zur Datenbank hinzugefügt wurde. Alle
Es wird davon ausgegangen, dass Referenzen, die keinen fest codierten Datenbanknamen enthalten, in der liegen
Datenbankleiste.

~$
Runbib -d Bar -S „J.Biol.Chem.“ -t db31 mypaper.sgml

Verwenden Sie Runbib online über die Dienste von onworks.net