Kako uporabiti skripte, ki pridejo s Pybliographer.
Zoltán Kóta
zoltank@gmail.com
Frédéric Gobry
frederic.gobry@epfl.ch

Dovoljenje Creative Commons - deljenje pod istimi pogoji 3.0

# Obstoječi skripti

Nekateri skripti so priloženi programu Pybliographer, tako kot primer kot uporabna orodja. So precej kratki in bi jih morali znati prebrati z osnovnim znanjem Python

# pybcheck

          	To orodje ustvari seznam datotek ali map in preveri, če se veljavne (skladnja, ni vnosov z enakim ključem, ...)

Izhod lahko uporabite neposredno v prepomnilniku prevajanja emacs za neposreden skok na najdene napake. Za to vtipkajte M x compile, nato vnesite ukaz pybcheck vaše datoteke in uporabite srednji miškin gumb za skok na okvarjeno datoteko.

# pybcompact

    	To orodje izvleče citate narejene v dokumentu LaTeX in ustvari datoteko BibTeX, ki citate vsebuje.

Običajno so bibliografije shranjene v eni ali več velikih datotekah BibTex in razširjanje vnosov v dokumentu LaTeX prepusti ukazu bibtex. Včasih je priročno ustvariti samostojen paket (na primer za deljenje v lastni obliki z nekom drugim ali za shrambo) z majhno datoteko BibTeX, ki vsebuje le vnose iz datoteke LaTeX. To orodje stori natanko to: prebere LaTeX datoteko .aux in iz navedenih podatkovnih zbirk razširi na ustrezne vnose.

# pybconvert

    	To orodje pretvori iz ene oblike bibliografij v drugo.

Splošna skladnja je precej enostavna. Za pretvorbo iz Refer v BibTeX poženite:

    	bash$ pybconvert refer..bibtex toto.refer toto.bib

# pybformat

    	Ta skript ustvari bibliografijo glede na bibliografski slog in jo shrani v navedeni vrsti datotek (HTML, LaTeX, ...), ki naj bi se pojavila v dokumentu.

Splošna oblika ukaza je

    	bash$pybformat [možnosti] podatkovna zbirka ...

To ukaz bo brez možnosti uporabil slog alpha za ustvarjanje bibliografije v Besedilni obliki. Za ustvarjanje teh dokumentov je na voljo več možnosti:

--style=... ali -s ...: navede slog bibliografije. To je lahko polna pot do obstoječe datotkee XML ali ime, ki bo iskano v običajnih mestih. Privzeto je Alpha.

--format=... ali -f ...: navede izhodno vrsto datotek (HTML, LaTeX, Raw, Besedilo, Textau, Textnum). Privzeto je besedilo. (Textau in Textnum sta samo rahlo spremenjeni različici besedila. Za več podrobnosti si oglejte .)

--output=... ali -o ...: navede izhodno ime datoteke. STDOUT je privzet.

--header=... ali -H ...: določi datoteko, ki bo bila pripeta začetku izhodne datoteke.

--footer=... or -F ...: določi datoteko, ki bo pripeta koncu izhodne datoteke.

--list=output ali -l output: izpiše razpoložljive izhodne vrste datotek

# pybtex

    	To orodje išče citate v dokumentu LaTeX in ustvari datoteko bibliografije LaTeX.

To orodje prebere LaTeX datoteko .aux in izvleče ustrezne vnose iz navedenih podatkovnih zbirk BibTeX in ustvari LaTeX datoteko .bbl.

Oblika ukaza je

    	bash$ pybtex datotekalatex [datotekebibtex ...]

# pybtext

    	To orodje obdela besedilo datoteko, ki vsebuje citate in pripne bibliografijo glede na dani slog.

Ta skript išče citate kot [ključ] ali [ključ1, ključ2 ...] v besedilni datoteki (na primer: ... To je odsek besedila s citati [AKM95, MPJ+03], vstavljen iz pybliographer ...). Naprej glede na ključe v besedilni datoteki ustvari seznam referenc. Z uporabo ustreznega sloga (glejte spodaj) zamenja ključe podatkovne zbirke v telesu besedila z novimi ključi, ki jih ustvari modul sloga in jih na koncu pripne besedilu seznama referenc v novo datoteko.

Ključe izbranih vnosov lahko enostavno kopirate iz pybliographer v urejevalnik besedila ali terminal s kopiranjem in lepljenjem ali vlečenjem in spuščanjem.

Splošna oblika ukaza je

    	bash$ pybtext [-o izhodna datoteka] [-s slog] besedilnadatoteka datotekebib ...

Ukaz brez možnosti bo ustvaril slog Abbrev in izhodno datoteko textfile.pyb za obdelavo. besedilnadatoteka je ime datoteke za obdelavo in datotekebib je ena ali več datotek bibliografske podatkovne zbirke.

Obstajajo trije različni slogi zasnovani za pybtext. Slog abbrvbib se uporablja za rezultate v ključih, kot so določeni v podatkovni zbirki. S slogom abbrvau je mogoče ustvariti ključe vrste avtor-leto (na primer Jackson et al., 2004). Z uporabo abbrvnum skript proizvede enostaven oštevilčen seznam. Za abbrvau in abbrvnum sta uporabljeni obliki Textau in Textnum. To sta enostavni spremembi oblike Besedilo, optimizirani za te sloge. Pri uporabi drugih slogov (Aplha, Abbrev ali apa4e) telo besedila ni obdelano. Seznam referenc je pripet v obliki, ki ustreza uporabljenemu slogu.