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/.
2017-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)