1 ;;; jmax-bibtex.el --- jmax-bibtex utilities
4 ;; Requires: s.el, dash.el, org-ref.el, doi-utils.el
8 (defvar jmax-bibtex-journal-abbreviations
9 '(("ACAT" "ACS Catalysis" "ACS Catal.")
10 ("AM" "Acta Materialia" "Acta Mater.")
11 ("AMM" "Acta Metallurgica et Materialia" "Acta Metall. Mater.")
12 ("AMiner" "American Mineralogist" "Am. Mineral.")
13 ("AngC" "Angewandte Chemie-International Edition" "Angew. Chem. Int. Edit.")
14 ("APLM" "APL Materials" "APL Mat.")
15 ("ACBE" "Applied Catalysis B: Environmental" "Appl. Catal. B-Environ.")
16 ("APL" "Applied Physics Letters" "Appl. Phys. Lett.")
17 ("ASS" "Applied Surface Science" "Appl. Surf. Sci.")
18 ("CL" "Catalysis Letters" "Catal. Lett.")
19 ("CST" "Catalysis Science & Technology" "Catal. Sci. Technol.")
20 ("CT" "Catalysis Today" "Catal. Today")
21 ("CPL" "Chemical Physics Letters" "Chem. Phys. Lett")
22 ("CR" "Chemical Reviews" "Chem. Rev.")
23 ("CSR" "Chemical Society Reviews" "Chem. Soc. Rev.")
24 ("CSR" "Chemical Society Reviews" "Chem. Soc. Rev.")
25 ("CM" "Chemistry of Materials" "Chem. Mater.")
26 ("CSA" "Colloids and Surfaces, A: Physicochemical and Engineering Aspects" "Colloids Surf., A")
27 ("CPMS" "Computational Materials Science" "Comp. Mater. Sci.")
28 ("CPC" "Computer Physics Communications" "Comput. Phys. Commun.")
29 ("CGD" "Crystal Growth \\& Design" "Cryst. Growth Des.")
30 ("CEC" "CrystEngComm" "CrystEngComm")
31 ("ECST" "ECS Transactions" "ECS Trans.")
32 ("EES" "Energy \\& Environmental Science" "Energy Environ. Sci.")
33 ("HPR" "High Pressure Research" "High Pressure Res.")
34 ("IC" "Inorganic Chemistry" "Inorg. Chem.")
35 ("IECR" "Industrial \\& Engineering Chemistry Research" "Ind. Eng. Chem. Res.")
36 ("JJAP" "Japanese Journal of Applied Physics" "Jpn. J. Appl. Phys.")
37 ("JMatR" "Journal of Materials Research" "J. Mater. Res.")
38 ("JALC" "Journal of Alloys and Compounds" "J. Alloy Compd.")
39 ("JAC" "Journal of Applied Crystallography" "J. Appl. Crystallogr.")
40 ("JAP" "Journal of Applied Physics" "J. Appl. Phys.")
41 ("JC" "Journal of Catalysis" "J. Catal.")
42 ("JCP" "Journal of Chemical Physics" "J. Chem. Phys.")
43 ("JCC" "Journal of Computational Chemistry" "J. Comput. Chem.")
44 ("JCG" "Journal of Crystal Growth" "J. Crys. Growth")
45 ("JMC" "Journal of Materials Chemistry" "J. Mater. Chem.")
46 ("JMC" "Journal of Materials Chemistry" "J. Mater. Chem.")
47 ("JMSL" "Journal of Materials Science Letters" "J. Mater. Sci. Lett.")
48 ("JMS" "Journal of Membrane Science" "J. Memb. Sci.")
49 ("JPE" "Journal of Phase Equilibria" "J. Phase Equilib.")
50 ("JPCS" "Journal of Physics and Chemistry of Solids" "J. Phys. Chem. Solids")
51 ("JPCM" "Journal of Physics: Condensed Matter" "J. Phys.: Condens. Matter")
52 ("JSSC" "Journal of Solid State Chemistry" "J. Solid State Chem.")
53 ("JACerS" "Journal of the American Ceramic Society" "J. Am. Ceram. Soc.")
54 ("JACS" "Journal of the American Chemical Society" "J. Am. Chem. Soc.")
55 ("JES" "Journal of The Electrochemical Society" "J. Electrochem. Soc.")
56 ("JEaC" "Journal of Electroanalytical Chemistry" "J. Electroanal. Chem.")
57 ("JMS" "Journal of Membrane Science" "J. Memb. Sci.")
58 ("JVST" "Journal of Vacuum Science \\& Technology A" "J. Vac. Sci. Technol. A")
59 ("ML" "Materials Letters" "Mater. Lett.")
60 ("MSE-BS" "Materials Science and Engineering B" "Mat. Sci. Eng. B-Solid")
61 ("MOLSIM" "Molecular Simulation" "Mol. Sim.")
62 ("Nature" "Nature" "Nature")
63 ("NM" "Nature Materials" "Nat. Mater.")
64 ("PML" "Philosophical Magazine Letters" "Phil. Mag. Lett.")
65 ("PMA" "Philosophical Magazine A" "Phil. Mag. A")
66 ("PA" "Physica A: Statistical Mechanics and its Applications" "Physica A")
67 ("PB" "Physica B-Condensed Matter" "Physica B")
68 ("PCCP" "Physical Chemistry Chemical Physics" "Phys. Chem. Chem. Phys.")
69 ("PSSB" "physica status solidi (b)" "Phys. Status Solidi B")
70 ("PRA" "Physical Review A" "Phys. Rev. A")
71 ("PRB" "Physical Review B" "Phys. Rev. B")
72 ("PRL" "Physical Review Letters" "Phys. Rev. Lett.")
73 ("PCM" "Physics and Chemistry of Minerals" "Phys. Chem. Miner.")
74 ("PSurfSci" "Progress in Surface Science" "Prog. Surf. Sci.")
75 ("Science" "Science" "Science")
76 ("SABC" "Sensors and Actuators B: Chemical" "Sensor. Actuat. B-Chem.")
77 ("SS" "Surface Science" "Surf. Sci.")
78 ("EPJB" "The European Physical Journal B" "Eur. Phys. J. B")
79 ("JPC" "The Journal of Physical Chemistry" "J. Phys. Chem.")
80 ("JPCB" "The Journal of Physical Chemistry B" "J. Phys. Chem. B")
81 ("JPCC" "The Journal of Physical Chemistry C" "J. Phys. Chem. C")
82 ("JPCL" "The Journal of Physical Chemistry Letters" "J. Phys. Chem. Lett.")
83 ("JCP" "The Journal of Chemical Physics" "J. Chem. Phys.")
84 ("MSMSE" "Modelling and Simulation in Materials Science and Engineering" "Modell. Simul. Mater. Sci. Eng.")
85 ("TSF" "Thin Solid Films" "Thin Solid Films")
86 ("TC" "Topics in Catalysis" "Top. Catal.")
87 ("WR" "Water Research" "Water Res."))
88 "List of (string journal-full-name journal-abbreviation). Find abbreviations at http://cassi.cas.org/search.jsp.")
91 (defun jmax-bibtex-generate-longtitles ()
92 "Generate longtitles.bib which are @string definitions.
93 The full journal names are in `jmax-bibtex-journal-abbreviations'."
95 (with-temp-file "longtitles.bib"
96 (dolist (row jmax-bibtex-journal-abbreviations)
97 (insert (format "@string{%s=\"%s\"}\n"
102 (defun jmax-bibtex-generate-shorttitles ()
103 "Generate shorttitles.bib which are @string definitions.
104 The abbreviated journal names in `jmax-bibtex-journal-abbreviations'."
106 (with-temp-file "shorttitles.bib"
107 (dolist (row jmax-bibtex-journal-abbreviations)
108 (insert (format "@string{%s=\"%s\"}\n"
113 (defun jmax-stringify-journal-name (&optional key start end)
114 "Replace journal name in a bibtex entry with a string.
115 The strings are defined in
116 `jmax-bibtex-journal-abbreviations'. The optional arguments KEY,
117 START and END allow you to use this with `bibtex-map-entries'"
119 (bibtex-beginning-of-entry)
123 (cdr (assoc "=type=" (bibtex-parse-entry)))))
124 (let* ((full-names (mapcar
126 (cons (nth 1 row) (nth 0 row)))
127 jmax-bibtex-journal-abbreviations))
128 (abbrev-names (mapcar
130 (cons (nth 2 row) (nth 0 row)))
131 jmax-bibtex-journal-abbreviations))
132 (journal (s-trim (bibtex-autokey-get-field "journal")))
134 (cdr (assoc journal full-names))
135 (cdr (assoc journal abbrev-names)))))
137 (bibtex-set-field "journal" bstring t)
138 (bibtex-fill-entry)))))
140 (defun jmax-set-journal-string (full-journal-name)
141 "Set a bibtex journal name to the string that represents FULL-JOURNAL-NAME.
142 This is defined in `jmax-bibtex-journal-abbreviations'."
149 jmax-bibtex-journal-abbreviations))))
150 ;; construct data alist for the string lookup.
153 (cons (nth 1 x) (nth 0 x)))
154 jmax-bibtex-journal-abbreviations)))
155 (bibtex-set-field "journal" (cdr (assoc full-journal-name alist)) t)
157 (bibtex-clean-entry)))
159 ;; see https://github.com/fxcoudert/tools/blob/master/doi2bib for more replacements
160 (defvar jmax-nonascii-latex-replacements
162 "Cons list of non-ascii characters and their LaTeX representations.")
164 (setq jmax-nonascii-latex-replacements
191 ("δ" . "$\\\\delta$")
196 ("θ" . "$\\\\theta$")
198 ("→" . "$\\\\rightarrow$")
199 ("⇌" . "$\\\\leftrightharpoons$")
200 ("×" . "$\\\\times$")
202 ;; I think these are non-ascii spaces. there seems to be more than one.
213 (defun jmax-replace-nonascii ()
214 "Hook function to replace non-ascii characters in a bibtex entry."
218 (bibtex-narrow-to-entry)
219 (goto-char (point-min))
220 (dolist (char (mapcar (lambda (x) (car x)) jmax-nonascii-latex-replacements))
221 (while (re-search-forward char nil t)
222 (replace-match (cdr (assoc char jmax-nonascii-latex-replacements))))
223 (goto-char (point-min)))))
225 (add-hook 'org-ref-clean-bibtex-entry-hook 'jmax-replace-nonascii)
228 (defvar jmax-lower-case-words
229 '("a" "an" "on" "and" "for"
231 "List of words to keep lowercase when changing case in a title.")
234 (defun jmax-title-case-article (&optional key start end)
235 "Convert a bibtex entry article title to title-case.
236 The arguments KEY, START and END are optional, and are only there
237 so you can use this function with `bibtex-map-entries' to change
238 all the title entries in articles."
240 (bibtex-beginning-of-entry)
242 (let* ((title (bibtex-autokey-get-field "title"))
243 (words (split-string title))
246 (string= "article" (downcase (cdr (assoc "=type=" (bibtex-parse-entry)))))
250 ;; match words containing {} or \ which are probably
251 ;; LaTeX or protected words
252 (string-match "\\$\\|{\\|}\\|\\\\" word)
253 ;; these words should not be capitalized, unless they
254 ;; are the first word
255 (-contains? jmax-lower-case-words (s-downcase word)))
257 (s-capitalize word)))
260 ;; Check if first word should be capitalized
261 (when (-contains? jmax-lower-case-words (car words))
262 (setf (car words) (s-capitalize (car words))))
264 (setq title (mapconcat 'identity words " "))
266 ;; Capitalize letters after a dash
268 (string-match "[a-zA-Z]-\\([a-z]\\)" title start)
269 (let ((char (substring title (match-beginning 1) (match-end 1))))
270 (setf (substring title (match-beginning 1) (match-end 1))
271 (format "%s" (upcase char)))
272 (setq start (match-end 1))))
274 ;; this is defined in doi-utils
278 (bibtex-fill-entry))))
280 (add-hook 'org-ref-clean-bibtex-entry-hook 'jmax-title-case-article)
283 (defun jmax-sentence-case-article (&optional key start end)
284 "Convert a bibtex entry article title to sentence-case.
285 The arguments KEY, START and END are optional, and are only there
286 so you can use this function with `bibtex-map-entries' to change
287 all the title entries in articles."
289 (bibtex-beginning-of-entry)
291 (let* ((title (bibtex-autokey-get-field "title"))
292 (words (split-string title))
295 (string= "article" (downcase (cdr (assoc "=type=" (bibtex-parse-entry)))))
299 ;; match words containing {} or \ which are probably
300 ;; LaTeX or protected words
301 (string-match "\\$\\|{\\|}\\|\\\\" word)
306 ;; capitalize first word
307 (setf (car words) (s-capitalize (car words)))
310 (setq title (mapconcat 'identity words " "))
312 ;; capitalize a word after a :, eg. a subtitle, and protect it
314 (string-match "[a-z]:\\s-+\\([A-Z]\\)" title start)
315 (let ((char (substring title (match-beginning 1) (match-end 1))))
316 (setf (substring title (match-beginning 1) (match-end 1))
317 ;; (format "{%s}" (upcase char)))
318 (format "%s" (upcase char)))
319 (setq start (match-end 1))))
321 ;; this is defined in doi-utils
325 ;; clean and refill entry so it looks nice
327 (bibtex-fill-entry))))
332 (defun jmax-bibtex-next-entry (&optional n)
333 "Jump to the beginning of the next bibtex entry.
334 N is a prefix argument. If it is numeric, jump that many entries
335 forward. Negative numbers do nothing."
337 ;; Note if we start at the beginning of an entry, nothing
338 ;; happens. We need to move forward a char, and call again.
339 (when (= (point) (save-excursion
340 (bibtex-beginning-of-entry)))
342 (jmax-bibtex-next-entry))
344 ;; search forward for an entry
346 (re-search-forward bibtex-entry-head nil t (and (numberp n) n))
347 ;; go to beginning of the entry
348 (bibtex-beginning-of-entry)))
351 (defun jmax-bibtex-previous-entry (&optional n)
352 "Jump to beginning of the previous bibtex entry.
353 N is a prefix argument. If it is numeric, jump that many entries back."
355 (bibtex-beginning-of-entry)
357 (re-search-backward bibtex-entry-head nil t (and (numberp n) n))
358 (bibtex-beginning-of-entry)))
361 (defun jmax-bibtex-mode-keys ()
362 "Modify keymaps used by `bibtex-mode'."
363 (local-set-key (kbd "M-n") 'jmax-bibtex-next-entry)
364 (local-set-key (kbd "M-p") 'jmax-bibtex-previous-entry))
366 ;; add to bibtex-mode-hook
367 (add-hook 'bibtex-mode-hook 'jmax-bibtex-mode-keys)
370 (defun jmax-bibtex-entry-doi ()
371 "get doi from entry at point"
374 (bibtex-beginning-of-entry)
375 (reftex-get-bib-field "doi" (bibtex-parse-entry t))))
378 (defun jmax-bibtex-wos ()
379 "Open bibtex entry in Web Of Science if there is a DOI"
381 (doi-utils-wos (jmax-bibtex-entry-doi)))
384 (defun jmax-bibtex-wos-citing ()
385 "Open citing articles for bibtex entry in Web Of Science if there is a DOI"
387 (doi-utils-wos-citing (jmax-bibtex-entry-doi)))
390 (defun jmax-bibtex-wos-related ()
391 "Open related articles for bibtex entry in Web Of Science if there is a DOI"
393 (doi-utils-wos-related (jmax-bibtex-entry-doi)))
396 (defun jmax-bibtex-wos-citing ()
397 "Open citing articles for bibtex entry in Web Of Science if there is a DOI"
399 (doi-utils-wos-citing (jmax-bibtex-entry-doi)))
402 (defun jmax-bibtex-crossref ()
404 (doi-utils-crossref (jmax-bibtex-entry-doi)))
407 (defun jmax-bibtex-google-scholar ()
409 (doi-utils-google-scholar (jmax-bibtex-entry-doi)))
412 (defun jmax-bibtex-pubmed ()
414 (doi-utils-pubmed (jmax-bibtex-entry-doi)))
417 (defun jmax-bibtex-pdf (doi)
418 "thin wrapper to get `jmax-bibtex' to open pdf"
420 (org-ref-open-bibtex-pdf))
424 (defvar jmax-bibtex-menu-funcs '()
425 "Functions to run in doi menu. Each entry is a list of (key menu-name function).
426 The function must take one argument, the doi.")
428 (setq jmax-bibtex-menu-funcs
429 '(("p" "df" jmax-bibtex-pdf)
430 ("C" "opy" (lambda (doi)
431 (kill-new (org-ref-bib-citation))
433 ("w" "os" doi-utils-wos)
434 ("c" "iting articles" doi-utils-wos-citing)
435 ("r" "elated articles" doi-utils-wos-related)
436 ("s" "Google Scholar" doi-utils-google-scholar)
437 ("P" "Pubmed" doi-utils-pubmed)
438 ("f" "CrossRef" doi-utils-crossref)))
440 (defun jmax-bibtex ()
441 "Menu command to run in a bibtex entry.
442 Functions from `jmax-bibtex-menu-funcs'. They all rely on the
446 ;; construct menu string as a message
451 (concat "[" (elt tup 0) "]"
453 jmax-bibtex-menu-funcs "") ": "))
454 (let* ((input (read-char-exclusive))
456 (char-to-string input) jmax-bibtex-menu-funcs)))
462 (jmax-bibtex-entry-doi)
465 (defalias 'jb 'jmax-bibtex)
467 (provide 'jmax-bibtex)
469 ;;; jmax-bibtex.el ends here