knitr (version 1.15)

imgur_upload: Upload an image to imgur.com

Description

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 = "9f3460e67f308f6")

Arguments

file

the path to the image file to be uploaded

key

the client id for Imgur (by default uses a client id registered by Yihui Xie)

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.

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$set(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.

References

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

Examples

## Not run: 
# 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)
# 
# # to use your own key
# opts_knit$set(upload.fun = function(file) imgur_upload(file, key = "your imgur key"))
# ## End(Not run)