For more fine-grained list of changes or to report a bug, consult
Releases will be numbered with the following semantic versioning format:
And constructed with the following guidelines:
For more information on SemVer, please visit http://semver.org/.
bibtex and
RefManageR are back2017-06-24
utilsrmarkdown and
pandoc (see #67)LastName_Year)cite_options that was
causing many options to be ignored. (See #63)This version is a ground-up rewrite of knitcitations, providing a more powerful interface while also streamlining the back end, mostly by relying more on external libraries for knitty gritty. While an effort has been made to preserve the most common uses, some lesser-used functions or function arguments have been significantly altered or removed. Bug reports greatly appreciated.
citet/citep now accept more options. In
addition to the four previously supported options (DOI, URL, bibentry or
bibkey (of a previously cited work)), these now accept a plain text
query (used in a CrossRef Search), or a path to a PDF file (which
attempts metadata extraction).
Citation key generation is now handled internally, and cannot be
configured just by providing a named argument to
citet/citep.
The cite function is replaced by
bib_metadata. This function takes any argument to
citet/citep as before (including the new
arguments), see docs.
Linked inline citations now use the configuration: cite_options(style=“markdown”, hyperlink=“to.doc”) provides a link to the DOI or URL of the document, using markdown format.
Support for cito and tooltip have been removed. These may be restored at a later date. (The earlier implementation did not appropriately abstract the use of these features from the style/formatting of printing the citation, making generalization hard.
bibliography now includes CSL support directly for
entries with a DOI using the style= argument. No need to
provide a CSL file itself, just the name of the journal (or rather, the
name of the corresponding csl file: full journal name, all lower case,
spaces as dashes). See
https://github.com/cboettig/knitcitations/issues/38
bibliography formatting has otherwise been
completely rewritten, and no longer uses print_markdown, print_html, and
print_rdfa methods. rdfa is no longer available, and other formats are
controlled through cite_options. For formal publication pandoc mode is
recommended instead of bibliography.
citet(citation()) (issue #55)citep method (caused by missing
page argument).Rmd files remain as before, importing
citation data on the fly with citep() and
citet taking DOIs, URLs, or bibentries as arguments, but
render in pandoc’s markdown. The citations used are written to a bibtex
file and the user must use pandoc (either directly or through RStudio’s
rmarkdown) to format the
citations appropriately. See the updated vignette & README. This
method has to be enabled with
options(citation_format = "pandoc") at present, otherwise
compatibility mode is enabled by default. (see #57)citep and
citet (see issue #32)bib_format method to change order of
citation elements in reference listlinked=FALSE to the calls to citet
or citepcite_options,
to toggle certain settings such as tooltips, linked inline text,cite is now exported to the namespace. Useful to return
a bibentry object given a DOI or URL.bibliography('markdown')bibliography can print
with method ‘rdfa’ to provide RDFa enhanced HTML bibliography data, and
citations can take cito arguments as an option. (Closes issues #16 and
#17)bibliography now takes more options to match the
bibstyle and print.bibentry functions.citet and citep take an optional argument
for formating the citation, defaulting to authoryear
format. Future versions may move this into an option.newbib() function initializes and clears existing cache
files.options("bibtex_data" = TRUE).print(bibliography, "html"),
one can simply call bibliography() or
bibliography("html"). Sort is still an option, other
options that were for internal use (debug,
remove_duplicates) are removed as they are no longer
necessary.bibliography() now takes style as an option (html,
text, bibtex output)