Este es el comando pandoc-citeproc que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
pandoc-citeproc: filtro para resolver citas en un documento pandoc.
SINOPSIS
pandoc-citeproc [opciones] [archivo ..]
DESCRIPCIÓN
El ejecutable pandoc-citeproc tiene dos modos, modo de filtro y modo de conversión.
Filtrar modo
Ejecutar sin opciones, actúa como un filtro que toma un documento Pandoc codificado en JSON,
da formato a las citas y agrega una bibliografía, y devuelve un documento pandoc codificado en JSON.
Las citas se resolverán y se insertará una bibliografía en un elemento Div con id
refs. Si no existe tal Div, se creará uno y se adjuntará al final del documento.
(a menos que el campo de metadatos de supresión de bibliografía esté establecido en un valor verdadero). Si desea el
bibliografía para tener un encabezado de sección, coloque el encabezado de la sección al final de su documento.
(Consulte la página de manual de pandoc_markdown (5) en "Citas" para obtener detalles sobre cómo codificar
citas en la rebaja de pandoc.)
Para procesar citas con pandoc, llame a pandoc-citeproc como filtro:
pandoc --filter pandoc-citeproc entrada.md -s -o salida.html
pandoc-citeproc buscará los siguientes campos de metadatos en la entrada:
bibliografía
Una ruta, o lista YAML de rutas, de archivos de bibliografía para usar. Estos pueden estar en cualquier
de los formatos soportados por bibutils.
Formato Extensión de archivo
─────────────────────────────
BibLaTeX .bib
BibTeX .bibtex
Copac .copac
CSL JSON.json
CSL YAML.yaml
Nota final .enl
Nota final XML .xml
ISI .wos
MEDLINE.medline
MODS .mods
RIS.ris
Tenga en cuenta que .bib generalmente se puede usar con archivos BibTeX y BibLaTeX, pero
puede usar .bibtex para forzar BibTeX.
referencias
Una lista de referencias YAML. Cada referencia es un objeto YAML. El formato es
esencialmente formato CSL JSON. Aquí hay un ejemplo:
- identificación: doe2006
autor:
familia: Doe
dado: [John, F.]
título: artículo
página: 33-34
emitido:
año: 2006
tipo: artículo-revista
volumen: 6
container-title: Revista de estudios genéricos
El contenido de los campos se interpretará como rebaja cuando sea apropiado: así, para
Por ejemplo, el énfasis y el énfasis fuerte se pueden utilizar en archivos de título. Matemáticas simples de tex
también se analizarán y reproducirán de forma adecuada.
csl or estilo de cita
Ruta o URL de un archivo de estilo CSL. Si el archivo no se encuentra en relación con el trabajo
directorio, pandoc-citeproc buscará en el directorio $ HOME / .csl (o
C: \ Users \ USERNAME \ AppData \ Roaming \ csl en Windows 7). Si esto se deja fuera,
pandoc-citeproc buscará $ HOME / .pandoc / default.csl, y si no es así
presente, usará chicago-author-date.csl, buscando primero en $ HOME / .csl y luego
en sus propios archivos de datos.
enlaces-citas
Si esto tiene un valor verdadero, las citas en la fecha del autor y los estilos numéricos serán
hipervínculos a sus entradas bibliográficas correspondientes. El valor predeterminado es no agregar
hipervínculos.
abreviaturas de citas
Ruta a un archivo JSON de abreviaturas CSL. Si el archivo no se encuentra en relación con el
directorio de trabajo, pandoc-citeproc buscará en el directorio $ HOME / .csl (o
C: \ Users \ USERNAME \ AppData \ Roaming \ csl en Windows 7). El formato se describe aquí
(http://citationstylist.org/2011/10/19/abbreviations-for-zotero-test-release).
A continuación, se muestra un breve ejemplo:
{ "defecto": {
"título-contenedor": {
"Informes de la ley de Lloyd": "Representante de Lloyd",
"Estates Gazette": "EG",
"Scots Law Times": "SLT"
}
}
}
lang Configuración regional para usar en el formato de las citas. Si no se establece, la configuración regional se toma
del atributo de configuración regional predeterminada del archivo CSL. en-US se usa si una configuración regional es
no especificado ni en los metadatos ni en el archivo CSL. (Para al revés
compatibilidad, la configuración regional del campo se puede utilizar en lugar de lang, pero este idioma debe
se utilizará en el futuro.)
suprimir-bibliografía
Si esto tiene un valor verdadero, se omitirá la bibliografía. De lo contrario, un
La bibliografía se insertará en cada elemento Div con referencias de id. Si no hay
tal Div, se creará uno al final del documento.
título-sección-referencia
Si tiene un valor, se agregará un encabezado de sección con este título antes del
bibliografía. Si no se especifica el título de la sección de referencia y el documento termina
con un encabezado de sección, este encabezado final se tratará como la bibliografía
cabecera.
Los metadatos deben contener referencias o bibliografía o ambos como fuente de
referencias. csl y las abreviaturas de citas son opcionales. Si no se proporciona csl,
se utilizará la hoja de estilo predeterminada (ya sea ~ / .pandoc / default.csl o una versión de
chicago-autor-fecha.csl).
Convertir modo
Si se usa la opción --bib2yaml o --bib2json, pandoc-citeproc no procesará
citas; en su lugar, tratará su entrada (de stdin o archivos) como una bibliografía y
conviértalo en una sección de metadatos YAML de pandoc, adecuada para su inclusión en un pandoc
document (--bib2yaml), o como una bibliografía CSL JSON, adecuada para importar a zotero
(--bib2json).
La opción --format se puede utilizar para especificar el formato de la bibliografía, aunque cuando los archivos se
usado, pandoc-citeproc generalmente puede adivinar esto a partir de la extensión.
Este modo reemplaza al antiguo programa biblio2yaml.
OPCIONES
-h, --ayuda
Imprimir información de uso.
-V, --versión
Versión impresa.
-y, --bib2yaml
Convierta bibliografía a YAML adecuado para su inclusión en metadatos de pandoc.
-j, --bib2json
Convierta bibliografía a CSL JSON adecuado para importar a Zotero.
-f FORMATO, --format =FORMATO
Especifique el formato de la bibliografía a convertir. Los valores legales son biblatex, bibtex,
ris, endnote, endnotexml, isi, medline, copac, mods y json.
NOTAS
General
Si usa una base de datos biblatex, siga de cerca las especificaciones en la "Guía de la base de datos"
sección del manual biblatex (actualmente 2.8a).
Si usa una base de datos CSL-YAML o CSL-JSON, o una sección de metadatos CSL-YAML en su
documento de rebajas, siga la "Citation Style Language 1.0.1 Language Specification"
(<http://citationstyles.org/downloads/specification.html>). Particularmente relevantes son
<http://citationstyles.org/downloads/specification.html# appendix-iii-types> (que ni
comenta sobre el uso ni especifica campos obligatorios y opcionales) y
<http://citationstyles.org/downloads/specification.html# appendix-iv-variables> (que no
contener comentarios).
Títulos: Título vs Sentencia Caso
Si está utilizando una bibliografía bibtex o biblatex, observe las siguientes reglas:
· Los títulos en inglés deben estar en mayúsculas y minúsculas. Los títulos que no estén en inglés deben estar en mayúsculas y minúsculas,
y el campo lánguido de biblatex debe establecerse en el idioma correspondiente. (El seguimiento
los valores se tratan como en inglés: americano, británico, canadiense, inglés, australiano,
Newzealand, USenglish o UKenglish.)
· Como es estándar con bibtex / biblatex, los nombres propios deben protegerse con llaves
para que no se pongan en minúsculas en estilos que requieran mayúsculas y minúsculas. Por ejemplo:
title = {Mi cena con {Andre}}
· Además, las palabras que deben permanecer en minúsculas (o camelCase) deben protegerse:
title = {Dispersión de ondas giratorias en la escala {nm}}
Aunque esto no es necesario en bibtex / biblatex, es necesario con citeproc, que
almacena los títulos internamente en mayúsculas y minúsculas y los convierte en mayúsculas y minúsculas en estilos que
lo requiera. Aquí protegemos "nm" para que no se convierta a "Nm" en este
etapa.
Si está utilizando una bibliografía CSL (ya sea JSON o YAML), observe lo siguiente
reglas:
· Todos los títulos deben estar en mayúsculas y minúsculas.
· Utilice el campo de idioma para títulos que no estén en inglés para evitar su conversión a mayúsculas y minúsculas.
en estilos que lo requieran. (La conversión ocurre solo si el idioma comienza con en o es
dejado vacío.)
· Proteja las palabras que no deben convertirse a mayúsculas y minúsculas con esta sintaxis:
Dispersión de la onda de giro en la escala nm
Congreso Documentos, Publicado vs Inédito
Para un artículo de conferencia publicado formalmente, use el tipo de entrada biblatex en los procedimientos
(que se asignará a la conferencia en papel de CSL).
Para un manuscrito inédito, use el tipo de entrada biblatex inédito sin un
campo de título de evento (este tipo de entrada se asignará al manuscrito de CSL).
Para una charla, un artículo de conferencia inédito o una presentación de póster, use el biblatex
tipo de entrada no publicado con un campo de título de evento (este tipo de entrada se asignará a CSL
habla). Utilice el campo de tipo biblatex para indicar el tipo, por ejemplo, "Papel" o "Póster".
El lugar y la fecha del evento también pueden ser útiles, aunque la mayoría de CSL no representará la fecha del evento.
estilos. Tenga en cuenta que el lugar es para el lugar del evento, a diferencia de la ubicación que describe el
ubicación del editor; no utilice este último para un artículo de conferencia inédito.
AUTORES
Andrea Rossato y John MacFarlane.
Use pandoc-citeproc en línea usando los servicios de onworks.net