pandoc-citeproc - En ligne dans le Cloud

PROGRAMME:

Nom

pandoc-citeproc - filtre pour résoudre les citations dans un document pandoc.

SYNOPSIS

pandoc-citeproc [options] [fichier..]

DESCRIPTION

L'exécutable pandoc-citeproc a deux modes, le mode filtre et le mode conversion.

Filtre mode
Exécuté sans options, il agit comme un filtre qui prend un document Pandoc encodé en JSON,
formate les citations, ajoute une bibliographie et renvoie un document pandoc codé en JSON.
Les citations seront résolues et une bibliographie sera insérée dans un élément Div avec id
réf. Si aucune Div n'existe, une sera créée et ajoutée à la fin du document
(sauf si le champ de métadonnées suppress-bibliography est défini sur une valeur vraie). Si vous souhaitez le
bibliographie pour avoir un en-tête de section, placez l'en-tête de section à la fin de votre document.
(Voir la page de manuel pandoc_markdown (5) sous "Citations" pour plus de détails sur la façon d'encoder
citations dans la démarque de pandoc.)

Pour traiter les citations avec pandoc, appelez pandoc-citeproc comme filtre :

pandoc --filter pandoc-citeproc input.md -s -o output.html

pandoc-citeproc recherchera les champs de métadonnées suivants dans l'entrée :

bibliographie
Un chemin, ou une liste de chemins YAML, des fichiers bibliographiques à utiliser. Ceux-ci peuvent être dans n'importe quel
des formats supportés par bibutils.

Formater l'extension de fichier
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
BibLaTeX .bib
BibTeX .bibtex
Copac .copac
CSLJSON.json
CSLYAML.yaml
Note de fin .enl
EndNote XML .xml
ISI.wos
MEDLINE .medline
MODS .mods
RIS .ris

Notez que .bib peut généralement être utilisé avec les fichiers BibTeX et BibLaTeX, mais vous
peut utiliser .bibtex pour forcer BibTeX.


Une liste de références YAML. Chaque référence est un objet YAML. Le format est
essentiellement au format CSL JSON. Voici un exemple:

- identifiant : doe2006
auteur:
famille : biche
donné : [John, F.]
titre : article
pages : 33-34
Publié:
année: 2006
type : article-journal
tome : 6
titre-conteneur : Journal of Generic Studies

Le contenu des champs sera interprété comme une démarque le cas échéant : ainsi, pour
Par exemple, l'emphase et l'emphase forte peuvent être utilisées dans les dépôts de titres. Mathématiques textuelles simples
seront également analysés et rendus de manière appropriée.

Csl or style citation
Chemin ou URL d'un fichier de style CSL. Si le fichier n'est pas trouvé par rapport au
répertoire, pandoc-citeproc cherchera dans le répertoire $HOME/.csl (ou
C:\Users\USERNAME\AppData\Roaming\csl sous Windows 7). Si cela est laissé de côté,
pandoc-citeproc cherchera $HOME/.pandoc/default.csl, et si ce n'est pas
présent, il utilisera chicago-author-date.csl, en regardant d'abord dans $HOME/.csl, puis
dans ses propres fichiers de données.

liens-citations
Si cela a une vraie valeur, les citations dans les styles auteur-date et numérique seront
hyperliens vers leurs entrées de bibliographie correspondantes. La valeur par défaut est de ne pas ajouter
hyperliens.

