bibclean - Online nel cloud

PROGRAMMA:

NOME

bibclean - prettyprint e controllo della sintassi BibTeX e file di database bibliografici Scribe

SINOSSI

bibclean [ -autore ] [ -registro errori Nome del file ] [ -Aiuto ] [ -? ] [ -file-init Nome del file ]
[ -campo lungo nomecampo ] [ -larghezza massima nnn ] [ -[no-]allinea-uguale ]
[ -[no-]valori-di-controllo ] [ -[no-]elimina-valori-vuoti ] [ -[no-]posizione-file ]
[ -[no-]correggi le modifiche ai caratteri ] [ -[no-]fix-iniziali ] [ -[no-]fissi-nomi ]
[ -[no-]alla tedesca ] [ -[no-]mantieni interruzioni di riga ] [ -[no-]keep-parbreak ]
[ -[no-]mantieni-preambolo-spazi ] [ -[no-]mantieni-spazi ] [ -[no-]mantieni-stringa-spazi ]
[ -[no-]parbreak ] [ -[no-]bella stampa ] [ -[no-]motivi-di-stampa ]
[ -[no-]leggi-init-file ] [ -[no-]rimuovi-OPT-prefissi ] [ -[no-]scriba ]
[ -[no-]apertura-file-traccia ] [ -[no-]avvertimenti ] [ -versione ]
( <infilare | filebib1 filebib2 filebib3 ... ) >file di uscita

Tutte le opzioni possono essere abbreviate con un prefisso iniziale univoco.

Un nome file esplicito di ``-'' rappresenta l'input standard; si presume se non ci sono file di input
sono specificati.

DESCRIZIONE

bibclean prettyprints inserisce i file BibTeX in stdout, e controlla il bilanciamento del tutore e
anche la sintassi della voce bibliografica. Può essere utilizzato per rilevare problemi nei file BibTeX che
a volte confondono anche lo stesso BibTeX e, cosa importante, può essere usato per normalizzare il
aspetto delle raccolte di file BibTeX.

Ecco un riepilogo delle azioni di formattazione:

· Gli elementi BibTeX sono formattati in una struttura coerente con uno campo = "valore" coppia
per riga e la @ iniziale e la parentesi graffa finale destra nella colonna 1.

· Le schede vengono espanse in stringhe vuote; il loro uso è sconsigliato perché inibiscono
portabilità e può subire danneggiamenti nella posta elettronica.

· I valori delle stringhe lunghe vengono divisi in uno spazio vuoto e continuano sulla riga successiva con l'iniziale
rientro.

· Una singola riga vuota separa le voci bibliografiche adiacenti.

· Il testo al di fuori delle voci BibTeX viene passato alla lettera.

· Le parentesi esterne intorno alle voci vengono convertite in parentesi graffe.

· Nomi personali in autore ed editore i valori dei campi sono normalizzati nella forma ``PDQ
Bach'', da ``PDQ Bach'' e ``Bach, PDQ''.

· Le sequenze di trattini nei numeri di pagina vengono convertite in trattini.

· I valori dei mesi vengono convertiti in abbreviazioni di stringhe BibTeX standard.

· Nei titoli, le sequenze di caratteri maiuscoli al livello zero di parentesi graffe sono protette da parentesi graffe
non vengano convertiti in lettere minuscole da alcuni stili di bibliografia.

· CODICE, ISBN (International Standard Book Number) e ISSN (International Standard
Serial Number) vengono esaminati i valori di ingresso per verificare i checksum di ciascun numero elencato,
e viene fornita automaticamente la sillabazione ISBN corretta.

Il formato standardizzato dell'output di bibclean facilita la successiva applicazione di
semplici filtri, come pettorale(1) biduup(1) bibite(1) bibindex(1) bibjoin(1)
bibbia(1) bavaglino(1) bifronte(1) biberon(1) citatrova(1), e citazioni(1), elaborare
il testo, ed è anche quello previsto dalle funzioni di supporto di GNU Emacs BibTeX.

VERSIONI

Le opzioni della riga di comando possono essere abbreviate con un prefisso iniziale univoco e le lettere maiuscole sono
non significativo. Tutte le opzioni vengono analizzate prima che vengano letti i file bibliografici di input, no
importa quale sia il loro ordine sulla riga di comando. Opzioni che corrispondono a un'impostazione sì/no
di una bandiera hanno una forma con un prefisso "no-" per impostare la bandiera su no. Per tali opzioni, il
l'ultima impostazione determina il valore del flag utilizzato. Questo è significativo quando le opzioni sono anche
specificato nei file di inizializzazione (vedi il INIZIALIZZAZIONE FILE sezione manuale).

Il trattino iniziale che distingue un'opzione da un nome di file può essere raddoppiato, per
compatibilità con le convenzioni GNU e POSIX. Così, -autore ed --autore sono equivalenti.

Per evitare confusione con le opzioni, se un nome di file inizia con un trattino, deve essere camuffato
da un percorso di directory assoluto o relativo iniziale, ad es. /tmp/-pippo.bib or ./-pippo.bavaglino.

