refdbib - Dalam talian di Awan

JADUAL:

NAMA

refdbib - klien bibliografi RefDB

SINOPSIS

refdbib [-d pangkalan data] [-D stylespec-direktori] [-e log-destinasi] [-E pengekodan]
[-f stdin] [-h] [-i Alamat IP] [-l peringkat log] [-L fail log] [-m] [-N nombor]
[-p pelabuhan] [-q] [-r] [-S gaya] [-t jenis keluaran] [-T masa] [-u nama] [-v] [-V]
[-w kata laluan] [-x] [-y confdir] nama fail

DESCRIPTION

refdbib ialah klien baris arahan untuk menjana bibliografi dengan RefDB(7). refdbib membaca
kandungan nama fail, yang mengandungi senarai petikan sebagai dokumen XML mengikut
kepada senarai kutipanx.dtd, dan menghantar bibliografi dalam format yang diminta kepada stdout. Jika tidak
fail input ditentukan, refdbib cuba membaca data daripada stdin. Melainkan ditindas, ia
juga menulis fail spesifikasi gaya (sama ada DSSSL atau lembaran gaya XSLT) dan CSS
lembaran gaya untuk output HTML ke cakera anda.

refdbib ialah alat peringkat rendah. Adalah dinasihatkan untuk menggunakan salah satu pembungkus yang dihantar bersama
RefDB. runbib(1) ialah skrip shell yang mencipta senarai petikan, menjalankan refdbib pada
senarai ini, dan mengubah dokumen. refdbnd(1) ialah sistem berasaskan Makefile yang
merangkum penjanaan bibliografi dan transformasi dokumen dengan mudah.

Halaman manual ini menerangkan hanya pilihan permulaan refdbib. Sila rujuk RefDB
manual (lihat di bawah) untuk penerangan tentang format input dan output, serta untuk
arahan pasca pemprosesan yang diperlukan untuk beberapa jenis output.

PILIHAN

-d pangkalan data
Nama pangkalan data lalai. Anda boleh menukar pangkalan data pada bila-bila masa semasa
sesi interaktif.

-D stylespec-direktori
Tentukan sama ada laluan penuh atau . untuk menggunakan direktori kerja semasa untuk output
spesifikasi gaya dan fail CSS. Kes terakhir adalah perkara yang biasanya anda mahukan jika
anda menjalankan refdbib dari direktori tempat dokumen LaTeX atau SMGL/XML anda disimpan.
Ini juga merupakan lalai jika anda tidak menentukan direktori sama sekali.

-e log-destinasi
log-destination boleh mempunyai nilai 0, 1, atau 2, atau rentetan yang setara stderr,
syslog, Atau fail, masing-masing. Nilai ini menentukan ke mana maklumat log pergi.
0 (sifar) bermakna mesej dihantar ke stderr. Mereka boleh didapati dengan serta-merta di
skrin tetapi mereka mungkin mengganggu output arahan. 1 akan menghantar output ke
kemudahan syslog. Perlu diingat bahawa syslog mesti dikonfigurasikan untuk menerima mesej log
daripada program pengguna, lihat syslog(8) halaman manual untuk maklumat lanjut. seperti Unix
sistem biasanya menyimpan mesej ini dalam /var/log/user.log. 2 akan menghantar mesej kepada
fail log tersuai yang boleh ditentukan dengan -L pilihan.

-E pengekodan
Pilih pengekodan aksara output. Jika pilihan ini tidak digunakan, data bibliografi
akan menggunakan pengekodan aksara pangkalan data. Lihat iconv_open(3) untuk senarai
pengekodan yang tersedia.

-f stdin
Ini adalah tongkat untuk membolehkan membaca data daripada stdin pada platform yang tidak
benarkan pengesanan automatik data pada stdin, seperti Windows/Cygwin. Pada platform lain,
refdbib secara automatik membaca data daripada stdin jika data tersedia.

-h
Memaparkan skrin bantuan dan penggunaan, kemudian keluar.

-i Alamat IP
Tetapkan alamat IP kotak yang menjalankan pelayan aplikasi refdbd(1).
Daripada alamat IP anda juga boleh menentukan nama hos selagi boleh
diselesaikan dengan betul oleh sistem anda.

-l peringkat log
Tentukan keutamaan sehingga acara yang dilog. Ini sama ada nombor antara 0
dan 7 atau satu daripada rentetan muncul, berjaga-jaga, kr, sesat, amaran, notis, maklumat, debug,
masing-masing (lihat juga definisi peringkat Log). -1 melumpuhkan pengelogan sepenuhnya. A rendah
tahap log seperti 0 bermakna hanya mesej yang paling kritikal dilog. Log yang lebih tinggi
tahap bermakna peristiwa yang kurang kritikal dicatatkan juga. 7 akan termasuk nyahpepijat
mesej. Yang terakhir ini boleh menjadi verbose dan banyak, jadi anda ingin mengelakkan tahap log ini
melainkan anda perlu menjejaki masalah.

