mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-15 10:30:25 -08:00
bc511a64f6
Most of this change is to boilerplate commentary such as license URLs. This change was prompted by ftp://ftp.gnu.org's going-away party, planned for November. Change these FTP URLs to https://ftp.gnu.org instead. Make similar changes for URLs to other organizations moving away from FTP. Also, change HTTP to HTTPS for URLs to gnu.org and fsf.org when this works, as this will further help defend against man-in-the-middle attacks (for this part I omitted the MS-DOS and MS-Windows sources and the test tarballs to keep the workload down). HTTPS is not fully working to lists.gnu.org so I left those URLs alone for now.
226 lines
8.4 KiB
EmacsLisp
226 lines
8.4 KiB
EmacsLisp
;;; ob-latex.el --- Babel Functions for LaTeX -*- lexical-binding: t; -*-
|
|
|
|
;; Copyright (C) 2009-2017 Free Software Foundation, Inc.
|
|
|
|
;; Author: Eric Schulte
|
|
;; Keywords: literate programming, reproducible research
|
|
;; Homepage: http://orgmode.org
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
;; GNU Emacs 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.
|
|
|
|
;; GNU Emacs 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 GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
;;; Commentary:
|
|
|
|
;; Org-Babel support for evaluating LaTeX source code.
|
|
;;
|
|
;; Currently on evaluation this returns raw LaTeX code, unless a :file
|
|
;; header argument is given in which case small png or pdf files will
|
|
;; be created directly form the latex source code.
|
|
|
|
;;; Code:
|
|
(require 'ob)
|
|
|
|
(declare-function org-create-formula-image "org" (string tofile options buffer &optional type))
|
|
(declare-function org-latex-compile "ox-latex" (texfile &optional snippet))
|
|
(declare-function org-latex-guess-inputenc "ox-latex" (header))
|
|
(declare-function org-splice-latex-header "org" (tpl def-pkg pkg snippets-p &optional extra))
|
|
(declare-function org-trim "org" (s &optional keep-lead))
|
|
|
|
(defvar org-babel-tangle-lang-exts)
|
|
(add-to-list 'org-babel-tangle-lang-exts '("latex" . "tex"))
|
|
|
|
(defvar org-format-latex-header) ; From org.el
|
|
(defvar org-format-latex-options) ; From org.el
|
|
(defvar org-latex-default-packages-alist) ; From org.el
|
|
(defvar org-latex-packages-alist) ; From org.el
|
|
|
|
(defvar org-babel-default-header-args:latex
|
|
'((:results . "latex") (:exports . "results"))
|
|
"Default arguments to use when evaluating a LaTeX source block.")
|
|
|
|
(defconst org-babel-header-args:latex
|
|
'((border . :any)
|
|
(fit . :any)
|
|
(imagemagick . ((nil t)))
|
|
(iminoptions . :any)
|
|
(imoutoptions . :any)
|
|
(packages . :any)
|
|
(pdfheight . :any)
|
|
(pdfpng . :any)
|
|
(pdfwidth . :any)
|
|
(headers . :any)
|
|
(packages . :any)
|
|
(buffer . ((yes no))))
|
|
"LaTeX-specific header arguments.")
|
|
|
|
(defcustom org-babel-latex-htlatex "htlatex"
|
|
"The htlatex command to enable conversion of latex to SVG or HTML."
|
|
:group 'org-babel
|
|
:type 'string)
|
|
|
|
(defcustom org-babel-latex-htlatex-packages
|
|
'("[usenames]{color}" "{tikz}" "{color}" "{listings}" "{amsmath}")
|
|
"Packages to use for htlatex export."
|
|
:group 'org-babel
|
|
:type '(repeat (string)))
|
|
|
|
(defun org-babel-expand-body:latex (body params)
|
|
"Expand BODY according to PARAMS, return the expanded body."
|
|
(mapc (lambda (pair) ;; replace variables
|
|
(setq body
|
|
(replace-regexp-in-string
|
|
(regexp-quote (format "%S" (car pair)))
|
|
(if (stringp (cdr pair))
|
|
(cdr pair) (format "%S" (cdr pair)))
|
|
body))) (org-babel--get-vars params))
|
|
(org-trim body))
|
|
|
|
(defun org-babel-execute:latex (body params)
|
|
"Execute a block of Latex code with Babel.
|
|
This function is called by `org-babel-execute-src-block'."
|
|
(setq body (org-babel-expand-body:latex body params))
|
|
(if (cdr (assq :file params))
|
|
(let* ((out-file (cdr (assq :file params)))
|
|
(extension (file-name-extension out-file))
|
|
(tex-file (org-babel-temp-file "latex-" ".tex"))
|
|
(border (cdr (assq :border params)))
|
|
(imagemagick (cdr (assq :imagemagick params)))
|
|
(im-in-options (cdr (assq :iminoptions params)))
|
|
(im-out-options (cdr (assq :imoutoptions params)))
|
|
(fit (or (cdr (assq :fit params)) border))
|
|
(height (and fit (cdr (assq :pdfheight params))))
|
|
(width (and fit (cdr (assq :pdfwidth params))))
|
|
(headers (cdr (assq :headers params)))
|
|
(in-buffer (not (string= "no" (cdr (assq :buffer params)))))
|
|
(org-latex-packages-alist
|
|
(append (cdr (assq :packages params)) org-latex-packages-alist)))
|
|
(cond
|
|
((and (string-suffix-p ".png" out-file) (not imagemagick))
|
|
(org-create-formula-image
|
|
body out-file org-format-latex-options in-buffer))
|
|
((string-suffix-p ".tikz" out-file)
|
|
(when (file-exists-p out-file) (delete-file out-file))
|
|
(with-temp-file out-file
|
|
(insert body)))
|
|
((and (or (string= "svg" extension)
|
|
(string= "html" extension))
|
|
(executable-find org-babel-latex-htlatex))
|
|
;; TODO: this is a very different way of generating the
|
|
;; frame latex document than in the pdf case. Ideally, both
|
|
;; would be unified. This would prevent bugs creeping in
|
|
;; such as the one fixed on Aug 16 2014 whereby :headers was
|
|
;; not included in the SVG/HTML case.
|
|
(with-temp-file tex-file
|
|
(insert (concat
|
|
"\\documentclass[preview]{standalone}
|
|
\\def\\pgfsysdriver{pgfsys-tex4ht.def}
|
|
"
|
|
(mapconcat (lambda (pkg)
|
|
(concat "\\usepackage" pkg))
|
|
org-babel-latex-htlatex-packages
|
|
"\n")
|
|
(if headers
|
|
(concat "\n"
|
|
(if (listp headers)
|
|
(mapconcat #'identity headers "\n")
|
|
headers) "\n")
|
|
"")
|
|
"\\begin{document}"
|
|
body
|
|
"\\end{document}")))
|
|
(when (file-exists-p out-file) (delete-file out-file))
|
|
(let ((default-directory (file-name-directory tex-file)))
|
|
(shell-command (format "%s %s" org-babel-latex-htlatex tex-file)))
|
|
(cond
|
|
((file-exists-p (concat (file-name-sans-extension tex-file) "-1.svg"))
|
|
(if (string-suffix-p ".svg" out-file)
|
|
(progn
|
|
(shell-command "pwd")
|
|
(shell-command (format "mv %s %s"
|
|
(concat (file-name-sans-extension tex-file) "-1.svg")
|
|
out-file)))
|
|
(error "SVG file produced but HTML file requested")))
|
|
((file-exists-p (concat (file-name-sans-extension tex-file) ".html"))
|
|
(if (string-suffix-p ".html" out-file)
|
|
(shell-command "mv %s %s"
|
|
(concat (file-name-sans-extension tex-file)
|
|
".html")
|
|
out-file)
|
|
(error "HTML file produced but SVG file requested")))))
|
|
((or (string= "pdf" extension) imagemagick)
|
|
(with-temp-file tex-file
|
|
(require 'ox-latex)
|
|
(insert
|
|
(org-latex-guess-inputenc
|
|
(org-splice-latex-header
|
|
org-format-latex-header
|
|
(delq
|
|
nil
|
|
(mapcar
|
|
(lambda (el)
|
|
(unless (and (listp el) (string= "hyperref" (cadr el)))
|
|
el))
|
|
org-latex-default-packages-alist))
|
|
org-latex-packages-alist
|
|
nil))
|
|
(if fit "\n\\usepackage[active, tightpage]{preview}\n" "")
|
|
(if border (format "\\setlength{\\PreviewBorder}{%s}" border) "")
|
|
(if height (concat "\n" (format "\\pdfpageheight %s" height)) "")
|
|
(if width (concat "\n" (format "\\pdfpagewidth %s" width)) "")
|
|
(if headers
|
|
(concat "\n"
|
|
(if (listp headers)
|
|
(mapconcat #'identity headers "\n")
|
|
headers) "\n")
|
|
"")
|
|
(if fit
|
|
(concat "\n\\begin{document}\n\\begin{preview}\n" body
|
|
"\n\\end{preview}\n\\end{document}\n")
|
|
(concat "\n\\begin{document}\n" body "\n\\end{document}\n"))))
|
|
(when (file-exists-p out-file) (delete-file out-file))
|
|
(let ((transient-pdf-file (org-babel-latex-tex-to-pdf tex-file)))
|
|
(cond
|
|
((string= "pdf" extension)
|
|
(rename-file transient-pdf-file out-file))
|
|
(imagemagick
|
|
(org-babel-latex-convert-pdf
|
|
transient-pdf-file out-file im-in-options im-out-options)
|
|
(when (file-exists-p transient-pdf-file)
|
|
(delete-file transient-pdf-file)))
|
|
(t
|
|
(error "Can not create %s files, please specify a .png or .pdf file or try the :imagemagick header argument"
|
|
extension))))))
|
|
nil) ;; signal that output has already been written to file
|
|
body))
|
|
|
|
(defun org-babel-latex-convert-pdf (pdffile out-file im-in-options im-out-options)
|
|
"Generate a file from a pdf file using imagemagick."
|
|
(let ((cmd (concat "convert " im-in-options " " pdffile " "
|
|
im-out-options " " out-file)))
|
|
(message "Converting pdffile file %s..." cmd)
|
|
(shell-command cmd)))
|
|
|
|
(defun org-babel-latex-tex-to-pdf (file)
|
|
"Generate a pdf file according to the contents FILE."
|
|
(require 'ox-latex)
|
|
(org-latex-compile file))
|
|
|
|
(defun org-babel-prep-session:latex (_session _params)
|
|
"Return an error because LaTeX doesn't support sessions."
|
|
(error "LaTeX does not support sessions"))
|
|
|
|
|
|
(provide 'ob-latex)
|
|
;;; ob-latex.el ends here
|