changing repositories

1 files changed, 162 insertions, 0 deletions

diff --git a/modules/org-export-config.el b/modules/org-export-config.el
new file mode 100644
index 00000000..43329cc3
--- /dev/null
+++ b/modules/org-export-config.el
@@ -0,0 +1,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.