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
128
129
|
;;; Copyright © 2019 - 2020 Jakob L. Kreuze <zerodaysfordays@sdf.org>
;;;
;;; 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
;;; <http://www.gnu.org/licenses/>.
(define-module (jakob utils sxml)
#:use-module (ice-9 match)
#:use-module (srfi srfi-1)
#:export (hyperlink
image
stylesheet
script
sanitize-subtree
rewrite-absolute-urls-as-relative
flatten-section-headings))
;;;
;;; Utility procedures to aid in writing SXML by hand.
;;;
(define (hyperlink target text)
`(a (@ (href ,target)) ,text))
(define* (image file-name #:optional description)
(let ((src (string-append "/static/image/" file-name)))
(if description
`(img (@ (src ,src) (alt ,description) (title ,description)))
`(img (@ (src ,src))))))
(define (stylesheet file-name)
`(link (@ (rel "stylesheet") (href ,(format #f "/static/css/~a" file-name)))))
(define (script file-name)
(let ((src (string-append "/static/js/" file-name)))
`(script (@ (src ,src)))))
;;;
;;; A reader extension for implicitly-sanitized SXML trees.
;;;
(define (sanitize-subtree subtree)
"Remove `nil', `#f', and any unspecified elements from `sbtree'"
(if (list? subtree)
(map sanitize-subtree (remove (lambda (elt)
(or (unspecified? elt)
(eq? 'nil elt)
(eq? #f elt)))
subtree))
subtree))
(define (sxml-reader chr port)
"Read an SXML literal expression possibly containing unquote forms and
sanitize the resultant subtree."
`(sanitize-subtree ,(cons 'quasiquote (list (read port)))))
;; Install the reader extension when imported.
(read-hash-extend #\< sxml-reader)
(define (rewrite-absolute-urls-as-relative tree)
(match tree
(('a attrs body ...)
(if (assoc 'href (cdr attrs))
(let* ((url (car (assoc-ref (cdr attrs) 'href)))
(url (if (string-prefix? "https://jakob.space" url)
(string-drop url (string-length "https://jakob.space"))
url))
(url (if (string-prefix? "http://jakob.space" url)
(string-drop url (string-length "http://jakob.space"))
url))
(attrs `(@ (href ,url) ,@(filter (match-lambda
(('href _) #f)
(_ #t))
(cdr attrs)))))
`(a ,attrs ,@body))
tree))
((xs ...)
(map rewrite-absolute-urls-as-relative xs))
(elem elem)))
(define (flatten-section-headings tree)
"""Flattens extraneous sections output by Org-mode
This function traverses a SXML tree and removes the outermost `<div>`
elements that represent Org-mode section headings.
Args:
tree: A SXML tree.
Returns:
A SXML tree with the outermost Org section heading `<div>` elements
removed and their contents flattened.
"""
(define (flatten-section-headings-inner tree)
(define (is-org-section form)
(match form
((or ('div ('@ ('id id) ('class _))
rest ...)
('div ('@ ('id id))
rest ...)
('div ('@ ('role "doc-footnote") ('class id))
rest ...))
(or (string=? "footpara" id)
(string-prefix? "text-footnotes" id)
(string-prefix? "outline-container-org" id)
(string-prefix? "text-org" id)))
(_ #f)))
(match tree
((? is-org-section
('div ('@ _ ...)
rest ...))
(append-map flatten-section-headings-inner rest))
((xs ...)
(list (append-map flatten-section-headings-inner xs)))
(elem (list elem))))
(first (flatten-section-headings-inner tree)))
|