-autore Visualizza un credito dell'autore sull'unità di errore standard, stderr, quindi esci con
un codice di ritorno di successo. A volte un programma eseguibile è separato dal suo
documentazione e codice sorgente; questa opzione fornisce un modo per recuperare da questo.

-registro errori Nome del file
Reindirizzare stderr al file indicato, che conterrà quindi tutto l'errore
e messaggi di avviso. Questa opzione è prevista per quei sistemi che hanno
difficoltà di reindirizzamento stderr.

-Aiuto or -?
Visualizza un messaggio di aiuto su stderr, fornendo una descrizione dell'uso, simile a questa
sezione delle pagine di manuale, quindi esci con un codice di ritorno di successo.

-file-init Nome del file
Fornire un file di inizializzazione del modello di valore esplicito. Verrà elaborato
dopo qualsiasi file di inizializzazione a livello di sistema e di lavoro e potrebbe sovrascriverli.
A sua volta può essere sovrascritto da un successivo file di inizializzazione specifico del file.
Per ulteriori dettagli, consultare il INIZIALIZZAZIONE FILE sezione manuale.

-campo lungo nomecampo
Elimina gli avvisi per quel campo denominato nomecampo avere lunghezze superiori allo standard
Limiti di BibTeX. NB! La sezione is a Specifico per Debian estensione!

-larghezza massima nnn
bibclean normalmente limita la larghezza della riga di output a 72 caratteri e nel
interessi di coerenza, tale valore non dovrebbe essere modificato. Occasionalmente,
applicazioni speciali possono richiedere larghezze di linea massime diverse, quindi questo
opzione fornisce tale capacità. Il numero che segue il nome dell'opzione può essere
specificato in decimale, ottale (che inizia con 0) o esadecimale (che inizia con
0x). Un valore zero o negativo viene interpretato come illimitato, quindi -larghezza massima 0
può essere utilizzato per garantire che ogni coppia campo/valore appaia su una singola riga.

Quando -no-preziosa impronta richieste bibclean per fungere da analizzatore lessicale, l'impostazione predefinita
la larghezza della linea è illimitata, a meno che non venga sovrascritta da questa opzione.

Quando bibclean è abbastanza stampabile, il ritorno a capo verrà eseguito solo in uno spazio.
Di conseguenza, una lunga sequenza di caratteri non vuota può risultare nell'output
superando la larghezza della linea richiesta.

Quando bibclean è lexing, il ritorno a capo avviene inserendo una barra rovesciata-newline
coppia quando viene raggiunto il massimo specificato, quindi nessuna lunghezza della linea potrà mai superare
il massimo.

-[no-]allinea-uguale
Con la forma positiva, allinea il segno di uguale nelle assegnazioni chiave/valore in corrispondenza di
stessa colonna, separata da un singolo spazio dalla stringa del valore. In caso contrario, il
Il segno di uguale segue la chiave, separato da un singolo spazio. Predefinito: no.

-[no-]valori-di-controllo
Con la forma positiva, applica la corrispondenza del modello euristico ai valori dei campi in
per rilevare possibili errori (ad es. ``anno = "192"'' invece di ``anno =
"1992"'') e invia avvisi quando vengono trovati modelli imprevisti.

Questo controllo è generalmente vantaggioso, ma se produce troppi avvisi fasulli
per un particolare file bibliografico, puoi disabilitarlo con la forma negativa di
questa opzione. Predefinito: sì.

-[no-]elimina-valori-vuoti
Con la forma positiva, rimuovi tutte le coppie campo/valore per le quali il valore è an
stringa vuota. Questo è utile per ripulire le bibliografie generate dal testo
modelli dell'editor. Confronta questa opzione con -[no-]rimuovi-OPT-prefissi descritta
sotto. Predefinito: no.

-[no-]posizione-file
Con la forma positiva, fornire informazioni dettagliate sulla posizione del file in avviso e
messaggio di errore. Predefinito: no.

-[no-]correggi le modifiche ai caratteri
Con la forma positiva, fornisci un ulteriore livello di parentesi graffa intorno alle modifiche dei caratteri in
titoli per proteggersi dal downcase di alcuni stili BibTeX. Il carattere cambia quello
hanno già più di un livello di parentesi graffe non vengono modificati.

Ad esempio, se un titolo contiene la frase latina {\em Dictyostelio Discoideo}
or {\em {D}ictiostelio {D}iscoideo}, quindi il downcase verrà convertito in modo errato
la frase in lettere minuscole. La maggior parte degli utenti di BibTeX è sorpresa che il rinforzo
le lettere iniziali non impediscono l'azione downcase. La codifica corretta è
{{\em Dictyostelio Discoideo}}. Tuttavia, ci sono anche casi legittimi
dove un ulteriore livello di rinforzo protegge erroneamente dal downcasing. Di conseguenza,
bibclean normalmente non fornire un ulteriore livello di bretelle, ma se si dispone di un
bibliografia in cui le parentesi in più mancano abitualmente, puoi usare questa
possibilità di fornirli.

