drop_name_crossref: Create visual citation from Crossref data
In namedropR: Create Visual Citations for Presentations and Posters
View source: R/drop_name_crossref.R
drop_name_crossref R Documentation
Create visual citation from Crossref data
Description
Takes one or several dois and extracts information from Crossref, then processes them into visual citations with drop_name. Requires rcrossref > v1.1, see README for further details.
Usage
drop_name_crossref(dois, ...)
Arguments
dois
One or several dois to create visual citations for. If they are named, these names are used as filenames; otherwise they are generated based on authors and years.
...
Arguments passed on to drop_name
export_asA string specifying the desired output format. For now supports PNG and HTML.
Use "html" to include the 'bare' taglist (recommended for inclusion in Rmarkdown documents) or "html_full" to write a standalone .html file including <head> etc.
The PNG is a screenshot of the rendered HTML via the 'webshot' package. The filename represents this two step approach on purpose.
For webshot you need to install phantomJS once (see 'webshot' documentation).
output_dirA string specifying the relative path, where the rendered output files should be stored.
max_authorsInteger number of maximum authors to print. If the number of authors exceeds this, the list is cropped accordingly.
include_qrCharacter string specifying the way the QR code should be included or if no QR code should be included.
'embed' results in a stand alone <img> tag within the HTML object, other options are ignored for the time being.
'link' (default) creates a PNG of the QR code and stores it in a subfolder of the HTML file's location. The HTML <img> tag links to this file then.
'link_svg' creates a SVG of the QR code and stores it in a subfolder of the HTML file's location. The HTML <img> tag links to this file then.
'none' creates no QR code.
styleA string specifying the desired style for the visual citation. Possible values are:
"modern", "classic", "clean", "fancy", "newspaper", "compact" and "none".
If "compact" is given, the rendered VC contains
only the last name of the first author and the publication year, next to the QR code.
If "none" is given, the returned html can use a custom css file provided by the user.
This custom CSS file must specify styles for <div> classes "top-row", "title-row" and "author-row". (see vignette)
path_absoluteBoolean to specify, whether the returned output path is a relative path or an absolute path.
use_xaringanBoolean to specify if an HTML output is intended to be included in an HTML presentation (like e.g. xaringan) or not.
When including the visual citation via htmltools::includeHTML(), the QR code needs to be in a subfolder
relative to the rendered presentation, not relative to the visual citation.
clean_stringsRemoves curly braces from titles and journal names, as they are often present in
BibTeX strings, but not needed for the rendering. TRUE by default, but can be set to FALSE, if the are needed.
qr_sizeSpecifies the height/width of the rendered QR code in px. Default: 250px, minimum: 150px. Ignored for SVG output.
qr_colorSpecifies the foreground color of the QR code as hex-string, e.g. "#00FF00"; default is black: "#000000".
qr_hyperlinkLogical. Should the QR code be a hyperlink?
vc_widthSpecifies the width of the text part of the visual citation in px.
This can be adjusted to accommodate e.g. untypically long or short titles. Default: 600px
Value
A character string with the file path to the created visual citation in the specified output format.
Examples
## Not run:
drop_name_crossref(c(cite1 = "10.1126/science.169.3946.635", cite2 = "10.1111/joms.12670"))
## End(Not run)
namedropR documentation built on Aug. 28, 2022, 5:06 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
View source: R/drop_name_crossref.R
| drop_name_crossref | R Documentation |
Create visual citation from Crossref data
Description
Takes one or several dois and extracts information from Crossref, then processes them into visual citations with drop_name. Requires rcrossref > v1.1, see README for further details.
Usage
drop_name_crossref(dois, ...)
Arguments
dois |
One or several dois to create visual citations for. If they are named, these names are used as filenames; otherwise they are generated based on authors and years. |
... |
Arguments passed on to
|
Value
A character string with the file path to the created visual citation in the specified output format.
Examples
## Not run: drop_name_crossref(c(cite1 = "10.1126/science.169.3946.635", cite2 = "10.1111/joms.12670")) ## End(Not run)
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.