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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
;;; org-export-config.el --- Org Export Configuration -*- lexical-binding: t; coding: utf-8; -*-
;; author: Craig Jennings <c@cjennings.net>
;;
;;; Commentary:
;; This module configures Org mode's export capabilities, providing multiple
;; backend options for converting Org documents to various formats.
;;
;; Built-in backends configured:
;; - LaTeX/PDF: Academic documents and presentations
;; - HTML: Web publishing with HTML5 support
;; - Markdown: README files and web content
;; - ODT: Office documents for LibreOffice/MS Word
;; - Texinfo: GNU documentation and Info files
;;
;; Extended via Pandoc:
;; - Additional formats: DOCX, EPUB, reveal.js presentations
;; - Self-contained HTML exports with embedded resources
;; - Custom PDF export with Zathura integration
;;
;; Key features:
;; - UTF-8 encoding enforced across all backends
;; - Subtree export as default scope
;; - reveal.js presentations with CDN or local embedding options
;;
;;; Code:
;; --------------------------------- Org Export --------------------------------
(use-package ox
:defer .5
:ensure nil
:after org
:config
;; load the built-in backends
(dolist (feat '(ox-odt ox-latex ox-md ox-ascii))
(require feat))
;; now tell Org exactly which backends to use
(setq org-export-backends '(odt latex md ascii))
;; Other Settings
(setq org-export-preserve-breaks t) ;; keep line breaks in all Org export back-ends
(setq org-export-coding-system 'utf-8) ;; force utf-8 in org
(setq org-export-headline-levels 6) ;; export headlines 6 levels deep
(setq org-export-with-section-numbers nil) ;; export without section numbers by default
(setq org-export-with-tags nil) ;; export without tags by default
(setq org-export-with-tasks '("TODO")) ;; export with tasks by default
(setq org-export-with-tasks nil) ;; export WITHOUT tasks by default
(setq org-export-with-toc t) ;; export WITH table of contents by default
(setq org-export-initial-scope 'subtree) ;; 'buffer is your other choice
(setq org-export-with-author nil)) ;; export without author by default
(use-package ox-html
:ensure nil ; Built into Org
:defer t
:after ox
:config
(setq org-html-postamble nil)
(setq org-html-html5-fancy t)
(setq org-html-head-include-default-style nil))
(use-package ox-texinfo
:ensure nil ; Built into Org
:defer t
:after ox
:config
(setq org-texinfo-coding-system 'utf-8)
(setq org-texinfo-default-class "info")
(add-to-list 'org-export-backends 'texinfo))
(use-package ox-pandoc
:defer t
:after ox
:config
;; Set default options for pandoc
(setq org-pandoc-options '((standalone . t)
(mathjax . t)))
;; Configure reveal.js specific options
(setq org-pandoc-options-for-revealjs
'((standalone . t)
(variable . "revealjs-url=https://cdn.jsdelivr.net/npm/reveal.js")
(variable . "theme=black") ; or white, league, beige, sky, night, serif, simple, solarized
(variable . "transition=slide") ; none, fade, slide, convex, concave, zoom
(variable . "slideNumber=true")
(variable . "hash=true")
(self-contained . t))) ; This embeds CSS/JS when possible
;; Custom function for self-contained reveal.js export
(defun my/org-pandoc-export-to-revealjs-standalone ()
"Export to reveal.js with embedded dependencies."
(interactive)
(let* ((org-pandoc-options-for-revealjs
(append org-pandoc-options-for-revealjs
'((self-contained . t)
(embed-resources . t)))) ; pandoc 3.0+ option
(html-file (org-pandoc-export-to-revealjs)))
(when html-file
(browse-url-of-file html-file)
(message "Opened reveal.js presentation: %s" html-file))))
;; Alternative: Download and embed local reveal.js
(defun my/org-pandoc-export-to-revealjs-local ()
"Export to reveal.js using local copy of reveal.js."
(interactive)
(let* ((reveal-dir (expand-file-name "reveal.js" user-emacs-directory))
(org-pandoc-options-for-revealjs
`((standalone . t)
(variable . ,(format "revealjs-url=%s" reveal-dir))
(variable . "theme=black")
(variable . "transition=slide")
(variable . "slideNumber=true"))))
(unless (file-exists-p reveal-dir)
(message "Downloading reveal.js...")
(shell-command
(format "git clone https://github.com/hakimel/reveal.js.git %s" reveal-dir)))
(org-pandoc-export-to-revealjs)))
;; Configure specific format options (your existing config)
(setq org-pandoc-options-for-latex-pdf '((pdf-engine . "pdflatex")))
(setq org-pandoc-options-for-html5 '((html-q-tags . t)
(self-contained . t)))
(setq org-pandoc-options-for-markdown '((atx-headers . t)))
;; Custom function to export to PDF and open with Zathura
(defun my/org-pandoc-export-to-pdf-and-open ()
"Export to PDF via pandoc and open with Zathura."
(interactive)
(let ((pdf-file (org-pandoc-export-to-latex-pdf)))
(when pdf-file
(start-process "zathura-pdf" nil "zathura" pdf-file)
(message "Opened %s in Zathura" pdf-file))))
;; Updated menu entries with reveal.js options
(setq org-pandoc-menu-entry
'((?4 "to html5 and open" org-pandoc-export-to-html5-and-open)
(?$ "as html5" org-pandoc-export-as-html5)
(?r "to reveal.js (CDN) and open" org-pandoc-export-to-revealjs-and-open)
(?R "to reveal.js (self-contained)" my/org-pandoc-export-to-revealjs-standalone)
(?< "to markdown" org-pandoc-export-to-markdown)
(?d "to docx and open" org-pandoc-export-to-docx-and-open)
(?z "to pdf and open (Zathura)" my/org-pandoc-export-to-pdf-and-open))))
;; hugo markdown
;; (use-package ox-hugo
;; :after ox)
;; github flavored markdown
;; (use-package ox-gfm
;; :after ox)
;; JIRA markup
;; (use-package ox-jira
;; :after ox)
;; Confluence Wiki markup
;; (use-package ox-confluence
;; :after ox)
(provide 'org-export-config)
;;; org-export-config.el ends here.
|