Se pensi di aver bisogno di questa opzione, lo è fortemente consigliato che tu
applicare bibclean al tuo file bibliografia con e senza -correggi i cambiamenti dei caratteri,
quindi confronta i due file di output per assicurarti che non vengano visualizzate parentesi graffe aggiuntive
forniti nei titoli dove non dovrebbero essere presenti. Dovrai decidere
quale dei due file di output è la scelta migliore, quindi riparare l'errato
rinforzo del titolo a mano.

Poiché le modifiche ai caratteri nei titoli non sono comuni, ad eccezione dei casi del tipo che
questa opzione è progettata per correggere, dovrebbe fare più bene che male. Predefinito:
no.

-[no-]fix-iniziali
Con la forma positiva, inserisci uno spazio dopo un punto dopo le iniziali dell'autore.
Predefinito: sì.

-[no-]fissi-nomi
Con la forma positiva, riordina autore ed editore elenchi di nomi per rimuovere le virgole su
graffa livello zero, mettendo i nomi o le iniziali prima dei cognomi. Predefinito:
sì.

-[no-]alla tedesca
Con la forma positiva, interpreta le virgolette ["] all'interno rinforzato APPREZZIAMO
stringhe a livello di parentesi graffa 1 secondo le convenzioni del file di stile TeX
tedesco.sty, che sovraccarica la citazione per semplificare l'input e la rappresentazione del tedesco
accenti dieresi, s diesis (es-zet), separatori di legature, trattini invisibili,
virgolette alzate/diminuite, guillemet francesi e trattini discrezionali. Riconosciuto
le combinazioni di caratteri saranno racchiuse tra parentesi graffe per impedire a BibTeX di interpretare il
quote come delimitatore di stringa.

Le stringhe tra virgolette non ricevono una gestione speciale da questa opzione, e dal momento che il tedesco
i nomi nei titoli devono comunque essere protetti dall'operazione di downcase della maggior parte
Stili di bibliografia BibTeX, stringhe di valore tedesche che utilizzano la virgoletta sovraccarica
il carattere può essere sempre inserito nella forma "{...}", senza bisogno di specificarlo
questa opzione a tutti.

Predefinito: no.

-[no-]mantieni interruzioni di riga
Normalmente, le interruzioni di riga all'interno delle stringhe di valori vengono compresse in un singolo spazio, quindi
che le stringhe di valori lunghe possono essere successivamente interrotte per fornire linee di ragionevole
lunghezza.

Con la forma positiva, le interruzioni di riga vengono conservate nelle stringhe di valori. Se -massimo-
larghezza è impostato su zero, questo conserva le interruzioni di riga originali. Spaziatura al di fuori
le stringhe di valore rimangono sotto bibclean's controllo, e non è influenzato da questo
opzione.

Predefinito: no.

-[no-]keep-parbreak
Con la forma positiva, mantieni le interruzioni di paragrafo (o formfeed o righe
contenente solo spazi) nelle stringhe di valori. Normalmente, le interruzioni di paragrafo sono
crollato in un unico spazio. Spaziatura al di fuori le stringhe di valore rimangono sotto
bibcleancontrollo e non è influenzato da questa opzione. Predefinito: no.

-[no-]mantieni-preambolo-spazi
Con la forma positiva, conserva tutti gli spazi bianchi nelle voci @Preambolo{...}.
Predefinito: no.

-[no-]mantieni-spazi
Con la forma positiva, conserva tutti gli spazi nelle stringhe di valori. Normalmente,
più spazi vengono compressi in un unico spazio. Questa opzione può essere utilizzata
insieme -mantieni interruzioni di riga, -mantieni i parbreake -larghezza massima 0 conservare
la forma di stringhe di valore pur continuando a fornire la sintassi e il controllo del valore.
Spaziatura al di fuori le stringhe di valore rimangono sotto bibcleanè il controllo, e non lo è
interessati da questa opzione. Predefinito: no.

-[no-]mantieni-stringa-spazi
Con la forma positiva, conserva tutti gli spazi bianchi nelle voci @String{...}.
Predefinito: no.

-[no-]parbreak
Con la forma negativa, un'interruzione di paragrafo (un feed di modulo o una riga
contenente solo spazi) non è consentito nelle stringhe di valori o tra
coppie campo/valore. Questo può essere utile per intrappolare rapidamente le stringhe fuori controllo che sorgono
da delimitatori non corrispondenti. Predefinito: sì.

-[no-]bella stampa
Normalmente, bibclean funziona come una bella stampante. Tuttavia, con il negativo
sotto forma di questa opzione, agisce invece come un analizzatore lessicale, producendo un flusso
di token lessicali. Vedi il LESSICALE ANALISI sezione manuale per ulteriori dettagli.
Predefinito: sì.

-[no-]motivi-di-stampa
Con la forma positiva, stampa i modelli di valore letti dai file di inizializzazione
man mano che vengono aggiunti alle tabelle interne. Usa questa opzione per controllare i nuovi aggiunti
modelli o per vedere quali modelli vengono utilizzati.

Questi modelli sono quelli che verranno utilizzati nel controllo delle stringhe di valori per
sintassi valida e tutti sono specificati nei file di inizializzazione, piuttosto che
hardcoded nel programma. Per ulteriori dettagli, vedere il INIZIALIZZAZIONE FILE
sezione manuale. Predefinito: no.

