Chapter 2. Il linguaggio di scripting

Table of Contents
Script esistenti
Scrivere i propri script

pybliographer è infatti un semplice set di classi e funzioni scritte in python, e fornisce un accesso semplice e omogeneo a database bibliografici. Perciò, è possibile scrivere script in python che fanno uso di queste funzioni specializzate. L'interfaccia grafica, pybliographic, è essa stessa un semplice script al di sopra di pybliographer.

Per eseguire uno script scritto per pybliographer, semplicemente digita

> pybliographer mioscript.py

Alternativamente puoi usare i tuoi script con

#!/percorso/a/pybliographer

...il resto del tuo script...
e rendilo eseguibile.

Script esistenti

Alcuni script sono forniti con pybliographer, sia come esempio sia come strumenti utili. Sono abbastanza corti e dovrebbero essere leggibili con una conoscenza basilare di python.

pybcheck

 Questo strumento prende una lista di file o directory, e controlla
    se sono validi (sintassi, nessuna voce con la stessa chiave,...)
    

E` possibile utilizzare il suo output direttamente nel buffer di compilazione di Emacs, al fine di saltare direttamente agli errori incontrati. Per fare ciò, digita M-x compile, poi il comando pybcheck tuofile, e usa il bottone centrale del mouse per saltare nel file difettoso.

pybcompact

Questo strumento estrae le citazioni fatte in un documento 
    LaTeX e genera un file BibTeX che li contiene.

Di solito, uno immagazzina le sue bibliografie in uno o più grandi file BibTeX, e lascia che bibtex estragga le voci usate in un documento LaTeX. Ma qualche volta è conveniente creare un pacchetto autocontenuto (per esempio per condividerlo nella forma nativa con qualcun altro, o per metterlo da parte), con un file BibTeX minimo contenente esattamente le voci usate in LaTeX. Questo strumento fa esattamente questo: legge un file LaTeX .aux ed estrae da uno specifico database BibTeX le voci corrispondenti.

pybconvert

Questo strumento effettua conversioni da un formato bibliografico
    a un altro.

La sintassi generale è abbastanza semplice. Per convertire da Refer a BibTeX per esempio, digita appena:

> pybconvert refer..bibtex toto.refer toto.bib

pybformat

Questo script genera una bibliografia conforme a uno stile
    bibliografico, e la restituisce in uno specifico formato (per esempio
    HTML, LaTeX,...) come dovrebbe apparire in un documento.

La forma generale del comando è

> pybformat [optioni] <style>:<format> database...

Questo comando userà un formato chiamato alpha per creare una bibliografia in LaTeX. Numerose opzioni sono disponibili per creare questi documenti:

  • --output=... o -o ...: specifica il nome del file di output. STDOUT è il predefinito

  • --header=... o -H ...: definisce un file che sarà anteposto al file di output.

  • --footer=... o -F ...: definisce un file che sarà accodato al file di output.

  • --list=styles o -l styles: elenca gli stili disponibili

  • --list=output o -l output: elenca i formati di output disponibili