-L fail log
Tentukan laluan penuh ke fail log yang akan menerima mesej log. Biasanya ini
ialah /var/log/refdba.

-m
Suis ini mengubah ralat yang disebabkan oleh rujukan yang hilang (iaitu disebut tetapi tidak tersedia dalam
pangkalan data) menjadi amaran, menyebabkan refdbib mengembalikan 0 dan bukannya kod ralat.

-N nombor
Gunakan pilihan ini untuk menentukan di mana penomboran rujukan sepatutnya bermula.
Lalai ialah 1. Pilihan ini berguna jika anda perlu menyusun komposit
bibliografi atau bibliografi setiap bab yang masih perlu dinomborkan
berturut-turut.

-p pelabuhan
Tetapkan port kotak yang menjalankan pelayan aplikasi.

-q
Mulakan tanpa membaca fail konfigurasi. Pelanggan akan menggunakan masa penyusunan
lalai untuk semua nilai yang anda tidak tetapkan dengan suis baris arahan.

-r
Gunakan pilihan ini untuk meminta yang mentah dan bukannya bibliografi yang dimasak. Bibliografi mentah
tidak diformat dalam apa-apa cara dan diproses dengan Buku Dokumen atau TEI standard
lembaran gaya dan bukannya dengan fail pemacu RefDB.

-S gaya
Menentukan gaya bibliografi. Ini mengawal pemformatan bibliografi dan
petikan dalam teks apabila dokumen diproses.

-t jenis keluaran
Pilih jenis output. guna db31 untuk menjana bibliografi DocBook SGML, db31x khususnya
Bibliografi XML DocBook (berasaskan DTD, sehingga 4.3), db50x untuk Docbook V5 XML
bibliografi (berasaskan skema), teix untuk bibliografi TEI P4 XML, tei5x untuk TEI P5
bibliografi XML, bibtex untuk bibliografi BibTeX, dan rtf untuk bibliografi RTF.
Jenis output juga menentukan jenis fail spesifikasi gaya, jika ada, itu
akan dijana sebagai tambahan kepada bibliografi untuk tujuan pemformatan. Ini adalah
hanya satu perkara yang membimbangkan jika anda ingin memproses dokumen XML DocBook dengan DSSSL
lembaran gaya: Dalam kes ini, anda harus menggunakan db31 dengan pilihan ini. Bibliografi SGML
elemen juga merupakan elemen XML yang sah, tetapi anda akan mendapat fail pemacu DSSSL dan bukannya a
Fail pemacu XSL apabila anda menggunakan db31x.

Nota: Dalam pelaksanaan semasa, -t teix pilihan juga akan mengembalikan DocBook
bibliografi yang perlu diubah kepada bibliografi TEI dengan
bibdb2tei.xsl lembaran gaya. The -t tei5x pilihan mencipta TEI yang boleh digunakan secara langsung
bibliografi.

-T masa
Tetapkan tamat masa untuk dialog klien/pelayan aplikasi dalam beberapa saat. Kaitan dengan
percubaan membaca atau menulis yang tidak berjaya akan dianggap sebagai mati dan diturunkan selepas itu
jumlah masa ini telah berlalu.

-u nama
Tetapkan nama pengguna untuk akses pangkalan data. Nota: Nama pengguna ini tidak semestinya sama dengan
nama log masuk pengguna. Ini adalah nama pengguna yang diperlukan untuk mengakses pangkalan data
pelayan.

-v
Mencetak maklumat versi dan hak cipta, kemudian keluar.

-V
Bertukar kepada mod verbose.

-w kata laluan
Tetapkan kata laluan untuk akses pangkalan data. Nota: Kata laluan ini tidak semestinya sama dengan
kata laluan log masuk pengguna. Ini adalah kata laluan yang diperlukan untuk mengakses pangkalan data
pelayan.

-x
Hantar kata laluan tidak disulitkan.

-y confdir
Tentukan direktori di mana fail konfigurasi global berada Nota: Secara lalai, semua
Aplikasi RefDB mencari fail konfigurasi mereka dalam direktori yang ditentukan
semasa langkah konfigurasi semasa membina pakej. Iaitu, anda tidak memerlukannya -y
pilihan melainkan anda menggunakan binari tersusun di lokasi luar biasa, cth dengan menempatkan semula a
pakej rpm.

DIAGNOSTIK

Kod keluar ialah 0 jika semuanya berjalan lancar. Ia akan menjadi 1 jika arahan mengembalikan ralat, atau jika
terdapat keadaan ralat umum semasa permulaan seperti kekurangan memori yang tersedia.