-[no-]leggi-init-file
Con la forma negativa, sopprimere il caricamento di file specifici per sistema, utente e file
file di inizializzazione. Le inizializzazioni arriveranno esclusivamente da quei file
esplicitamente dato da -file-init Nome del file opzioni. Predefinito: sì.

-[no-]rimuovi-OPT-prefissi
Con la forma positiva, rimuovi il prefisso ``OPT'' da ogni nome di campo in cui il
il valore corrispondente è non una stringa vuota. Il prefisso ``OPT'' deve essere interamente
in maiuscolo per essere riconosciuto.

Questa opzione è per le bibliografie generate con l'aiuto di GNU Emacs
Supporto per la modifica di BibTeX, che genera modelli con campi opzionali
identificato dal prefisso ``OPT''. Sebbene la funzione Mx bibtex-rimuovi-OPT
normalmente legato alle sequenze di tasti Cc Co fa il lavoro, gli utenti spesso dimenticano, con
il risultato che BibTeX non riconosce il nome del campo e ne ignora il valore
corda. Confronta questa opzione con -[no-]elimina-valori-vuoti descritto sopra.
Predefinito: no.

-[no-]scriba
Con la forma positiva, accetta la sintassi di input conforme al documento Scribe
sistema. L'output sarà convertito per conformarsi alla sintassi BibTeX. Vedi il
SCRIBE BIBLIOGRAFIA FORMATO sezione manuale per ulteriori dettagli. Predefinito: no.

-[no-]apertura-file-traccia
Con la forma positiva, registrare nel file di log degli errori i nomi di tutti i file
quale bibclean tentativi di apertura. Usa questa opzione per identificare dove
si trovano i file di inizializzazione. Predefinito: no.

-[no-]avvertimenti
Con la forma positiva, consenti tutti i messaggi di avviso. La forma negativa è non
consigliato poiché potrebbe mascherare problemi che dovrebbero essere riparati. Predefinito: sì.

-versione Visualizza il numero di versione del programma su stderr, quindi esci con successo
codice di ritorno. Ciò includerà anche l'indicazione di chi ha compilato il programma,
il nome host su cui è stato compilato, l'ora di compilazione e il tipo di
codice di corrispondenza valore stringa selezionato, quando tale informazione è disponibile per il
compilatore.

ERRORE RECOVERY E AVVERTENZE

Quando bibclean rileva un errore, invia un messaggio di errore a entrambi stderr ed stdout.
In questo modo, l'utente viene chiaramente informato e la bibliografia di output contiene anche il
messaggio nel punto di errore.

I messaggi di errore iniziano con una coppia distintiva di query, ??, a partire dalla colonna 1,
seguito dal nome del file di input e dal numero di riga. Se la -posizione-file l'opzione era
specificati, contengono anche le posizioni di input e output del file corrente, voce,
e valore. Ogni posizione include il numero di byte del file, il numero di riga e la colonna
numero. In caso di un argomento stringa in fuga, le posizioni di ingresso e valore dovrebbero
individuare con precisione la voce bibliografica errata e le posizioni dei file indicheranno
dove è stato rilevato, che potrebbe trovarsi più avanti nei file.

I messaggi di avviso identificano possibili problemi e vengono quindi inviati solo a stderre
non stdout, quindi non compaiono mai nel file di output. Sono identificati da a
coppia distintiva di percentuali, %%, a partire dalla colonna 1 e, come per i messaggi di errore, può
essere seguito da messaggi di posizione del file se il -posizione-file è stata specificata l'opzione.

