imgur_upload

0th

Percentile

Upload a image to imgur.com

This function uses the RCurl package to upload a image to imgur.com, and parses the XML response to a list with XML which contains information about the image in the Imgur website.

Usage
imgur_upload(file, key = "60e9e47cff8483c6dc289a1cd674b40f")
Arguments
file
the path to the image file to be uploaded
key
the API key for Imgur (by default uses a key created by Yihui Xie, which allows 50 uploads per hour per IP address)
Details

When the output format from knit() is HTML or Markdown, this function can be used to upload local image files to Imgur, e.g. set the package option opts_knit$get(upload.fun = imgur_upload), so the output document is completely self-contained, i.e. it does not need external image files any more, and it is ready to be published online.

Value

  • A character string of the link to the image; this string carries an attribute named XML which is a list converted from the response XML file; see Imgur API in the references.

Note

Please register your own Imgur application to get your API key; you can certainly use mine, but this key is in the public domain so everyone has access to all images associated to it.

References

Imgur API: http://api.imgur.com/; a demo: http://yihui.name/knitr/demo/upload/

Aliases
  • imgur_upload
Examples
f = tempfile(fileext = ".png")
png(f)
plot(rnorm(100), main = R.version.string)
dev.off()
res = imgur_upload(f)
res  # link to original URL of the image
attr(res, "XML")  # all information
if (interactive()) 
    browseURL(res$links$imgur_page)  # imgur page

## to use your own key
opts_knit$set(upload.fun = function(file) imgur_upload(file, key = "your imgur key"))
Documentation reproduced from package knitr, version 0.9, License: GPL

Community examples

Looks like there are no examples yet.