Referencias APA

En el directorio _bibliography se pueden definir archivos de fuentes bibliográficas en formato BibTeX.

Para aprender cómo crear fuentes bibliográficas te recomendamos leer la Guía de BibTeX. A continuación se muestra un ejemplo de cómo luce una entrada en el archivo de fuentes bibliográficas en formato BibTeX.

Considere un archivo referencias.bib que contiene dos fuentes:

@book{KENNY,
  title={Breve historia de la filosofía occidental},
  author={Kenny, Anthony},
  year={2005},
  publisher={Paidós}
}

@book{STEWART,
  author   = {Stewart, James},
  title    = {Cálculo de una Variable, Trascendentes Tempranas},
  year      = 2018,
  edition   = 8,
  publisher = {Cengage Learning Editores},
  address   = {México D.F.}
}

En este caso, KENNY y STEWART son identificadores de la fuente bibliográfica. La primera entrada corresponde a un libro llamado “Breve historia de la filosofía occidental”, de Anthony Kenny, publicado en el 2005 por el editorial Paidós. Y la segunda entrada es del libro “Cálculo de una Variable, Trascendentes Tempranas” de James Stwewart, publicado en el 2018 por Cenage Learning Editores.

El archivo de fuentes bibliográficas puede contener múltiples entradas como esta, para diferentes tipos de fuentes.

Paráfrasis

Al escribir un artículo en markdown, se puede utilizar el comando {% cite id-ref %} para referenciar alguna fuente cuyo identificador es id-ref.

Parentética:

Se ha demostrado que la comprensión de los conceptos fundamentales del cálculo 
diferencial es crucial para abordar problemas de optimización complejos en 
diversas áreas aplicadas  {% cite STEWART %}

Narrativa

Para crear la cita narrativa, el escritor del artículo mencionará el nombre de la fuente manualmente, y al incluir la referencia adaptará el comando de cita para suprimir al autor.

Según Stewart  {% cite ruby -A %}, la comprensión sólida de los conceptos fundamentales del 
cálculo diferencial es indispensable para resolver problemas complejos de 
optimización en diversas aplicaciones.

Que produce una salida como:

Se ha demostrado que la comprensión de los conceptos fundamentales del cálculo diferencial es crucial para abordar problemas de optimización complejos en diversas áreas aplicadas (Stewart, 2018).

La opción -A suprime la inclusión del autor. También se puede especificar como --suppress_author

Que produce una salida como:

Según Stewart (2018), la comprensión sólida de los conceptos fundamentales del cálculo diferencial es indispensable para resolver problemas complejos de optimización en diversas aplicaciones.

Cita textual

Para la cita textual, simplemente se debe incluir la referencia a la(s) página(s) en la fuente.

Parentética

Por ejemplo:

La autora afirma que "la topología proporciona un marco abstracto 
poderoso para entender la continuidad y la convergencia en espacios 
no euclidianos" {% cite GARCIA -l 45 %}.

Que produce una salida como:

La autora afirma que "la topología proporciona un marco abstracto poderoso para entender la continuidad y la convergencia en espacios no euclidianos" (García, 2020, p. 45).

La opción -l permite indicar la página o páginas en la fuente. Alternativamente, se puede especificar como --locator.

Narrativa

Por ejemplo:

García {% cite GARCIA -A %} señala que "la topología proporciona un marco abstracto  poderoso para entender la continuidad y la convergencia en espacios no euclidianos" (p. 45).

Que produce la salida:

García (2020) señala que "la topología proporciona un marco abstracto poderoso para entender la continuidad y la convergencia en espacios no euclidianos" (p. 45).

Referencias

Para que se despliegue la lista de obras referenciadas en tu artículo, simplemente coloca el siguiente código en tu artículo, en el punto donde deseas incrustar las referencias.

# Referencias

{% bibliography --cited %}

El ejemplo anterior solo incluye obras citadas, y de forma predetermina se buscarán en el archivo _bibliography/references.bib. Si deseas citar obras en algún otro archivo dentro del directorio _bibliography, puedes pasar un parámetro adicional al comando para indicar cual archivo utilizar para buscar las fuentes.

En el siguiente ejemplo se incluyen referencias bibliográficas que se obtendrán del archivo _bibligraphy/secundario.bib.

# Referencias

{% bibliography --file secundario --cited %}

También es posible citar fuentes de diferentes archivos. El siguiente ejemplo, cita a Stewart usando un archivo de fuentes llamado _bibliography/primario.bib:

[...] para abordar problemas de optimización complejos en diversas áreas aplicadas {% cite STEWART --file primario %}