Per comodità, la prima riga di ogni messaggio di errore e avviso inviato a stderr is
formattato secondo le aspettative di GNU Emacs errore successivo comando. Puoi
invocare bibclean con l'Emacs Mx compilare bibclean nomefile.bib >nomefile.nuovo
comando, quindi utilizzare il errore successivo comando, normalmente legato a Cx ` (questa è una tomba, o
back, accent), per passare alla posizione dell'errore nel file di input.

Se i messaggi di errore vengono ignorati e lasciati nel file della bibliografia di output, lo faranno
causare un errore alla successiva elaborazione della bibliografia con BibTeX.

Dopo aver inviato un messaggio di errore, bibclean quindi risincronizza il suo input copiandolo
parola per parola stdout fino a quando non viene riconosciuta una nuova voce bibliografica su una riga in cui il
il primo carattere non vuoto è un segno di chiocciola (@). Ciò garantisce che nulla venga perso dal
file di input, consentendo di apportare correzioni nei file di input o di output.
Tuttavia, se bibclean rileva un errore interno nelle sue strutture dati, terminerà
bruscamente senza ulteriori elaborazioni di input o output; questo tipo di errore non dovrebbe mai
accada, e se succede, dovrebbe essere segnalato immediatamente all'autore del programma.
Anche gli errori nei file di inizializzazione e l'esaurimento della memoria dinamica verranno immediatamente
finito bibclean.

INIZIALIZZAZIONE FILE

bibclean può essere compilato con uno dei tre diversi tipi di pattern matching; la scelta
viene eseguita dall'installatore in fase di compilazione:

· La versione originale utilizza test espliciti codificati a mano della sintassi delle stringhe di valore.

· La seconda versione utilizza la libreria host di corrispondenza dei modelli di espressioni regolari
routine insieme a modelli di espressioni regolari che provengono interamente da
file di inizializzazione.

· La terza versione utilizza modelli speciali che provengono interamente dall'inizializzazione
File.

Questa versione debianizzata di bibclean usa la terza versione Tuttavia, le opzioni della riga di comando
può anche essere specificato nei file di inizializzazione, indipendentemente dalla scelta di corrispondenza del modello
selezionato.

Quando bibclean si avvia, cerca i file di inizializzazione, utilizzando il primo di
$(HOME)/.bibcleanrc, /usr/condividi/bibcleanrce /etc/bibcleanrc che esiste. Dopo,
si legge il primo .bibcleanrc trovato nel INGRESSI BIBITA percorso di ricerca. Il nome .bibcleanrc
può essere modificato in fase di esecuzione tramite un'impostazione della variabile d'ambiente BIBCLEAINI. Se
il nome inizia con un punto, verrà rimosso quando si guarda dentro / usr / share ed / Etc.

Quindi, quando vengono elaborati gli argomenti della riga di comando, tutti i file aggiuntivi specificati da -dentro-
filettoNome del file anche le opzioni vengono elaborate. Infine, subito prima di ogni detto
bibliografia viene elaborato, viene effettuato un tentativo di elaborare un file di inizializzazione con
lo stesso nome, ma con l'estensione modificata in . Iniziale. L'estensione predefinita può essere
modificato da un'impostazione della variabile d'ambiente BIBCLEANAVANTI. Questo schema consente al sistema
supportare i file di inizializzazione wide, user-wide, session-wide e file-specific.

Quando l'input è preso da stdin, non esiste un'inizializzazione specifica del file.

Per un controllo preciso, il -no-read-init-files l'opzione sopprime tutti i file di inizializzazione
ad eccezione di quelli esplicitamente nominati da -file-initNome del file opzioni, sia sulla riga di comando,
o nei file di inizializzazione richiesti.

Esecuzione ricorsiva di file di inizializzazione con annidato -file-init le opzioni sono consentite;
se la ricorsione è circolare, bibclean otterrà finalmente un file di inizializzazione non fatale
errore di apertura dopo aver aperto troppi file. Questo termina l'ulteriore file di inizializzazione
in lavorazione. Quando la ricorsione si svolge, i file vengono tutti chiusi, quindi l'esecuzione procede
normalmente.

Un file di inizializzazione può contenere righe vuote, commenti dalla percentuale alla fine della riga (solo
come TeX), opzioni e assegnazioni campo/schema o campo/schema/messaggio.
Gli spazi iniziali e finali vengono ignorati. Questo è meglio illustrato da un breve esempio:

% Questo è un piccolo file di inizializzazione bibclean

-init-file /u/math/bib/.bibcleanrc %% pattern dipartimentali

capitolo = "\"D\"" %% 23

pagine = "\"D--D\"" %% 23--27

volume = "\"D \\an\\d D\"" %% 11 e 12

anno = \
"\"dddd, dddd, dddd\"" \
"Più anni specificati." %% 1989, 1990, 1991

-no-fix-names %% non modifica gli elenchi di autori/editor

Le righe logiche lunghe possono essere suddivise in più righe fisiche interrompendole con una barra rovesciata-
coppia di nuova riga; la coppia backslash-newline viene scartata. Questa elaborazione avviene mentre
vengono letti i caratteri, prima di qualsiasi ulteriore interpretazione del flusso di input.

Ogni riga logica deve contenere un'opzione completa (e il suo valore, se presente) o un'opzione completa
coppia campo/schema o una tripla campo/schema/messaggio.

I commenti vengono eliminati durante l'analisi del campo, del modello e dei valori del messaggio. Il
il simbolo di inizio del commento non è riconosciuto all'interno delle stringhe tra virgolette, quindi può essere utilizzato liberamente in
tali stringhe.

Commenti su linee logiche che sono state immesse come linee fisiche multiple tramite la barra rovesciata-
la convenzione di nuova riga deve apparire sul ultimo linea fisica; in caso contrario, il restante
le linee fisiche diventeranno parte del commento.

Le stringhe di pattern devono essere racchiuse tra virgolette; all'interno di tali stringhe, una barra rovesciata
avvia un meccanismo di escape comunemente utilizzato nel software UNIX. La fuga riconosciuta
sequenze sono:

\a campanello d'allarme (ottale 007)

\b backspace (ottale 010)

\f formfeed (ottale 014)

\n nuova riga (ottale 012)

\r ritorno a capo (ottale 015)

\t linguetta orizzontale (ottale 011)

\v linguetta verticale (ottale 013)

\oooh numero di carattere ottale ooo (per esempio \dieci è l'avanzamento di riga). Può contenere fino a 3 cifre ottali
essere usato.

\0xh numero carattere esadecimale hh (per esempio, \0x0a è l'avanzamento di riga). xh potrebbe essere in
entrambe le lettere maiuscole. È possibile utilizzare qualsiasi numero di cifre esadecimali.

La barra rovesciata seguita da qualsiasi altro carattere produce solo quel carattere. Quindi, \% ottiene a
percentuale letterale in una stringa (impedendo la sua interpretazione come commento), \" produce a
virgolette e \\ produce una singola barra rovesciata.

Un ASCII NUL (\0) in una stringa lo terminerà; questa è una caratteristica della programmazione C
lingua in cui bibclean è implementato.

Le coppie campo/schema possono essere separate da uno spazio arbitrario e, facoltativamente, un uguale
segno o due punti che funge da operatore di assegnazione. Pertanto, sono equivalenti:

pagine="\"D--D\""
pagine:"\"D--D\""
pagine "\"D--D\""
pagine = "\"D--D\""
pagine : "\"D--D\""
pagine "\"D--D\""

Ad ogni nome di campo può essere associato un numero arbitrario di pattern; tuttavia, loro
devono essere specificati in assegnazioni di campi/schemi separati.

Una stringa di pattern vuota fa sì che i pattern caricati in precedenza per quel nome di campo siano
dimenticato. Questa funzione consente a un file di inizializzazione di eliminare completamente i modelli
da file di inizializzazione precedenti.

I modelli per le stringhe di valori sono rappresentati in un minuscolo linguaggio per scopi speciali che è sia
conveniente e adatto per il controllo della sintassi delle stringhe di valori bibliografici. Anche se non come
potente come il linguaggio dei modelli di espressioni regolari, la sua analisi può essere portabile
implementato in meno del 3% del codice in un parser di espressioni regolari ampiamente utilizzato (il
GNU regexp pacchetto).

I modelli sono rappresentati dai seguenti caratteri speciali:

uno o più spazi

a esattamente una lettera

A una o più lettere

d esattamente una cifra

D una o più cifre

r esattamente un numero romano

R uno o più numeri romani (cioè un numero romano)

w esattamente una parola (una o più lettere e cifre)

W una o più parole separate da spazi, che iniziano e terminano con una parola

. un carattere "speciale", uno dei caratteri !#()*+,-./:;?[]~, a
sottoinsieme di caratteri di punteggiatura che vengono generalmente utilizzati nei valori delle stringhe

: uno o più caratteri "speciali"

X una o più parole separate da `speciali', che iniziano e terminano con una parola