CONFIGURATION

refdbib menilai fail konfigurasi refdbibrc pada permulaan untuk memulakan sendiri.

Jadual 1. refdbibrc
┌───────────────┬─────────────────────────┬─────── ───────────────────┐
│Pembolehubah │ Lalai │ komen │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│refdblib │ (tiada) │ Laluan direktori │
│ │ │ mengandungi boleh dikongsi │
│ │ │ fail seperti DTD, HTML │
│ │ │ templat dsb. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│defaultdb │ (tiada) │ Pangkalan data lalai. │
│ │ │ refdbib akan menggunakan ini │
│ │ │ pangkalan data melainkan anda │
│ │ │ nyatakan pangkalan data dalam │
│ │ │ unsur petikan │
│ │ │ dokumen anda. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│pager │ stdout │ Baris arahan a │
│ │ │ alat kelui yang menerima │
│ │ │ output refdb pada stdin │
│ │ │ untuk membenarkan menatal dan │
│ │ │ perkara-perkara bagus yang lain. │
│ │ │ “stdout” menghantar data │
│ │ │ untuk stdout. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│passwd │ * │ Kata laluan iaitu │
│ │ │ digunakan untuk pengesahan │
│ │ │ dengan pangkalan data │
│ │ │ pelayan. Ia adalah │
│ │ │ berpotensi jahat kepada │
│ │ │ simpan tidak disulitkan │
│ │ │ kata laluan dalam fail cakera. │
│ │ │ Sekurang-kurangnya pastikan │
│ │ │ fail init bukan │
│ │ │ boleh dibaca oleh sesiapa sahaja │
│ │ │ lain. Lalai │
│ │ │ tetapan menyebabkan refdbib │
│ │ │ untuk meminta kata laluan anda │
│ │ │ secara interaktif. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│port │ 9734 │ Port yang refdbd │
│ │ │ mendengar. Tukar ini untuk │
│ │ │ semua pelanggan dan │
│ │ │ pelayan jika nilai ini │
│ │ │ mengganggu │ yang lain
│ │ │ atur cara menggunakan port ini. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│serverip │ 127.0.0.1 │ Alamat IP atau │
│ │ │ nama hos mesin │
│ │ │ tempat refdbd dijalankan. Gunakan │
│ │ │ lalai (localhost) │
│ │ │ alamat jika pelanggan │
│ │ │ dan refdbd dijalankan pada │
│ │ │ mesin yang sama. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│masa tamat │ 180 │ Tamat masa dalam beberapa saat. │
│ │ │ Selepas masa ini telah │
│ │ │ berlalu, terhenti │
│ │ │ sambungan diambil │
│ │ │ bawah. Tingkatkan ini │
│ │ │ nilai jika anda menemui │
│ │ │ ralat tamat masa yang kerap │
│ │ │ kerana rangkaian yang tinggi │
│ │ │ lalu lintas atau refdbs │
│ │ │ beban berlebihan. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│nama pengguna │ nama log masuk │ Nama pengguna iaitu │
│ │ │ digunakan untuk pengesahan │
│ │ │ dengan pangkalan data │
│ │ │ pelayan. Ini mungkin │
│ │ │ berbeza daripada log masuk │
│ │ │ nama pengguna. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│verbose │ f │ Tetapkan ini kepada t jika anda │
│ │ │ lebih suka ralat verbose │
│ │ │ mesej. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│logfile │ /var/log/refdbib.log │ Laluan penuh │
│ │ │ fail log tersuai. Ini ialah │
│ │ │ digunakan hanya jika logdest ialah │
│ │ │ tetapkan dengan sewajarnya. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│logdest │ 1 │ Destinasi │
│ │ │ maklumat log. 0 = │
│ │ │ cetak ke stderr; 1 = guna │
│ │ │ kemudahan syslog; 2 = │
│ │ │ gunakan fail log tersuai. │
│ │ │ Yang terakhir memerlukan │
│ │ │ tetapan yang betul bagi │
│ │ │ fail log. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│loglevel │ 6 │ Tahap log sehingga │
│ │ │ yang mana mesej akan menjadi │
│ │ │ dihantar. Tetapan rendah (0) │
│ │ │ membenarkan hanya yang paling │
│ │ │ mesej penting, a │
│ │ │ tetapan tinggi (7) membenarkan │
│ │ │ semua mesej termasuk │
│ │ │ mesej nyahpepijat. -1 bermaksud │
│ │ │ tiada apa yang akan dilog. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│outtype │ db31 │ Jenis output │
│ │ │ dihasilkan. guna db31 untuk │
│ │ │ DocBook SGML │
│ │ │ bibliografi, db31x │
│ │ │ untuk DocBook XML │
│ │ │ bibliografi, teix untuk │
│ │ │ Bibliografi XML TEI, │
│ │ │ dan bibtex untuk BibTeX │
│ │ │ bibliografi. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│outformat │ (tiada) │ Gaya bibliografi │
│ │ │ untuk digunakan untuk │
│ │ │ keluaran. Ini adalah nama │
│ │ │ gaya seperti sedia ada │
│ │ │ sebelum ini ditambahkan pada │
│ │ │ pangkalan data. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│stylespecdir │ . │ Laluan ke direktori │
│ │ │ (termasuk bahagian belakang │
│ │ │ pemisah direktori) │
│ │ │ yang akan menerima │
│ │ │ fail pemacu lembaran gaya. │
│ │ │ Tetapan lalai akan │
│ │ │ arahkan fail pemacu │
│ │ │ kepada kerja semasa │
│ │ │ direktori yang paling │
│ │ │ berkemungkinan mengandungi │
│ │ │ fail input. Ia sepatutnya │
│ │ │ jarang diperlukan untuk │
│ │ │ gunakan tetapan yang berbeza. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│nombor permulaan │ 1 │ Nombor di mana │
│ │ │ penomboran rujukan │
│ │ │ bermula pada. Pilihan ini │
│ │ │ kebanyakannya berguna untuk │
│ │ │ menyusun lanjutan │
│ │ │ bibliografi atau untuk C │
│ │ │ tulang kepala yang berkeras │
│ │ │ pengiraan itu bermula pada │
│ │ │ sifar. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│toencoding │ (pengekodan pangkalan data) │ Pengekodan aksara │
│ │ │ untuk bibliografi │
│ │ │ keluaran. Jika ini bukan │
│ │ │ ditentukan, data akan │
│ │ │ gunakan pengekodan yang sama seperti │
│ │ │ pangkalan data. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│abaikan_tiada │ f │ Jika ini ditetapkan kepada "f", │
│ │ │ rujukan tiada (iaitu │
│ │ │ dipetik tetapi tidak dalam │
│ │ │ pangkalan data) akan membuang │
│ │ │ ralat. Jika ditetapkan kepada "t", │
│ │ │ anda akan mendapat amaran tetapi │
│ │ │ rujukan yang tiada akan │
│ │ │ tidak menyebabkan refdbib │
│ │ │ kembalikan ralat. │
├───────────────┼─────────────────────────┼─────── ───────────────────┤
│no_encrypt │ f │ Jika ditetapkan kepada 't', kata laluan │
│ │ │ dihantar │
│ │ │ tidak disulitkan. Lalai │
│ │ │ adalah untuk menyulitkan kata laluan. │
└───────────────┴─────────────────────────┴─────── ───────────────────┘

