blob: 73b4a6a9ce6e4a7b70cb1421355d4aff80accfc0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
;;; jao-pdf.el --- utilities for pdf files -*- lexical-binding: t; -*-
;; Copyright (C) 2022, 2025, 2026 jao
;; Author: jao <mail@jao.io>
;; Keywords: docs
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;; Some niceties for PDFs:
;;
;; - Using mutools, we can extract the outline of PDFs, and tell back the
;; section title of a given page.
;; - Interoperability with zathura.
(require 'jao-doc-session)
(require 'browse-url)
;;; PDF info
(declare-function 'pdf-info-outline "pdf-info")
(defvar jao-pdf-org-dir nil)
(defvar-local jao-pdf--outline nil)
(defun jao-pdf-is-pdf-file (file)
"Simply checks the FILE extension."
(string-match-p ".*\\.pdf$" file))
(defun jao-pdf-title-to-file-name (title)
"Convert a title, possibly with embedded spaces, to a PDF filename."
(concat (mapconcat 'downcase (split-string title nil t) "-") ".pdf"))
(defun jao-pdf-title (&optional fname)
(if (or fname (not (derived-mode-p 'doc-view-mode 'pdf-view-mode)))
(let ((base (file-name-base (or fname (buffer-file-name)))))
(capitalize (replace-regexp-in-string "-" " " base)))
(or (jao-pdf-section-title)
(when buffer-file-name (jao-pdf-title buffer-file-name)))))
(defvar-local jao-pdf--outline nil)
(defun jao-pdf-section-title (&optional page file-name)
(when (not jao-pdf--outline)
(setq-local jao-pdf--outline (doc-view--pdf-outline file-name)))
(let ((page (or page
(and (derived-mode-p 'doc-view-mode) (doc-view-current-page))
(and (fboundp 'pdf-view-current-page) (pdf-view-current-page))))
(outline jao-pdf--outline)
(cur-page 0)
(cur-title (jao-pdf-title (or file-name buffer-file-name "title"))))
(while (and (car outline) page (< cur-page page))
(setq cur-page (cdr (assoc 'page (car outline))))
(when (<= cur-page page)
(setq cur-title (cdr (assoc 'title (car outline)))))
(setq outline (cdr outline)))
(replace-regexp-in-string "[[:blank:]]+" " " cur-title)))
;;; zathura interop
(defun jao-pdf-zathura-open-cmd (file page &optional suffix)
(let ((page (if page (format "-P %s" page) "")))
(format "zathura %s %s %s" file page (or suffix ""))))
(defun jao-pdf-zathura-title-rx (file)
(concat (file-name-nondirectory file) " \\[.+\\]"))
;; e.g. "~/org/doc/write-yourself-a-scheme-in-48-hours.pdf [96 (96/138)]"
(defun jao-pdf-zathura-file-info (title)
(when (string-match "\\(.+\\) \\[\\(.+\\) (\\([0-9]+\\)/\\([0-9]+\\))\\]"
title)
(list (expand-file-name (match-string 1 title))
(string-to-number (match-string 3 title))
(string-to-number (match-string 4 title))
(match-string 2 title))))
(defun jao-pdf--zathura-link (info)
(when-let* ((file (car info))
(page (cadr info))
(no (or (car (last info)) page))
(fn (file-name-nondirectory file))
(lnk (format "doc:%s::%s" fn page))
(desc (format "%s (p. %s)" (jao-pdf-section-title page file) no)))
(org-link-make-string lnk desc)))
(defun jao-pdf-zathura-org-link (title)
(jao-pdf--zathura-link (jao-pdf-zathura-file-info title)))
;;; Open doc functions
(defvar jao-pdf-open-in-emacs t)
(defun jao-open-doc (&optional file page height)
(interactive)
(when-let* ((file (or file
(read-file-name "Document: "
(concat jao-pdf-org-dir "/doc/")))))
(funcall jao-open-doc-fun file page height)))
;;; doc:// links for browse-url
(defun jao-open-doc-url (url &rest _)
(when (string-match "doc://\\([^?]+\\)\\(\\?.*\\)?" url)
(let ((file (match-string 1 url))
(page (when-let* ((qs (match-string 2 url))
(long (> (length qs) 1))
(ps (url-parse-query-string (substring qs 1)))
(pn (cadr (assoc "page" ps))))
(string-to-number pn))))
(jao-open-doc (expand-file-name (concat "doc/" file) jao-org-dir) page))))
(add-to-list 'browse-url-handlers (cons "^doc://.+" 'jao-open-doc-url))
(provide 'jao-pdf)
;;; jao-pdf.el ends here
|