citation-abréviations
Chemin d'accès à un fichier JSON d'abréviations CSL. Si le fichier est introuvable par rapport au
répertoire de travail, pandoc-citeproc cherchera dans le répertoire $HOME/.csl (ou
C:\Users\USERNAME\AppData\Roaming\csl sous Windows 7). Le format est décrit ici
(http://citationstylist.org/2011/10/19/abbreviations-for-zotero-test-release).
Voici un petit exemple :

{ "défaut": {
"titre-conteneur": {
« Lloyd's Law Reports » : « Représentant de Lloyd »,
« Journal des successions » : « EG »,
"Scots Law Times": "SLT"
}
}
}

long Paramètres régionaux à utiliser dans la mise en forme des citations. Si ce n'est pas défini, la locale est prise
à partir de l'attribut default-locale du fichier CSL. en-US est utilisé si un paramètre régional est
n'est spécifié ni dans les métadonnées ni dans le fichier CSL. (Pour l'arrière
compatibilité, le champ locale peut être utilisé à la place de lang, mais ce lang devrait
être utilisé à l'avenir.)

supprimer-bibliographie
Si cela a une vraie valeur, la bibliographie sera laissée de côté. Sinon un
la bibliographie sera insérée dans chaque élément Div avec les références id. Si il n'y a pas
tel Div, un sera créé à la fin du document.

référence-section-titre
Si cela a une valeur, un en-tête de section avec ce titre sera ajouté avant le
bibliographie. Si le titre de la section de référence n'est pas spécifié et que le document se termine
avec un en-tête de section, cet en-tête final sera traité comme la bibliographie
en-tête.

Les métadonnées doivent contenir soit des références, soit une bibliographie, soit les deux en tant que source de
les références. csl et les abréviations de citation sont facultatives. Si csl n'est pas fourni, un
la feuille de style par défaut sera utilisée (soit ~/.pandoc/default.csl ou une version de
chicago-auteur-date.csl).

Convertir mode
Si l'option --bib2yaml ou --bib2json est utilisée, pandoc-citeproc ne traitera pas
citations; à la place, il traitera son entrée (à partir de stdin ou de fichiers) comme une bibliographie et
convertissez-le soit en une section de métadonnées YAML pandoc, adaptée à l'inclusion dans un pandoc
document (--bib2yaml), ou en tant que bibliographie CSL JSON, adaptée à l'importation dans zotero
(--bib2json).

L'option --format peut être utilisée pour spécifier le format de la bibliographie, bien que lorsque les fichiers sont
utilisé, pandoc-citeproc peut généralement le deviner à partir de l'extension.

Ce mode remplace l'ancien programme biblio2yaml.

OPTIONS

-h, --Aidez-moi
Imprimer les informations d'utilisation.

-V, --version
Version imprimée.

-oui, --bib2yaml
Convertir la bibliographie en YAML pour une inclusion dans les métadonnées pandoc.

-j, --bib2json
Convertissez la bibliographie en CSL JSON adapté à l'importation dans Zotero.

-f Format, --format=Format
Spécifiez le format de la bibliographie à convertir. Les valeurs légales sont biblatex, bibtex,
ris, endnote, endnotexml, isi, medline, copac, mods et json.

NOTES

Général
Si vous utilisez une base de données biblatex, respectez scrupuleusement les spécifications du "Guide de la base de données"
section du manuel biblatex (actuellement 2.8a).

Si vous utilisez une base de données CSL-YAML ou CSL-JSON, ou une section de métadonnées CSL-YAML dans votre
document de démarque, suivez les "Citation Style Language 1.0.1 Language Specification"
(<http://citationstyles.org/downloads/specification.html>). Sont particulièrement pertinents
<http://citationstyles.org/downloads/specification.html#appendix-iii-types> (qui ni
commentaires sur l'utilisation ni ne précise les champs obligatoires et facultatifs) et
<http://citationstyles.org/downloads/specification.html#appendix-iv-variables> (ce qui ne
contenir des commentaires).

Titres: Titre vs. Phrase Boitier
Si vous utilisez une bibliographie bibtex ou biblatex, respectez les règles suivantes :

· Les titres en anglais doivent être en majuscule. Les titres non anglais doivent être en casse de phrase,
et le champ languissant dans biblatex doit être défini sur la langue appropriée. (Ce qui suit
les valeurs sont traitées en anglais : américain, britannique, canadien, anglais, australien,
néo-zélandais, anglais américain ou anglais britannique.)

· Comme c'est le cas avec bibtex/biblatex, les noms propres doivent être protégés par des accolades
afin qu'ils ne soient pas en minuscules dans les styles qui appellent à la casse. Par exemple:

title = {Mon dîner avec {André}}

· De plus, les mots qui doivent rester en minuscules (ou camelCase) doivent être protégés :

title = {Dispersion des ondes de spin sur l'échelle {nm}}

Bien que ce ne soit pas nécessaire dans bibtex/biblatex, c'est nécessaire avec citeproc, qui
stocke les titres en interne dans la casse de la phrase et convertit en casse du titre dans des styles qui
l'exiger. Ici, nous protégeons "nm" afin qu'il ne soit pas converti en "Nm" à ce stade
étape.

Si vous utilisez une bibliographie CSL (soit JSON ou YAML), alors observez ce qui suit
règles:

· Tous les titres doivent être en casse.

· Utilisez le champ de langue pour les titres non anglais pour empêcher leur conversion en casse de titre
dans des styles qui l'exigent. (La conversion n'a lieu que si la langue commence par en ou est
laissé vide.)

· Protégez les mots qui ne doivent pas être convertis en casse de titre en utilisant cette syntaxe :

Dispersion des ondes de spin à l'échelle nm

Congrès Papiers, Publié vs. Inédit
Pour un document de conférence officiellement publié, utilisez le type d'entrée biblatex inproceedings
(qui sera mis en correspondance avec la conférence papier de CSL).

Pour un manuscrit non publié, utilisez le type d'entrée biblatex non publié sans
champ eventtitle (ce type d'entrée sera mappé au manuscrit CSL).

Pour une conférence, un document de conférence inédit ou une présentation par affiche, utilisez le biblatex
type d'entrée non publié avec un champ eventtitle (ce type d'entrée sera mappé à CSL
discours). Utilisez le champ type biblatex pour indiquer le type, par exemple « Papier » ou « Affiche ».
le lieu et la date de l'événement peuvent également être utiles, bien que la date de l'événement ne soit pas rendue par la plupart des CSL
modes. Notez que le lieu est pour le lieu de l'événement, contrairement à l'emplacement qui décrit le
l'emplacement de l'éditeur ; n'utilisez pas ce dernier pour un document de conférence non publié.

AUTEURS

Andrea Rossato et John MacFarlane.

Utiliser pandoc-citeproc en ligne en utilisant les services onworks.net