\x esattamente una x (x è un carattere qualsiasi), possibilmente con una sequenza di escape
interpretazione data in precedenza

x esattamente il carattere x (x è tutt'altro che uno di questi pattern
caratteri: aAdDrRwW.: \)

I X il carattere del modello è molto potente, ma generalmente sconsigliabile, poiché corrisponderà
quasi tutto ciò che può essere trovato in una stringa di valori BibTeX. Il motivo per fornire
il pattern matching sulle stringhe di valore serve a scoprire possibili errori, non a mascherarli.

Non è prevista la specificazione di intervalli o ripetizioni di caratteri, ma ciò può
di solito essere fatto con modelli separati. È una buona idea accompagnare il modello con un
commento che mostra il tipo di cosa che dovrebbe corrispondere. Ecco una porzione di an
file di inizializzazione che fornisce alcuni dei modelli utilizzati per la corrispondenza numero stringhe di valore:

numero = "\"D\"" %% 23
numero = "\"A AD\"" %% PN LPS5001
numero = "\"AD(D)\"" %% RJ 34(49)
numero = "\"AD\"" %% XNSS 288811
numero = "\"AD\\.D\"" %% Versione 3.20
numero = "\"AADD\"" %% UMIAC-TR-89-11
numero = "\"AAD\"" %% CS-TR-2189
numero = "\"AAD\\.D\"" %% CS-TR-21.7

Per una bibliografia che contiene solo articolo voci, questo elenco dovrebbe probabilmente essere
ridotto solo al primo modello, in modo che qualsiasi cosa diversa da una stringa di cifre fallisca il
test di corrispondenza del modello. Questo è fatto facilmente mantenendo modelli specifici della bibliografia in a
file corrispondente con estensione . Iniziale, poiché quel file viene letto automaticamente.

Dovresti essere sicuro di usare stringhe di pattern vuote in questo file di pattern per scartare i pattern
da file di inizializzazione precedenti.

Le stringhe di valore passate al pattern matcher contengono virgolette circostanti, quindi
anche i modelli dovrebbero. Tuttavia, potresti usare una specifica del modello come "\"D" per abbinare
una stringa di cifre iniziale seguita da qualsiasi altra cosa; l'omissione della citazione finale
il segno \" nello schema consente alla corrispondenza di avere successo senza controllare che il prossimo
carattere nella stringa del valore è una virgoletta.

Poiché le stringhe di valore sono destinate ad essere elaborate da TeX, il pattern matching
ignora le parentesi graffe e le sequenze di controllo di TeX, insieme a qualsiasi spazio che segue quei controlli
sequenze. Gli spazi intorno alle parentesi graffe sono conservati. Questa convenzione consente il modello
frammento A-AD-RE per abbinare la stringa del valore TN-K\barra 27-70, perché il valore è
implicitamente collassato a TN-K27-70 durante l'operazione di abbinamento.

