"Stores redirect url from a callback function.")
(defun doi-utils-redirect-callback (&optional status)
- "Callback for url-retrieve to set the redirect."
+ "Callback for `url-retrieve' to set the redirect.
+Optional argument STATUS Unknown why this is optional."
(when (plist-get status :error)
(signal (car (plist-get status :error)) (cdr(plist-get status :error))))
(when (plist-get status :redirect) ; is nil if there none
;; ** APS journals
(defun aps-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://journals.aps.org" *doi-utils-redirect*)
(replace-regexp-in-string "/abstract/" "/pdf/" *doi-utils-redirect*)))
;; ** Science
(defun science-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.sciencemag.org" *doi-utils-redirect*)
(concat *doi-utils-redirect* ".full.pdf")))
;; ** Nature
(defun nature-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.nature.com" *doi-utils-redirect*)
(let ((result *doi-utils-redirect*))
(setq result (replace-regexp-in-string "/full/" "/pdf/" result))
(defun doi-utils-get-wiley-pdf-url (redirect-url)
"Wileyscience direct hides the pdf url in html.
-We get it out here by parsing the html."
+We get it out here by parsing the html.
+Argument REDIRECT-URL URL you are redirected to."
(setq *doi-utils-waiting* t)
(url-retrieve redirect-url
(lambda (status)
*doi-utils-pdf-url*)
(defun wiley-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://onlinelibrary.wiley.com" *doi-utils-redirect*)
(doi-utils-get-wiley-pdf-url
(replace-regexp-in-string "/abstract" "/pdf" *doi-utils-redirect*))
;; ** Springer
(defun springer-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://link.springer.com" *doi-utils-redirect*)
(replace-regexp-in-string "/article/" "/content/pdf/" (concat *doi-utils-redirect* ".pdf"))))
;; we just change /abs/ to /pdf/.
(defun acs-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://pubs.acs.org" *doi-utils-redirect*)
(replace-regexp-in-string "/abs/" "/pdf/" *doi-utils-redirect*)))
;; ** IOP
(defun iop-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://iopscience.iop.org" *doi-utils-redirect*)
(let ((tail (replace-regexp-in-string
"^http://iopscience.iop.org" "" *doi-utils-redirect*)))
;; ** JSTOR
(defun jstor-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.jstor.org" *doi-utils-redirect*)
(concat (replace-regexp-in-string "/stable/" "/stable/pdfplus/" *doi-utils-redirect*) ".pdf")))
;; ** AIP
(defun aip-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://scitation.aip.org" *doi-utils-redirect*)
;; get stuff after content
(let (p1 p2 s p3)
- (setq p2 (replace-regexp-in-string "^http://scitation.aip.org/" "" *doi-utils-redirect*))
+ (setq p2 (replace-regexp-in-string
+ "^http://scitation.aip.org/" "" *doi-utils-redirect*))
(setq s (split-string p2 "/"))
(setq p1 (mapconcat 'identity (-remove-at-indices '(0 6) s) "/"))
(setq p3 (concat "/" (nth 0 s) (nth 1 s) "/" (nth 2 s) "/" (nth 3 s)))
;; ** Taylor and Francis
(defun tandfonline-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.tandfonline.com" *doi-utils-redirect*)
(replace-regexp-in-string "/abs/\\|/full/" "/pdf/" *doi-utils-redirect*)))
;; ** ECS
(defun ecs-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://jes.ecsdl.org" *doi-utils-redirect*)
(replace-regexp-in-string "\.abstract$" ".full.pdf" *doi-utils-redirect*)))
(defun ecst-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://ecst.ecsdl.org" *doi-utils-redirect*)
(concat *doi-utils-redirect* ".full.pdf")))
;; ** RSC
(defun rsc-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://pubs.rsc.org" *doi-utils-redirect*)
(let ((url (downcase *doi-utils-redirect*)))
(setq url (replace-regexp-in-string "articlelanding" "articlepdf" url))
;; You cannot compute these pdf links; they are embedded in the redirected pages.
(defvar *doi-utils-pdf-url* nil
- "stores url to pdf download from a callback function")
+ "Stores url to pdf download from a callback function.")
(defun doi-utils-get-science-direct-pdf-url (redirect-url)
- "Science direct hides the pdf url in html. we get it out here."
+ "Science direct hides the pdf url in html. W get it out here.
+REDIRECT-URL is where the pdf url will be in."
(setq *doi-utils-waiting* t)
(url-retrieve redirect-url
(lambda (status)
(defun science-direct-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.sciencedirect.com" *doi-utils-redirect*)
(doi-utils-get-science-direct-pdf-url *doi-utils-redirect*)
*doi-utils-pdf-url*))
;; which actually redirect to
;; http://www.sciencedirect.com/science/article/pii/S0927025609004558
(defun linkinghub-elsevier-pdf-url (*doi-utils-redirect*)
- (when (string-match "^http://linkinghub.elsevier.com/retrieve" *doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
+ (when (string-match
+ "^http://linkinghub.elsevier.com/retrieve" *doi-utils-redirect*)
(let ((second-redirect (replace-regexp-in-string
"http://linkinghub.elsevier.com/retrieve"
"http://www.sciencedirect.com/science/article"
;; http://www.pnas.org/content/early/2014/05/08/1319030111.full.pdf+html?with-ds=yes
(defun pnas-pdf-url (*doi-utils-redirect*)
+ "Get url to the pdf from *DOI-UTILS-REDIRECT*."
(when (string-match "^http://www.pnas.org" *doi-utils-redirect*)
(concat *doi-utils-redirect* ".full.pdf?with-ds=yes")))
(defun doi-utils-get-pdf-url (doi)
"Return a url to a pdf for the DOI if one can be calculated.
Loops through the functions in `doi-utils-pdf-url-functions'
-until one is found"
+until one is found."
(doi-utils-get-redirect doi)
(unless *doi-utils-redirect*
(defun doi-utils-expand-template (s)
- "Expand a template containing %{} with the eval of its contents."
+ "Expand a string template S containing %{} with the eval of its contents."
(replace-regexp-in-string "%{\\([^}]+\\)}"
(lambda (arg)
(let ((sexp (substring arg 2 -1)))
(setq doi-utils-bibtex-type-generators nil)
(defun doi-utils-concat-prepare (lst &optional acc)
- "Given a list `lst' of strings and other expressions, which are
-intented to passed to `concat', concat any subsequent strings,
+ "Minimize the number of args passed to `concat' from LST.
+Given a list LST of strings and other expressions, which are
+intended to be passed to `concat', concat any subsequent strings,
minimising the number of arguments being passed to `concat'
-without changing the results."
+without changing the results. ACC is the list of additional
+expressions."
(cond ((null lst) (nreverse acc))
((and (stringp (car lst))
(stringp (car acc)))
(t (doi-utils-concat-prepare (cdr lst) (cons (car lst) acc)))))
(defmacro doi-utils-def-bibtex-type (name matching-types &rest fields)
- "Define a BibTeX type identified by (symbol) `name' with
-`fields' (given as symbols), matching to retrieval expressions in
-`doi-utils-json-metadata-extract'. This type will only be used
+ "Define a BibTeX type identified by (symbol) NAME with
+FIELDS (given as symbols), matching to retrieval expressions in
+`doi-utils-json-metadata-extract'. This type will only be used
when the `:type' parameter in the JSON metadata is contained in
-`matching-types' - a list of strings."
+MATCHING-TYPES - a list of strings."
`(push (lambda (type results)
- (when (or ,@(mapcar (lambda (match-type) `(string= type ,match-type)) matching-types))
+ (when
+ (or ,@(mapcar
+ (lambda (match-type)
+ `(string= type ,match-type)) matching-types))
(let ,(mapcar (lambda (field)
- (let ((field-expr (assoc field doi-utils-json-metadata-extract)))
+ (let ((field-expr
+ (assoc field doi-utils-json-metadata-extract)))
(if field-expr
;; need to convert to string first
`(,(car field-expr) (format "%s" ,(cadr field-expr)))
kill-ring starts like a DOI, then that is the intial
prompt. Otherwise, you have to type or pste in a DOI."
(interactive
- (list (read-input "DOI: "
+ (list (read-string "DOI: "
;; now set initial input
(cond
;; If region is active and it starts like a doi we want it.
(defun bibtex-set-field (field value &optional nodelim)
- "Set FIELD to VALUE in bibtex file. create field if it does not exist."
+ "Set FIELD to VALUE in bibtex file. create field if it does not exist.
+Optional argument NODELIM see `bibtex-make-field'."
(interactive "sfield: \nsvalue: ")
(bibtex-beginning-of-entry)
(let ((found))
"http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:doi/%s" doi)))
(defun doi-utils-wos-citing (doi)
- "Open Web of Science citing articles entry. May be empty if none are found."
+ "Open Web of Science citing articles entry for DOI.
+May be empty if none are found."
(interactive "sDOI: ")
(browse-url
(concat
"&svc_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Asch_svc&svc.citing=yes")))
(defun doi-utils-wos-related (doi)
- "Open Web of Science related articles page."
+ "Open Web of Science related articles page for DOI."
(interactive "sDOI: ")
(browse-url
(concat "http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info%3Adoi%2F"
(defun doi-utils-open (doi)
+ "Open DOI in browser."
(interactive "sDOI: ")
(browse-url (concat "http://dx.doi.org/" doi)))
(defvar doi-link-menu-funcs '()
- "Functions to run in doi menu. Each entry is a list of (key menu-name function).
-The function must take one argument, the doi.")
+ "Functions to run in doi menu.
+Each entry is a list of (key menu-name function). The function
+must take one argument, the doi.")
(setq doi-link-menu-funcs
'(("o" "pen" doi-utils-open)
(defun doi-link-menu (link-string)
"Generate the link menu message, get choice and execute it.
-Options are stored in `doi-link-menu-funcs'."
+Options are stored in `doi-link-menu-funcs'.
+Argument LINK-STRING Passed in on link click."
(interactive)
(message
(concat
(defun doi-utils-add-entry-from-crossref-query (query bibtex-file)
"Search Crossref with QUERY and use helm to select an entry to add to BIBTEX-FILE."
(interactive (list
- (read-input
+ (read-string
"Query: "
;; now set initial input
(cond
projects / org-ref.git / blobdiff