Il linguaggio di scripting &pyb; è 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, &pyc;, è essa stessa un semplice script al di sopra di &pyb;. Per eseguire uno script scritto per &pyb;, digita semplicemente > 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,...) È 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 le 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 [opzioni] database... Questo comando userà un formato chiamato alpha per creare una bibliografia in LaTeX. Numerose opzioni sono disponibili per creare questi documenti: : specifica uno stile bibliografico. Può essere un percorso completo verso un file XML esistente o il nome sarà cercato nei posti standard. Alpha è il predefinito. : specifica un formato di output (come HTML, LaTeX,...). Text è il predefinito. : specifica il nome del file di output. STDOUT è il predefinito. : definisce un file che sarà anteposto al file di output. : definisce un file che sarà accodato al file di output. : elenca i formati di output disponibili. Scrivere i propri script Per iniziare a scrivere i tuoi script puoi leggere quello che segue e dare un'occhiata agli script esistenti. Provare ad adattarli alle tue esigenze personali può essere un buon modo per verificare quello che hai letto. Alcuni concetti Questa sezione descrive alcune classi e idee basilari che sono utili per capire come funziona &pyb; . Maggiori informazioni possono essere trovate in . Nel paragrafo seguente, tutti i moduli a cui ci si riferirà apparterranno al dominio Pyblio. Perciò, per accedere ai membri del modulo Open, dovrai scrivere all'inizio del tuo script qualcosa come from Pyblio import Open Il modulo Base contiene alcune delle più basilari classi usate nell'applicazione: Base.Entry rappresenta una specifica voce bibliografica con tutti i suoi campi. Si comporta come una tabella hash che restituisce il contenuto di un campo dato il suo nome Base.DataBase è la classe dalla quale eredita ogni tipo di database. Si comporta come una tabella hash che restituisce una Base.Entry data una Base.Key Key.Key è l'oggetto che identifica unicamente una voce. Quest'oggetto deve essere unico nell'intera applicazione ed è composto da una parte del database e da una parte della voce. Un Iteratore è un oggetto che fornisce un modo per accedere a una sequenza di oggetti in ordine. Questi iteratori sono usati in &pyb; in modo esteso perchè nascondono il meccanismo di accesso sottostante e forniscono lo stesso accesso ad ogni database. Sono anche perfettamente adatti per implementare un filtraggio trasparente e per l'ordinamento delle voci: la classe Selection.Selection per esempio prende un iteratore (su un database per esempio) e ne restituisce uno nuovo che itererà solamente su un sottoinsieme di voci, in accordo a un criterio di ricerca.