bibcleanl'azione normale quando un valore di stringa non riesce a corrispondere a nessuno dei corrispondenti
modelli è quello di emettere a identificazione dei warning messaggio qualcosa del genere: "Inaspettato APPREZZIAMO in ``anno =
"192"''. Nella maggior parte dei casi, ciò è sufficiente per avvisare l'utente di un problema. In qualche
casi, tuttavia, può essere desiderabile associare un messaggio diverso a un particolare
modello. Questo può essere fatto fornendo una stringa di messaggio che segue la stringa del modello.
Formatta elementi %% (singolo per cento), %e (nome della voce), %f (nome del campo), %k (chiave di citazione), e
%v (valore stringa) sono disponibili per ottenere i valori correnti espansi nei messaggi. Qui è
un esempio:

capitolo = "\"D:D\"" "Colon trovato in ``%f = %v''" %% 23:2

Per essere coerenti con altri messaggi emessi da bibclean, la stringa del messaggio dovrebbe non fine
con punteggiatura.

Se desideri rendere il messaggio un errore, piuttosto che un semplice avviso, inizia con a
query (?), in questo modo:

capitolo = "\"D:D\"" "?Colon trovato in ``%f = %v''" %% 23:2

La query non verrà inclusa nel messaggio di output.

Le sequenze di escape sono supportate nelle stringhe di messaggio, proprio come nelle stringhe di pattern.
Puoi usarlo a vantaggio per cose fantasiose, come il controllo della modalità di visualizzazione del terminale. Se
riscrivi l'esempio precedente come

capitolo = "\"D:D\"" \
"?\033[7mColon trovato in ``%f = %v''\033[0m" %% 23:2

il messaggio di errore apparirà in video inverso sugli schermi che supportano ANSI
sequenze di controllo del terminale. Tale pratica non è normalmente raccomandata, poiché potrebbe avere
effetti indesiderati su alcuni dispositivi di output. Tuttavia, potresti trovarlo utile per
applicazioni limitate.

Per alcuni tipi di campi bibliografici, bibclean contiene un codice speciale per
integrare o sostituire il pattern matching:

· CODICE, ISBN ed ISSN i valori dei campi sono gestiti in questo modo perché la loro convalida
richiede la valutazione di checksum che non possono essere espressi da schemi semplici; no
i modelli sono usati persino in questi tre casi.

· capitolo, numero, paginee volume i valori vengono verificati solo tramite la corrispondenza del modello.

· mese i valori vengono prima confrontati con le abbreviazioni standard del mese BibTeX,
e solo se non viene trovata alcuna corrispondenza vengono utilizzati i modelli.

· anno i valori vengono prima verificati rispetto ai modelli, quindi se non viene trovata alcuna corrispondenza, il
i numeri dell'anno vengono trovati e convertiti in valori interi per il test contro
limiti ragionevoli.

I valori per gli altri campi vengono verificati solo rispetto ai modelli. Puoi fornire modelli per
in qualsiasi campo che ti piace, anche quelli bibclean non sa già. I nuovi sono semplicemente
aggiunto a una tabella interna che viene cercata per ogni stringa da convalidare.

Il campo speciale, chiave, rappresenta la chiave di citazione bibliografica. Può essere dato
modelli, come qualsiasi altro campo. Ecco un'assegnazione del modello del file di inizializzazione che
corrisponderà a un nome dell'autore, due punti, una stringa alfabetica e un anno a due cifre:

chiave = "A:Aggiungi" %% Knuth:TB86

Notare che non sono incluse virgolette nel modello, perché le chiavi di citazione sono
non quotato. È possibile utilizzare tali modelli per aiutare a far rispettare convenzioni di denominazione uniformi per
chiavi di citazione, che è sempre più importante man mano che la tua banca dati bibliografica cresce.

LESSICALE ANALISI

Quando -no-preziosa impronta è specificato, bibclean agisce come un analizzatore lessicale invece di a
prettyprinter, producendo output in righe del modulo

" "

Ogni riga di output contiene un singolo token completo, identificato da un piccolo numero intero
per l'utilizzo da parte di un programma per computer, un nome di tipo token per lettori umani e un valore di stringa in
citazioni.

I caratteri speciali nella stringa del valore del token sono rappresentati con lo standard ANSI/ISO C
sequenze di escape, quindi tutti i caratteri diversi da NUL sono rappresentabili e multilinea
i valori possono essere rappresentati in una singola riga.

Ecco i numeri di token e i nomi dei tipi di token che possono apparire nell'output quando
- caratteri graziosi è specificato:

0 SCONOSCIUTO
1 ABBREV
2 AT
3 virgole
COMMENTO 4
5 INGRESSO
6 UGUALI
7 CAMPO
8 COMPRENDERE
9 IN LINEA
10 CHIAVE
11 LBRACCIO
12 LETTERALI
13 NUOVA LINEA
14 PREAMBOLO
15 RBRACCIO
16 TAGLIENTE
17 SPACE
18 CORDE
19 VALORE

I programmi che analizzano tale output dovrebbero essere preparati anche per le righe che iniziano con
prefisso di avviso, %% o il prefisso di errore, ??, e per il numero di riga C standard ANSI/ISO
direttive della forma
# riga 273 "texbook1.bib"
che registrano il numero di riga e il nome del file del file di input corrente.

