Comment utiliser les scripts inclus dans Pybliographer.
Zoltán Kóta
zoltank@gmail.com
Frédéric Gobry
frederic.gobry@epfl.ch

Licence Créative Commons des Conditions Initiales à l'Identique 3.0

# Scripts existants

Certains scripts sont déjà inclus dans Pybliographer, aussi bien comme exemples que comme utilitaires. Ils sont assez courts et devraient être lisibles en ayant seulement une compréhension basique du langage Python.

# pybcheck

          	Ce script prend une liste de fichiers ou de dossiers et s'assure qu'ils sont valides (syntaxe, pas d'entrée avec la même clé,...)

Vous pouvez utiliser directement sa sortie dans un tampon de compilation emacs pour se rendre directement aux erreurs. Saisissez M x compile, puis la commande pybcheck vosfichiers et déplacez-vous vers les fichiers erronés en appuyant sur le bouton central de la souris.

# pybcompact

    	Ce script extrait les citations d'un document LaTeX et génère un fichier BibTeX les contenant.

Normalement, vos bibliographies sont enregistrées dans un ou plusieurs gros fichiers BibTeX et bibtex extrait les entrées utilisées dans le document LaTeX. Mais il est parfois plus aisé de créer un ensemble autonome sous forme d'un fichier minimaliste contenant exactement les entrées utilisées en LaTeX (par exemple pour en partager les sources avec quelqu'un d'autre ou pour le sauvegarder). C'est bien le rôle de ce script : il lit les fichiers .aux LaTeX et extrait les entrées correspondantes des bases de données BibTeX spécifiées.

# pybconvert

    	Ce script convertit une bibliographie d'un format à un autre.

La syntaxe générale est relativement simple. Pour convertir de Refer en BibTeX par exemple, exécutez simplement :

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

# pybformat

    	Ce script génère une bibliographie en fonction d'un style bibliographique et retourne le résultat dans un format spécifique (comme HTML, LaTeX...) tel qu'elle doit s'afficher dans un document.

La syntaxe générale de la commande est

    	bash$pybformat [options] base2données...

Cette commande sans option utilise le style appelé alpha pour créer une bibliographie au format Text. Plusieurs options sont disponibles pour créer ces documents :

--style=... ou -s ... : spécifie un style de bibliographie. Cela peut être un chemin absolu vers un fichier XML existant, ou un nom qui pourra être recherché dans les emplacements standards. Le style par défaut est Alpha.

--format=... ou -f ... : spécifie un format de sortie (HTML, LaTeX, Raw, Text, Textau, Textnum). Le format par défaut est Text (Textau et Textnum ne sont que des versions légèrement modifiées de Text, consultez pour plus de détails).

--output=... ou -o ... : spécifie un nom de fichier de sortie. STDOUT est la sortie par défaut.

--header=... ou -H ... : définit un fichier qui sera ajouté en tête du fichier de sortie.

--footer=... ou -F ... : définit un fichier qui sera ajouté à la fin du fichier de sortie.

--list=output ou -l output : affiche les formats de sortie disponibles

# pybtex

    	Ce script recherche les citations dans un document LaTeX et génère un fichier bibliographique de LaTeX.

Ce script lit un fichier .aux LaTeX et crée un fichier .bbl LaTeX en extrayant les entrées correspondantes de la base de données BibTeX spécifiée.

La syntaxe de la commande est

    	bash$ pybtex fichierlatex [fichiersbibtex...]

# pybtext

    	Ce script traite un fichier texte contenant des citations et ajoute en fin de fichier une bibliographie en fonction d'un style donné.

Le script recherche des citations comme [clé] ou [clé1,clé2...] dans un fichier texte (par exemple : ...Voici un fragment de texte avec des citations [AKM95,MPJ+03] insérées depuis pybliographer...). Pour commencer, en fonction des clés trouvées dans le fichier texte, il génère une liste de référence. Puis, en utilisant un style approprié (voir ci-dessous), il remplace les clés de la base de données dans le corps du texte par les nouvelles clés générées par le module de style et enfin, il ajoute en fin de fichier la liste de références au texte, en créant un nouveau fichier.

Les clés des entrées sélectionnées peuvent être copiées facilement depuis pybliographer vers un éditeur de texte ou dans un terminal par la méthode du copier-coller ou du glisser-déposer.

La syntaxe générale de la commande est

    	bash$ pybtext [-o fichier2sortie] [-s style] fichierTexte fichiersBib...

Cette commande sans option utilise le style appelé Abbrev et le fichier de sortie textfile.pyb pour le traitement. fichierTexte est le nom du fichier à traiter et fichiersBib un ou plusieurs fichiers de base de données bibliographiques.

Il existe trois styles différents conçus pour pybtext. L'utilisation de abbrvbib donne des clés telles qu'elles sont définies dans la base de données. Avec le style abbrvau, vous pouvez générer des clés de type auteur-année (par ex. Jackson et al., 2004). Avec abbrvnum, le script ne crée qu'une simple liste numérotée. Les styles abbrvau et abbrvnum utilisent respectivement les formats Textau et Textnum. Ce ne sont que de simples modifications du format Text optimisées pour ces styles. En utilisant d'autres formats (Alpha, Abbrev ou apa4e), le corps du texte n'est pas traité, mais la liste de référence est ajoutée sous la forme qui correspond au style utilisé.