CONTOH

Contoh pertama menunjukkan cara membuat fail bibliografi DocBook SGML.

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

Perintah ini akan menggunakan pangkalan data "myrefs" untuk mendapatkan semula rujukan yang ditakrifkan dalam
mypaper.id.xml. Ia akan diformat mengikut gaya bibliografi yang dipanggil
“Br.J.Pharmacol.” dan akan dihalakan semula ke dalam fail bibliografi mypaper.bib.sgml. The
Fail pemacu DSSSL (ia akan dinamakan secara automatik mengikut gaya bibliografi, iaitu
Br.J.Pharmacol.dsl) akan disimpan dalam direktori kerja semasa.

Contoh kedua menunjukkan cara mencipta bibliografi BibTeX daripada dokumen LaTeX anda
(diandaikan bahawa anda berlari getah sekurang-kurangnya sekali sebelum arahan ini.

$~
refdbib -d myrefs -S "nama" -t bibtex mypaper.aux > mypaper.bib

Perintah ini akan menggunakan pangkalan data "myrefs" untuk mendapatkan semula rujukan yang ditakrifkan dalam
mypaper.aux. Pangkalan data bibliografi perantaraan akan disimpan dalam mypaper.bib dan akan
berfungsi sebagai fail input untuk bibtex.

Nota
Demi konsisten dengan bibtex, adalah mungkin untuk menentukan fail tambahan
tanpa sambungan .aux (mypaper dalam contoh di atas).

Jika anda sedang mengerjakan dokumen panjang yang memetik rujukan yang sama berulang kali,
mungkin bijak untuk memproses fail .aux terlebih dahulu untuk menghapuskan pendua (pendua
jangan keliru bibtex tetapi mereka membazir ruang):

$~
jenis mypaper.aux | unik | refdbib -d myrefs -S "nama" -t bibtex > mypaper.bib

Nota
Skrip runbib melakukan prapemprosesan jenis ini secara automatik.

Gunakan refdbib dalam talian menggunakan perkhidmatan onworks.net