Se un -larghezza massima nnn è stata specificata l'opzione della riga di comando, le righe di output lunghe verranno avvolte
a una coppia backslash-newline e, di conseguenza, software che elabora il token lessicale
stream dovrebbe essere preparato per comprimere tali linee avvolte in singole linee.

Come esempio dell'uso di -no-preziosa impronta, la pipeline dei comandi UNIX
bibclean -no-preziosa impronta mialib.bib | \
awk '$2 == "CHIAVE" {stampa $3}' | \
sete -e 's/"//g' | \
sorta
estrarrà un elenco ordinato di tutte le chiavi di citazione nel file mialib.bib.

Una certa quantità di elaborazione sarà stata eseguita sui token. In particolare,
i delimitatori equivalenti alle parentesi graffe saranno stati sostituiti da parentesi graffe e le stringhe tra parentesi graffe
sono diventate stringhe tra virgolette.

Il tipo di token LITERAL viene utilizzato per testo arbitrario che bibclean non esamina ulteriormente,
come il contenuto di un @Preambolo{...} o di un @Commento{...}.

Il tipo di token SCONOSCIUTO non dovrebbe mai apparire nel flusso di output. Viene utilizzato internamente per
inizializzare le variabili di tipo token.

SCRIBE BIBLIOGRAFIA FORMATO

bibcleanil supporto di Scribe per il formato bibliografico di Scribe si basa sulla descrizione della sintassi
nel Manuale introduttivo per l'utente di Scribe, 3a edizione, maggio 1980. Scribe era originariamente
sviluppato da Brian Reid alla Carnegie-Mellon University, ed è ora commercializzato da Unilogic,
Ltd.

Il formato della bibliografia BibTeX è stato fortemente influenzato da Scribe, e infatti, con cura,
è possibile condividere file bibliografici tra i due sistemi. Tuttavia, ci
ci sono alcune differenze, quindi ecco un riepilogo delle caratteristiche del file bibliografico di Scribe
formato:

(1) Le lettere maiuscole non sono significative nei nomi dei campi e nei nomi delle voci, ma le maiuscole vengono conservate
nelle stringhe di valori.

(2) Nelle coppie campo/valore, il campo e il valore possono essere separati da uno di tre
caratteri: =, / o spazio. Lo spazio può facoltativamente circondare questi separatori.

(3) I delimitatori di valore sono una di queste sette coppie: { } [ ] ( ) < > ' ' " " `
`

(4) I delimitatori di valore non possono essere nidificati, anche se con le prime quattro coppie di delimitatori,
i delimitatori bilanciati annidati non sarebbero ambigui.

(5) I delimitatori possono essere omessi attorno ai valori che contengono solo lettere, cifre, diesis
(#), e commerciale (&), punto (.) e percentuale (%).

(6) Al di fuori dei valori delimitati, un segno di chiocciola letterale (@) è rappresentato da un doppio
segni (@@).

(7) Le voci della bibliografia iniziano con @name, come per BibTeX, ma uno qualsiasi dei sette Scribe
le coppie di delimitatori di valori possono essere utilizzate per racchiudere i valori nelle coppie campo/valore. Come
in (4), i delimitatori nidificati sono vietati.

(8) Gli spazi arbitrari possono separare i nomi delle voci dai seguenti delimitatori.

(9) @Comment è un comando speciale il cui valore delimitato viene scartato. Come in (4), annidato
i delimitatori sono vietati.

(10) La forma speciale

@Inizio{commento}
...
@Fine{commento}

consente di incapsulare testo arbitrario contenente caratteri o delimitatori, altro
di ``@End{commento}''. È possibile utilizzare una qualsiasi delle sette coppie di delimitatori intorno a
la parola ``comment'' dopo ``@Begin'' o ``@End''; i delimitatori nei due
i casi non devono essere gli stessi e, di conseguenza, ``@Begin{comment}''/``@End{comment}''
le coppie possono non essere annidato.

(11) L' chiave campo è obbligatorio in ogni voce bibliografica.

(12) Una citazione con barra rovesciata in una stringa sarà considerata un accento di TeX e racchiusa tra parentesi graffe
appropriatamente. Sebbene tali accenti non siano conformi alla sintassi di Scribe, Scribe-format
sono state trovate bibliografie che sembrano essere destinate all'elaborazione di TeX.

A causa di questa sintassi allentata, bibcleanla normale euristica di rilevamento degli errori è inferiore
efficace e, di conseguenza, l'input in modalità Scribe non è l'impostazione predefinita; deve essere esplicitamente
richiesto.

AMBIENTE VARIABILI

BIBCLEANAVANTI Estensione dei file di inizializzazione specifici della bibliografia. Predefinito: . Iniziale.

BIBCLEAINI Nome di bibclean file di inizializzazione. Predefinito: .bibcleanrc.

INGRESSI BIBITA Percorso di ricerca per bibclean e file di input BibTeX. Questo è un separato dai due punti
elenco delle directory ricercate in ordine dalla prima all'ultima. Non è
un errore per l'inesistenza di una directory specificata.

Usa bibclean online utilizzando i servizi onworks.net