mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-11 09:20:51 +00:00
5ace2fe5ec
* org.el (org-mode): Make dependence stuff work more reliably. (org-update-parent-todo-statistics): Fix bug with updating statistics cookie. (org-yank-adjusted-subtrees, org-return-follows-link) (org-use-fast-todo-selection, org-tags-column): New default setting for variables. * org-export-latex.el (org-export-latex-emphasis-alist): Use = and ~ as verbatim delimiters, to avoid table bug. (org-export-latex-classes): Remove the a4paper option from the default styles. * org-exp.el (org-export-html-format-image): New argument PAR-OPEN, to fix XHTM validation bug. (org-export-as-html): Pass par-open to `org-export-html-format-image'. (org-export-html-footnotes-section): Use a more consistent id for footnotes. * org-agenda.el (org-agenda-sorting-strategy) (org-agenda-tags-column): New default setting for variables, based on a poll what typical uses use. (org-agenda-dim-blocked-tasks): Keep dimming blocked entries from setting the blocked tag.
1613 lines
55 KiB
EmacsLisp
1613 lines
55 KiB
EmacsLisp
;;; org-export-latex.el --- LaTeX exporter for org-mode
|
|
;;
|
|
;; Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
|
|
;;
|
|
;; Emacs Lisp Archive Entry
|
|
;; Filename: org-export-latex.el
|
|
;; Version: 6.21b
|
|
;; Author: Bastien Guerry <bzg AT altern DOT org>
|
|
;; Maintainer: Bastien Guerry <bzg AT altern DOT org>
|
|
;; Keywords: org, wp, tex
|
|
;; Description: Converts an org-mode buffer into LaTeX
|
|
;; URL: http://www.cognition.ens.fr/~guerry/u/org-export-latex.el
|
|
|
|
;; 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 <http://www.gnu.org/licenses/>.
|
|
|
|
;;; Commentary:
|
|
;;
|
|
;; This library implements a LaTeX exporter for org-mode.
|
|
;;
|
|
;; Put this file into your load-path and the following into your ~/.emacs:
|
|
;; (require 'org-export-latex)
|
|
;;
|
|
;; The interactive functions are similar to those of the HTML exporter:
|
|
;;
|
|
;; M-x `org-export-as-latex'
|
|
;; M-x `org-export-as-pdf'
|
|
;; M-x `org-export-as-pdf-and-open'
|
|
;; M-x `org-export-as-latex-batch'
|
|
;; M-x `org-export-as-latex-to-buffer'
|
|
;; M-x `org-export-region-as-latex'
|
|
;; M-x `org-replace-region-by-latex'
|
|
;;
|
|
;;; Code:
|
|
|
|
(eval-when-compile
|
|
(require 'cl))
|
|
|
|
(require 'footnote)
|
|
(require 'org)
|
|
(require 'org-exp)
|
|
|
|
;;; Variables:
|
|
(defvar org-export-latex-class nil)
|
|
(defvar org-export-latex-header nil)
|
|
(defvar org-export-latex-append-header nil)
|
|
(defvar org-export-latex-options-plist nil)
|
|
(defvar org-export-latex-todo-keywords-1 nil)
|
|
(defvar org-export-latex-all-targets-re nil)
|
|
(defvar org-export-latex-add-level 0)
|
|
(defvar org-export-latex-sectioning "")
|
|
(defvar org-export-latex-sectioning-depth 0)
|
|
(defvar org-export-latex-special-keyword-regexp
|
|
(concat "\\<\\(" org-scheduled-string "\\|"
|
|
org-deadline-string "\\|"
|
|
org-closed-string"\\)")
|
|
"Regexp matching special time planning keywords plus the time after it.")
|
|
|
|
(defvar latexp) ; dynamically scoped from org.el
|
|
(defvar re-quote) ; dynamically scoped from org.el
|
|
(defvar commentsp) ; dynamically scoped from org.el
|
|
|
|
;;; User variables:
|
|
|
|
(defgroup org-export-latex nil
|
|
"Options for exporting Org-mode files to LaTeX."
|
|
:tag "Org Export LaTeX"
|
|
:group 'org-export)
|
|
|
|
(defcustom org-export-latex-default-class "article"
|
|
"The default LaTeX class."
|
|
:group 'org-export-latex
|
|
:type '(string :tag "LaTeX class"))
|
|
|
|
(defcustom org-export-latex-classes
|
|
'(("article"
|
|
"\\documentclass[11pt]{article}
|
|
\\usepackage[utf8]{inputenc}
|
|
\\usepackage[T1]{fontenc}
|
|
\\usepackage{graphicx}
|
|
\\usepackage{longtable}
|
|
\\usepackage{hyperref}"
|
|
("\\section{%s}" . "\\section*{%s}")
|
|
("\\subsection{%s}" . "\\subsection*{%s}")
|
|
("\\subsubsection{%s}" . "\\subsubsection*{%s}")
|
|
("\\paragraph{%s}" . "\\paragraph*{%s}")
|
|
("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
|
|
("report"
|
|
"\\documentclass[11pt]{report}
|
|
\\usepackage[utf8]{inputenc}
|
|
\\usepackage[T1]{fontenc}
|
|
\\usepackage{graphicx}
|
|
\\usepackage{longtable}
|
|
\\usepackage{hyperref}"
|
|
("\\part{%s}" . "\\part*{%s}")
|
|
("\\chapter{%s}" . "\\chapter*{%s}")
|
|
("\\section{%s}" . "\\section*{%s}")
|
|
("\\subsection{%s}" . "\\subsection*{%s}")
|
|
("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
|
|
("book"
|
|
"\\documentclass[11pt]{book}
|
|
\\usepackage[utf8]{inputenc}
|
|
\\usepackage[T1]{fontenc}
|
|
\\usepackage{graphicx}
|
|
\\usepackage{longtable}
|
|
\\usepackage{hyperref}"
|
|
("\\part{%s}" . "\\part*{%s}")
|
|
("\\chapter{%s}" . "\\chapter*{%s}")
|
|
("\\section{%s}" . "\\section*{%s}")
|
|
("\\subsection{%s}" . "\\subsection*{%s}")
|
|
("\\subsubsection{%s}" . "\\subsubsection*{%s}")))
|
|
"Alist of LaTeX classes and associated header and structure.
|
|
If #+LaTeX_CLASS is set in the buffer, use its value and the
|
|
associated information. Here is the structure of each cell:
|
|
|
|
\(class-name
|
|
header-string
|
|
(numbered-section . unnumbered-section\)
|
|
...\)
|
|
|
|
A %s formatter is mandatory in each section string and will be
|
|
replaced by the title of the section.
|
|
|
|
Instead of a cons cell (numbered . unnumbered), you can also provide a list
|
|
of 2-4 elements,
|
|
|
|
(numbered-open numbered-close)
|
|
|
|
or
|
|
|
|
(numbered-open numbered-close unnumbered-open unnumbered-close)
|
|
|
|
providing opening and closing strings for an environment that should
|
|
represent the document section. The opening clause should have a %s
|
|
to represent the section title."
|
|
:group 'org-export-latex
|
|
:type '(repeat
|
|
(list (string :tag "LaTeX class")
|
|
(string :tag "LaTeX header")
|
|
(repeat :tag "Levels" :inline t
|
|
(choice
|
|
(cons :tag "Heading"
|
|
(string :tag "numbered")
|
|
(string :tag "unnumbered)"))
|
|
(list :tag "Environment"
|
|
(string :tag "Opening (numbered) ")
|
|
(string :tag "Closing (numbered) ")
|
|
(string :tag "Opening (unnumbered)")
|
|
(string :tag "Closing (unnumbered)")))))))
|
|
|
|
(defcustom org-export-latex-emphasis-alist
|
|
'(("*" "\\textbf{%s}" nil)
|
|
("/" "\\emph{%s}" nil)
|
|
("_" "\\underline{%s}" nil)
|
|
("+" "\\texttt{%s}" nil)
|
|
("=" "\\verb=%s=" nil)
|
|
("~" "\\verb~%s~" t))
|
|
"Alist of LaTeX expressions to convert emphasis fontifiers.
|
|
Each element of the list is a list of three elements.
|
|
The first element is the character used as a marker for fontification.
|
|
The second element is a formatting string to wrap fontified text with.
|
|
The third element decides whether to protect converted text from other
|
|
conversions."
|
|
:group 'org-export-latex
|
|
:type 'alist)
|
|
|
|
(defcustom org-export-latex-title-command "\\maketitle"
|
|
"The command used to insert the title just after \\begin{document}.
|
|
If this string contains the formatting specification \"%s\" then
|
|
it will be used as a formatting string, passing the title as an
|
|
argument."
|
|
:group 'org-export-latex
|
|
:type 'string)
|
|
|
|
(defcustom org-export-latex-date-format
|
|
"%d %B %Y"
|
|
"Format string for \\date{...}."
|
|
:group 'org-export-latex
|
|
:type 'string)
|
|
|
|
(defcustom org-export-latex-tables-verbatim nil
|
|
"When non-nil, tables are exported verbatim."
|
|
:group 'org-export-latex
|
|
:type 'boolean)
|
|
|
|
(defcustom org-export-latex-tables-column-borders nil
|
|
"When non-nil, group of columns are surrounded with borders."
|
|
:group 'org-export-latex
|
|
:type 'boolean)
|
|
|
|
(defcustom org-export-latex-packages-alist nil
|
|
"Alist of packages to be inserted in the header.
|
|
Each cell is of the forma \( \"option\" . \"package\" \)."
|
|
:group 'org-export-latex
|
|
:type 'alist)
|
|
|
|
(defcustom org-export-latex-low-levels 'description
|
|
"How to convert sections below the current level of sectioning.
|
|
This is specified by the `org-export-headline-levels' option or the
|
|
value of \"H:\" in Org's #+OPTION line.
|
|
|
|
This can be either nil (skip the sections), 'description (convert
|
|
the sections as descriptive lists) or a string to be used instead
|
|
of \\section{%s}. In this latter case, the %s stands here for the
|
|
inserted headline and is mandatory."
|
|
:group 'org-export-latex
|
|
:type '(choice (const :tag "Ignore" nil)
|
|
(symbol :tag "Convert as descriptive list" description)
|
|
(string :tag "Use a section string" :value "\\subparagraph{%s}")))
|
|
|
|
(defcustom org-export-latex-list-parameters
|
|
'(:cbon "\\texttt{[ ]}" :cboff "\\texttt{[ ]}")
|
|
"Parameters for the LaTeX list exporter.
|
|
These parameters will be passed on to `org-list-to-latex', which in turn
|
|
will pass them (combined with the LaTeX default list parameters) to
|
|
`org-list-to-generic'."
|
|
:group 'org-export-latex
|
|
:type 'plist)
|
|
|
|
(defcustom org-export-latex-remove-from-headlines
|
|
'(:todo nil :priority nil :tags nil)
|
|
"A plist of keywords to remove from headlines. OBSOLETE.
|
|
Non-nil means remove this keyword type from the headline.
|
|
|
|
Don't remove the keys, just change their values.
|
|
|
|
Obsolete, this variable is no longer used. Use the separate
|
|
variables `org-export-with-todo-keywords', `org-export-with-priority',
|
|
and `org-export-with-tags' instead."
|
|
:type 'plist
|
|
:group 'org-export-latex)
|
|
|
|
(defcustom org-export-latex-image-default-option "width=10em"
|
|
"Default option for images."
|
|
:group 'org-export-latex
|
|
:type 'string)
|
|
|
|
(defcustom org-export-latex-inline-image-extensions
|
|
'("pdf" "jpeg" "jpg" "png")
|
|
"Extensions of image files that can be inlined into LaTeX.
|
|
Note that this depends on the way the LaTeX file is processed.
|
|
The default setting (pdf and jpg) assumes that pdflatex is doing the
|
|
processing. If you are using latex and dvips or something similar,
|
|
only postscript files can be included."
|
|
:group 'org-export-html
|
|
:type '(repeat (string :tag "Extension")))
|
|
|
|
(defcustom org-export-latex-coding-system nil
|
|
"Coding system for the exported LaTex file."
|
|
:group 'org-export-latex
|
|
:type 'coding-system)
|
|
|
|
(defgroup org-export-pdf nil
|
|
"Options for exporting Org-mode files to PDF, via LaTeX."
|
|
:tag "Org Export LaTeX"
|
|
:group 'org-export-latex
|
|
:group 'org-export)
|
|
|
|
(defcustom org-export-pdf-remove-logfiles t
|
|
"Non-nil means, remove the logfiles produced by PDF production.
|
|
These are the .aux, .log, .out, and .toc files."
|
|
:group 'org-export-latex
|
|
:type 'boolean)
|
|
|
|
;;; Autoload functions:
|
|
|
|
;;;###autoload
|
|
(defun org-export-as-latex-batch ()
|
|
"Call `org-export-as-latex', may be used in batch processing.
|
|
For example:
|
|
|
|
emacs --batch
|
|
--load=$HOME/lib/emacs/org.el
|
|
--eval \"(setq org-export-headline-levels 2)\"
|
|
--visit=MyFile --funcall org-export-as-latex-batch"
|
|
(org-export-as-latex org-export-headline-levels 'hidden))
|
|
|
|
;;;###autoload
|
|
(defun org-export-as-latex-to-buffer (arg)
|
|
"Call `org-export-as-latex` with output to a temporary buffer.
|
|
No file is created. The prefix ARG is passed through to `org-export-as-latex'."
|
|
(interactive "P")
|
|
(org-export-as-latex arg nil nil "*Org LaTeX Export*")
|
|
(switch-to-buffer-other-window "*Org LaTeX Export*"))
|
|
|
|
;;;###autoload
|
|
(defun org-replace-region-by-latex (beg end)
|
|
"Replace the region from BEG to END with its LaTeX export.
|
|
It assumes the region has `org-mode' syntax, and then convert it to
|
|
LaTeX. This can be used in any buffer. For example, you could
|
|
write an itemized list in `org-mode' syntax in an LaTeX buffer and
|
|
then use this command to convert it."
|
|
(interactive "r")
|
|
(let (reg latex buf)
|
|
(save-window-excursion
|
|
(if (org-mode-p)
|
|
(setq latex (org-export-region-as-latex
|
|
beg end t 'string))
|
|
(setq reg (buffer-substring beg end)
|
|
buf (get-buffer-create "*Org tmp*"))
|
|
(save-excursion
|
|
(set-buffer buf)
|
|
(erase-buffer)
|
|
(insert reg)
|
|
(org-mode)
|
|
(setq latex (org-export-region-as-latex
|
|
(point-min) (point-max) t 'string)))
|
|
(kill-buffer buf)))
|
|
(delete-region beg end)
|
|
(insert latex)))
|
|
|
|
;;;###autoload
|
|
(defun org-export-region-as-latex (beg end &optional body-only buffer)
|
|
"Convert region from BEG to END in `org-mode' buffer to LaTeX.
|
|
If prefix arg BODY-ONLY is set, omit file header, footer, and table of
|
|
contents, and only produce the region of converted text, useful for
|
|
cut-and-paste operations.
|
|
If BUFFER is a buffer or a string, use/create that buffer as a target
|
|
of the converted LaTeX. If BUFFER is the symbol `string', return the
|
|
produced LaTeX as a string and leave not buffer behind. For example,
|
|
a Lisp program could call this function in the following way:
|
|
|
|
(setq latex (org-export-region-as-latex beg end t 'string))
|
|
|
|
When called interactively, the output buffer is selected, and shown
|
|
in a window. A non-interactive call will only retunr the buffer."
|
|
(interactive "r\nP")
|
|
(when (interactive-p)
|
|
(setq buffer "*Org LaTeX Export*"))
|
|
(let ((transient-mark-mode t) (zmacs-regions t)
|
|
rtn)
|
|
(goto-char end)
|
|
(set-mark (point)) ;; to activate the region
|
|
(goto-char beg)
|
|
(setq rtn (org-export-as-latex
|
|
nil nil nil
|
|
buffer body-only))
|
|
(if (fboundp 'deactivate-mark) (deactivate-mark))
|
|
(if (and (interactive-p) (bufferp rtn))
|
|
(switch-to-buffer-other-window rtn)
|
|
rtn)))
|
|
|
|
;;;###autoload
|
|
(defun org-export-as-latex (arg &optional hidden ext-plist
|
|
to-buffer body-only pub-dir)
|
|
"Export current buffer to a LaTeX file.
|
|
If there is an active region, export only the region. The prefix
|
|
ARG specifies how many levels of the outline should become
|
|
headlines. The default is 3. Lower levels will be exported
|
|
depending on `org-export-latex-low-levels'. The default is to
|
|
convert them as description lists. When HIDDEN is non-nil, don't
|
|
display the LaTeX buffer. EXT-PLIST is a property list with
|
|
external parameters overriding org-mode's default settings, but
|
|
still inferior to file-local settings. When TO-BUFFER is
|
|
non-nil, create a buffer with that name and export to that
|
|
buffer. If TO-BUFFER is the symbol `string', don't leave any
|
|
buffer behind but just return the resulting LaTeX as a string.
|
|
When BODY-ONLY is set, don't produce the file header and footer,
|
|
simply return the content of \begin{document}...\end{document},
|
|
without even the \begin{document} and \end{document} commands.
|
|
when PUB-DIR is set, use this as the publishing directory."
|
|
(interactive "P")
|
|
;; Make sure we have a file name when we need it.
|
|
(when (and (not (or to-buffer body-only))
|
|
(not buffer-file-name))
|
|
(if (buffer-base-buffer)
|
|
(org-set-local 'buffer-file-name
|
|
(with-current-buffer (buffer-base-buffer)
|
|
buffer-file-name))
|
|
(error "Need a file name to be able to export")))
|
|
|
|
(message "Exporting to LaTeX...")
|
|
(remove-text-properties (point-min) (point-max)
|
|
'(:org-license-to-kill nil))
|
|
(org-update-radio-target-regexp)
|
|
(org-export-latex-set-initial-vars ext-plist arg)
|
|
(let* ((wcf (current-window-configuration))
|
|
(opt-plist org-export-latex-options-plist)
|
|
(region-p (org-region-active-p))
|
|
(rbeg (and region-p (region-beginning)))
|
|
(rend (and region-p (region-end)))
|
|
(subtree-p
|
|
(when region-p
|
|
(save-excursion
|
|
(goto-char rbeg)
|
|
(and (org-at-heading-p)
|
|
(>= (org-end-of-subtree t t) rend)))))
|
|
(opt-plist (if subtree-p
|
|
(org-export-add-subtree-options opt-plist rbeg)
|
|
opt-plist))
|
|
;; Make sure the variable contains the updated values.
|
|
(org-export-latex-options-plist opt-plist)
|
|
(title (or (and subtree-p (org-export-get-title-from-subtree))
|
|
(plist-get opt-plist :title)
|
|
(and (not
|
|
(plist-get opt-plist :skip-before-1st-heading))
|
|
(org-export-grab-title-from-buffer))
|
|
(file-name-sans-extension
|
|
(file-name-nondirectory buffer-file-name))))
|
|
(filename (concat (file-name-as-directory
|
|
(or pub-dir
|
|
(org-export-directory :LaTeX ext-plist)))
|
|
(file-name-sans-extension
|
|
(or (and subtree-p
|
|
(org-entry-get rbeg "EXPORT_FILE_NAME" t))
|
|
(file-name-nondirectory ;sans-extension
|
|
buffer-file-name)))
|
|
".tex"))
|
|
(filename (if (equal (file-truename filename)
|
|
(file-truename buffer-file-name))
|
|
(concat filename ".tex")
|
|
filename))
|
|
(buffer (if to-buffer
|
|
(cond
|
|
((eq to-buffer 'string) (get-buffer-create
|
|
"*Org LaTeX Export*"))
|
|
(t (get-buffer-create to-buffer)))
|
|
(find-file-noselect filename)))
|
|
(odd org-odd-levels-only)
|
|
(header (org-export-latex-make-header title opt-plist))
|
|
(skip (cond (subtree-p nil)
|
|
(region-p nil)
|
|
(t (plist-get opt-plist :skip-before-1st-heading))))
|
|
(text (plist-get opt-plist :text))
|
|
(first-lines (if skip "" (org-export-latex-first-lines
|
|
opt-plist rbeg)))
|
|
(coding-system (and (boundp 'buffer-file-coding-system)
|
|
buffer-file-coding-system))
|
|
(coding-system-for-write (or org-export-latex-coding-system
|
|
coding-system))
|
|
(save-buffer-coding-system (or org-export-latex-coding-system
|
|
coding-system))
|
|
(region (buffer-substring
|
|
(if region-p (region-beginning) (point-min))
|
|
(if region-p (region-end) (point-max))))
|
|
(string-for-export
|
|
(org-export-preprocess-string
|
|
region
|
|
:emph-multiline t
|
|
:for-LaTeX t
|
|
:comments nil
|
|
:tags (plist-get opt-plist :tags)
|
|
:priority (plist-get opt-plist :priority)
|
|
:footnotes (plist-get opt-plist :footnotes)
|
|
:timestamps (plist-get opt-plist :timestamps)
|
|
:todo-keywords (plist-get opt-plist :todo-keywords)
|
|
:add-text (if (eq to-buffer 'string) nil text)
|
|
:skip-before-1st-heading skip
|
|
:select-tags (plist-get opt-plist :select-tags)
|
|
:exclude-tags (plist-get opt-plist :exclude-tags)
|
|
:LaTeX-fragments nil)))
|
|
|
|
(set-buffer buffer)
|
|
(erase-buffer)
|
|
|
|
(and (fboundp 'set-buffer-file-coding-system)
|
|
(set-buffer-file-coding-system coding-system-for-write))
|
|
|
|
;; insert the header and initial document commands
|
|
(unless (or (eq to-buffer 'string) body-only)
|
|
(insert header))
|
|
|
|
;; insert text found in #+TEXT
|
|
(when (and text (not (eq to-buffer 'string)))
|
|
(insert (org-export-latex-content
|
|
text '(lists tables fixed-width keywords))
|
|
"\n\n"))
|
|
|
|
;; insert lines before the first headline
|
|
(unless (or skip (eq to-buffer 'string))
|
|
(insert first-lines))
|
|
|
|
;; export the content of headlines
|
|
(org-export-latex-global
|
|
(with-temp-buffer
|
|
(insert string-for-export)
|
|
(goto-char (point-min))
|
|
(when (re-search-forward "^\\(\\*+\\) " nil t)
|
|
(let* ((asters (length (match-string 1)))
|
|
(level (if odd (- asters 2) (- asters 1))))
|
|
(setq org-export-latex-add-level
|
|
(if odd (1- (/ (1+ asters) 2)) (1- asters)))
|
|
(org-export-latex-parse-global level odd)))))
|
|
|
|
;; finalization
|
|
(unless body-only (insert "\n\\end{document}"))
|
|
(or to-buffer (save-buffer))
|
|
(goto-char (point-min))
|
|
(message "Exporting to LaTeX...done")
|
|
(prog1
|
|
(if (eq to-buffer 'string)
|
|
(prog1 (buffer-substring (point-min) (point-max))
|
|
(kill-buffer (current-buffer)))
|
|
(current-buffer))
|
|
(set-window-configuration wcf))))
|
|
|
|
;;;###autoload
|
|
(defun org-export-as-pdf (arg &optional hidden ext-plist
|
|
to-buffer body-only pub-dir)
|
|
"Export as LaTeX, then process through to PDF."
|
|
(interactive "P")
|
|
(message "Exporting to PDF...")
|
|
(let* ((wconfig (current-window-configuration))
|
|
(lbuf (org-export-as-latex arg hidden ext-plist
|
|
to-buffer body-only pub-dir))
|
|
(file (buffer-file-name lbuf))
|
|
(base (file-name-sans-extension (buffer-file-name lbuf)))
|
|
(pdffile (concat base ".pdf")))
|
|
(and (file-exists-p pdffile) (delete-file pdffile))
|
|
(message "Processing LaTeX file...")
|
|
(shell-command (format "pdflatex -interaction nonstopmode %s"
|
|
(shell-quote-argument file)))
|
|
(shell-command (format "pdflatex -interaction nonstopmode %s"
|
|
(shell-quote-argument file)))
|
|
(message "Processing LaTeX file...done")
|
|
(if (not (file-exists-p pdffile))
|
|
(error "PDF file was not produced")
|
|
(set-window-configuration wconfig)
|
|
(when org-export-pdf-remove-logfiles
|
|
(dolist (ext '("aux" "log" "out" "toc"))
|
|
(setq file (concat base "." ext))
|
|
(and (file-exists-p file) (delete-file file))))
|
|
(message "Exporting to PDF...done")
|
|
pdffile)))
|
|
|
|
;;;###autoload
|
|
(defun org-export-as-pdf-and-open (arg)
|
|
"Export as LaTeX, then process through to PDF, and open."
|
|
(interactive "P")
|
|
(let ((pdffile (org-export-as-pdf arg)))
|
|
(if pdffile
|
|
(org-open-file pdffile)
|
|
(error "PDF file was not produced"))))
|
|
|
|
;;; Parsing functions:
|
|
|
|
(defun org-export-latex-parse-global (level odd)
|
|
"Parse the current buffer recursively, starting at LEVEL.
|
|
If ODD is non-nil, assume the buffer only contains odd sections.
|
|
Return a list reflecting the document structure."
|
|
(save-excursion
|
|
(goto-char (point-min))
|
|
(let* ((cnt 0) output
|
|
(depth org-export-latex-sectioning-depth))
|
|
(while (re-search-forward
|
|
(concat "^\\(\\(?:\\*\\)\\{"
|
|
(number-to-string (+ (if odd 2 1) level))
|
|
"\\}\\) \\(.*\\)$")
|
|
;; make sure that there is no upper heading
|
|
(when (> level 0)
|
|
(save-excursion
|
|
(save-match-data
|
|
(re-search-forward
|
|
(concat "^\\(\\(?:\\*\\)\\{"
|
|
(number-to-string level)
|
|
"\\}\\) \\(.*\\)$") nil t)))) t)
|
|
(setq cnt (1+ cnt))
|
|
(let* ((pos (match-beginning 0))
|
|
(heading (match-string 2))
|
|
(nlevel (if odd (/ (+ 3 level) 2) (1+ level))))
|
|
(save-excursion
|
|
(narrow-to-region
|
|
(point)
|
|
(save-match-data
|
|
(if (re-search-forward
|
|
(concat "^\\(\\(?:\\*\\)\\{"
|
|
(number-to-string (+ (if odd 2 1) level))
|
|
"\\}\\) \\(.*\\)$") nil t)
|
|
(match-beginning 0)
|
|
(point-max))))
|
|
(goto-char (point-min))
|
|
(setq output
|
|
(append output
|
|
(list
|
|
(list
|
|
`(pos . ,pos)
|
|
`(level . ,nlevel)
|
|
`(occur . ,cnt)
|
|
`(heading . ,heading)
|
|
`(content . ,(org-export-latex-parse-content))
|
|
`(subcontent . ,(org-export-latex-parse-subcontent
|
|
level odd)))))))
|
|
(widen)))
|
|
(list output))))
|
|
|
|
(defun org-export-latex-parse-content ()
|
|
"Extract the content of a section."
|
|
(let ((beg (point))
|
|
(end (if (re-search-forward "^\\(\\*\\)+ .*$" nil t)
|
|
(progn (beginning-of-line) (point))
|
|
(point-max))))
|
|
(buffer-substring beg end)))
|
|
|
|
(defun org-export-latex-parse-subcontent (level odd)
|
|
"Extract the subcontent of a section at LEVEL.
|
|
If ODD Is non-nil, assume subcontent only contains odd sections."
|
|
(if (not (re-search-forward
|
|
(concat "^\\(\\(?:\\*\\)\\{"
|
|
(number-to-string (+ (if odd 4 2) level))
|
|
"\\}\\) \\(.*\\)$")
|
|
nil t))
|
|
nil ; subcontent is nil
|
|
(org-export-latex-parse-global (+ (if odd 2 1) level) odd)))
|
|
|
|
;;; Rendering functions:
|
|
(defun org-export-latex-global (content)
|
|
"Export CONTENT to LaTeX.
|
|
CONTENT is an element of the list produced by
|
|
`org-export-latex-parse-global'."
|
|
(if (eq (car content) 'subcontent)
|
|
(mapc 'org-export-latex-sub (cdr content))
|
|
(org-export-latex-sub (car content))))
|
|
|
|
(defun org-export-latex-sub (subcontent)
|
|
"Export the list SUBCONTENT to LaTeX.
|
|
SUBCONTENT is an alist containing information about the headline
|
|
and its content."
|
|
(let ((num (plist-get org-export-latex-options-plist :section-numbers)))
|
|
(mapc (lambda(x) (org-export-latex-subcontent x num)) subcontent)))
|
|
|
|
(defun org-export-latex-subcontent (subcontent num)
|
|
"Export each cell of SUBCONTENT to LaTeX.
|
|
If NUM, export sections as numerical sections."
|
|
(let* ((heading (org-export-latex-fontify-headline
|
|
(cdr (assoc 'heading subcontent))))
|
|
(level (- (cdr (assoc 'level subcontent))
|
|
org-export-latex-add-level))
|
|
(occur (number-to-string (cdr (assoc 'occur subcontent))))
|
|
(content (cdr (assoc 'content subcontent)))
|
|
(subcontent (cadr (assoc 'subcontent subcontent)))
|
|
(label (org-get-text-property-any 0 'target heading))
|
|
(label-list (cons label (cdr (assoc label
|
|
org-export-target-aliases)))))
|
|
(cond
|
|
;; Normal conversion
|
|
((<= level org-export-latex-sectioning-depth)
|
|
(let* ((sec (nth (1- level) org-export-latex-sectioning))
|
|
start end)
|
|
(if (consp (cdr sec))
|
|
(setq start (nth (if num 0 2) sec)
|
|
end (nth (if num 1 3) sec))
|
|
(setq start (if num (car sec) (cdr sec))))
|
|
(insert (format start heading) "\n")
|
|
(when label
|
|
(insert (mapconcat (lambda (l) (format "\\label{%s}" l))
|
|
label-list "\n") "\n"))
|
|
(insert (org-export-latex-content content))
|
|
(cond ((stringp subcontent) (insert subcontent))
|
|
((listp subcontent) (org-export-latex-sub subcontent)))
|
|
(if end (insert end "\n"))))
|
|
;; At a level under the hl option: we can drop this subsection
|
|
((> level org-export-latex-sectioning-depth)
|
|
(cond ((eq org-export-latex-low-levels 'description)
|
|
(insert (format "\\begin{description}\n\n\\item[%s]%s\n\n"
|
|
heading
|
|
(if label (format "\\label{%s}" label) "")))
|
|
(insert (org-export-latex-content content))
|
|
(cond ((stringp subcontent) (insert subcontent))
|
|
((listp subcontent) (org-export-latex-sub subcontent)))
|
|
(insert "\\end{description}\n"))
|
|
((stringp org-export-latex-low-levels)
|
|
(insert (format org-export-latex-low-levels heading) "\n")
|
|
(when label (insert (format "\\label{%s}\n" label)))
|
|
(insert (org-export-latex-content content))
|
|
(cond ((stringp subcontent) (insert subcontent))
|
|
((listp subcontent) (org-export-latex-sub subcontent)))))))))
|
|
|
|
;;; Exporting internals:
|
|
(defun org-export-latex-set-initial-vars (ext-plist level)
|
|
"Store org local variables required for LaTeX export.
|
|
EXT-PLIST is an optional additional plist.
|
|
LEVEL indicates the default depth for export."
|
|
(setq org-export-latex-todo-keywords-1 org-todo-keywords-1
|
|
org-export-latex-all-targets-re
|
|
(org-make-target-link-regexp (org-all-targets))
|
|
org-export-latex-options-plist
|
|
(org-combine-plists (org-default-export-plist) ext-plist
|
|
(org-infile-export-plist))
|
|
org-export-latex-class
|
|
(or (and (org-region-active-p)
|
|
(save-excursion
|
|
(goto-char (region-beginning))
|
|
(and (looking-at org-complex-heading-regexp)
|
|
(org-entry-get nil "LaTeX_CLASS" 'selective))))
|
|
(save-excursion
|
|
(save-restriction
|
|
(widen)
|
|
(goto-char (point-min))
|
|
(and (re-search-forward "^#\\+LaTeX_CLASS:[ \t]*\\([a-zA-Z]+\\)" nil t)
|
|
(match-string 1))))
|
|
org-export-latex-default-class)
|
|
org-export-latex-class
|
|
(or (car (assoc org-export-latex-class org-export-latex-classes))
|
|
(error "No definition for class `%s' in `org-export-latex-classes'"
|
|
org-export-latex-class))
|
|
org-export-latex-header
|
|
(cadr (assoc org-export-latex-class org-export-latex-classes))
|
|
org-export-latex-sectioning
|
|
(cddr (assoc org-export-latex-class org-export-latex-classes))
|
|
org-export-latex-sectioning-depth
|
|
(or level
|
|
(let ((hl-levels
|
|
(plist-get org-export-latex-options-plist :headline-levels))
|
|
(sec-depth (length org-export-latex-sectioning)))
|
|
(if (> hl-levels sec-depth) sec-depth hl-levels)))))
|
|
|
|
(defun org-export-latex-make-header (title opt-plist)
|
|
"Make the LaTeX header and return it as a string.
|
|
TITLE is the current title from the buffer or region.
|
|
OPT-PLIST is the options plist for current buffer."
|
|
(let ((toc (plist-get opt-plist :table-of-contents))
|
|
(author (plist-get opt-plist :author)))
|
|
(concat
|
|
(if (plist-get opt-plist :time-stamp-file)
|
|
(format-time-string "%% Created %Y-%m-%d %a %H:%M\n"))
|
|
;; insert LaTeX custom header
|
|
org-export-latex-header
|
|
"\n"
|
|
;; insert information on LaTeX packages
|
|
(when org-export-latex-packages-alist
|
|
(mapconcat (lambda(p)
|
|
(if (equal "" (car p))
|
|
(format "\\usepackage{%s}" (cadr p))
|
|
(format "\\usepackage[%s]{%s}"
|
|
(car p) (cadr p))))
|
|
org-export-latex-packages-alist "\n"))
|
|
;; insert additional commands in the header
|
|
(plist-get opt-plist :latex-header-extra)
|
|
org-export-latex-append-header
|
|
;; insert the title
|
|
(format
|
|
"\n\n\\title{%s}\n"
|
|
;; convert the title
|
|
(org-export-latex-content
|
|
title '(lists tables fixed-width keywords)))
|
|
;; insert author info
|
|
(if (plist-get opt-plist :author-info)
|
|
(format "\\author{%s}\n"
|
|
(or author user-full-name))
|
|
(format "%%\\author{%s}\n"
|
|
(or author user-full-name)))
|
|
;; insert the date
|
|
(format "\\date{%s}\n"
|
|
(format-time-string
|
|
(or (plist-get opt-plist :date)
|
|
org-export-latex-date-format)))
|
|
;; beginning of the document
|
|
"\n\\begin{document}\n\n"
|
|
;; insert the title command
|
|
(if (string-match "%s" org-export-latex-title-command)
|
|
(format org-export-latex-title-command title)
|
|
org-export-latex-title-command)
|
|
"\n\n"
|
|
;; table of contents
|
|
(when (and org-export-with-toc
|
|
(plist-get opt-plist :section-numbers))
|
|
(cond ((numberp toc)
|
|
(format "\\setcounter{tocdepth}{%s}\n\\tableofcontents\n\\vspace*{1cm}\n"
|
|
(min toc (plist-get opt-plist :headline-levels))))
|
|
(toc (format "\\setcounter{tocdepth}{%s}\n\\tableofcontents\n\\vspace*{1cm}\n"
|
|
(plist-get opt-plist :headline-levels))))))))
|
|
|
|
(defun org-export-latex-first-lines (opt-plist &optional beg)
|
|
"Export the first lines before first headline.
|
|
If BEG is non-nil, the is the beginning of he region."
|
|
(save-excursion
|
|
(goto-char (or beg (point-min)))
|
|
(if (org-at-heading-p) (beginning-of-line 2))
|
|
(let* ((pt (point))
|
|
(end (if (re-search-forward "^\\*+ " nil t)
|
|
(goto-char (match-beginning 0))
|
|
(goto-char (point-max)))))
|
|
(prog1
|
|
(org-export-latex-content
|
|
(org-export-preprocess-string
|
|
(buffer-substring pt end)
|
|
:for-LaTeX t
|
|
:emph-multiline t
|
|
:add-text nil
|
|
:comments nil
|
|
:skip-before-1st-heading nil
|
|
:LaTeX-fragments nil
|
|
:timestamps (plist-get opt-plist :timestamps)
|
|
:footnotes (plist-get opt-plist :footnotes)))
|
|
(add-text-properties pt (max pt (1- end))
|
|
'(:org-license-to-kill t))))))
|
|
|
|
(defun org-export-latex-content (content &optional exclude-list)
|
|
"Convert CONTENT string to LaTeX.
|
|
Don't perform conversions that are in EXCLUDE-LIST. Recognized
|
|
conversion types are: quotation-marks, emphasis, sub-superscript,
|
|
links, keywords, lists, tables, fixed-width"
|
|
(with-temp-buffer
|
|
(insert content)
|
|
(unless (memq 'quotation-marks exclude-list)
|
|
(org-export-latex-quotation-marks))
|
|
(unless (memq 'emphasis exclude-list)
|
|
(when (plist-get org-export-latex-options-plist :emphasize)
|
|
(org-export-latex-fontify)))
|
|
(unless (memq 'sub-superscript exclude-list)
|
|
(org-export-latex-special-chars
|
|
(plist-get org-export-latex-options-plist :sub-superscript)))
|
|
(unless (memq 'links exclude-list)
|
|
(org-export-latex-links))
|
|
(unless (memq 'keywords exclude-list)
|
|
(org-export-latex-keywords))
|
|
(unless (memq 'lists exclude-list)
|
|
(org-export-latex-lists))
|
|
(unless (memq 'tables exclude-list)
|
|
(org-export-latex-tables
|
|
(plist-get org-export-latex-options-plist :tables)))
|
|
(unless (memq 'fixed-width exclude-list)
|
|
(org-export-latex-fixed-width
|
|
(plist-get org-export-latex-options-plist :fixed-width)))
|
|
;; return string
|
|
(buffer-substring (point-min) (point-max))))
|
|
|
|
(defun org-export-latex-protect-string (s)
|
|
"Add the org-protected property to string S."
|
|
(add-text-properties 0 (length s) '(org-protected t) s) s)
|
|
|
|
(defun org-export-latex-protect-char-in-string (char-list string)
|
|
"Add org-protected text-property to char from CHAR-LIST in STRING."
|
|
(with-temp-buffer
|
|
(save-match-data
|
|
(insert string)
|
|
(goto-char (point-min))
|
|
(while (re-search-forward (regexp-opt char-list) nil t)
|
|
(add-text-properties (match-beginning 0)
|
|
(match-end 0) '(org-protected t)))
|
|
(buffer-string))))
|
|
|
|
(defun org-export-latex-keywords-maybe (&optional remove-list)
|
|
"Maybe remove keywords depending on rules in REMOVE-LIST."
|
|
(goto-char (point-min))
|
|
(let ((re-todo (mapconcat 'identity org-export-latex-todo-keywords-1 "\\|"))
|
|
(case-fold-search nil))
|
|
;; convert TODO keywords
|
|
(when (re-search-forward (concat "^\\(" re-todo "\\)") nil t)
|
|
(if (plist-get remove-list :todo)
|
|
(replace-match "")
|
|
(replace-match (format "\\textbf{%s}" (match-string 1)) t t)))
|
|
;; convert priority string
|
|
(when (re-search-forward "\\[\\\\#.\\]" nil t)
|
|
(if (plist-get remove-list :priority)
|
|
(replace-match "")
|
|
(replace-match (format "\\textbf{%s}" (match-string 0)) t t)))
|
|
;; convert tags
|
|
(when (re-search-forward "\\(:[a-zA-Z0-9_@]+\\)+:" nil t)
|
|
(if (or (not org-export-with-tags)
|
|
(plist-get remove-list :tags))
|
|
(replace-match "")
|
|
(replace-match
|
|
(org-export-latex-protect-string
|
|
(format "\\textbf{%s}"
|
|
(save-match-data
|
|
(replace-regexp-in-string
|
|
"_" "\\\\_" (match-string 0)))))
|
|
t t)))))
|
|
|
|
(defun org-export-latex-fontify-headline (string)
|
|
"Fontify special words in STRING."
|
|
(with-temp-buffer
|
|
;; FIXME: org-inside-LaTeX-fragment-p doesn't work when the $...$ is at
|
|
;; the beginning of the buffer - inserting "\n" is safe here though.
|
|
(insert "\n" string)
|
|
(goto-char (point-min))
|
|
(when (plist-get org-export-latex-options-plist :emphasize)
|
|
(org-export-latex-fontify))
|
|
(org-export-latex-keywords-maybe)
|
|
(org-export-latex-special-chars
|
|
(plist-get org-export-latex-options-plist :sub-superscript))
|
|
(org-export-latex-links)
|
|
(org-trim (buffer-string))))
|
|
|
|
(defun org-export-latex-quotation-marks ()
|
|
"Export quotation marks depending on language conventions."
|
|
(let* ((lang (plist-get org-export-latex-options-plist :language))
|
|
(quote-rpl (if (equal lang "fr")
|
|
'(("\\(\\s-\\)\"" "«~")
|
|
("\\(\\S-\\)\"" "~»")
|
|
("\\(\\s-\\)'" "`"))
|
|
'(("\\(\\s-\\)\"" "``")
|
|
("\\(\\S-\\)\"" "''")
|
|
("\\(\\s-\\)'" "`")))))
|
|
(mapc (lambda(l) (goto-char (point-min))
|
|
(while (re-search-forward (car l) nil t)
|
|
(let ((rpl (concat (match-string 1) (cadr l))))
|
|
(org-export-latex-protect-string rpl)
|
|
(org-if-unprotected-1
|
|
(replace-match rpl t t))))) quote-rpl)))
|
|
|
|
(defun org-export-latex-special-chars (sub-superscript)
|
|
"Export special characters to LaTeX.
|
|
If SUB-SUPERSCRIPT is non-nil, convert \\ and ^.
|
|
See the `org-export-latex.el' code for a complete conversion table."
|
|
(goto-char (point-min))
|
|
(mapc (lambda(c)
|
|
(goto-char (point-min))
|
|
(while (re-search-forward c nil t)
|
|
;; Put the point where to check for org-protected
|
|
(unless (get-text-property (match-beginning 2) 'org-protected)
|
|
(cond ((member (match-string 2) '("\\$" "$"))
|
|
(if (equal (match-string 2) "\\$")
|
|
nil
|
|
(replace-match "\\$" t t)))
|
|
((member (match-string 2) '("&" "%" "#"))
|
|
(if (equal (match-string 1) "\\")
|
|
(replace-match (match-string 2) t t)
|
|
(replace-match (concat (match-string 1) "\\"
|
|
(match-string 2)) t t)))
|
|
((equal (match-string 2) "...")
|
|
(replace-match
|
|
(concat (match-string 1)
|
|
(org-export-latex-protect-string "\\ldots{}")) t t))
|
|
((equal (match-string 2) "~")
|
|
(cond ((equal (match-string 1) "\\") nil)
|
|
((eq 'org-link (get-text-property 0 'face (match-string 2)))
|
|
(replace-match (concat (match-string 1) "\\~") t t))
|
|
(t (replace-match
|
|
(org-export-latex-protect-string
|
|
(concat (match-string 1) "\\~{}")) t t))))
|
|
((member (match-string 2) '("{" "}"))
|
|
(unless (save-match-data (org-inside-latex-math-p))
|
|
(if (equal (match-string 1) "\\")
|
|
(replace-match (match-string 2) t t)
|
|
(replace-match (concat (match-string 1) "\\"
|
|
(match-string 2)) t t)))))
|
|
(unless (save-match-data (org-inside-latex-math-p))
|
|
(cond ((equal (match-string 2) "\\")
|
|
(replace-match (or (save-match-data
|
|
(org-export-latex-treat-backslash-char
|
|
(match-string 1)
|
|
(or (match-string 3) "")))
|
|
"") t t))
|
|
((member (match-string 2) '("_" "^"))
|
|
(replace-match (or (save-match-data
|
|
(org-export-latex-treat-sub-super-char
|
|
sub-superscript
|
|
(match-string 2)
|
|
(match-string 1)
|
|
(match-string 3))) "") t t)))))))
|
|
'(;"^\\([^\n$]*?\\|^\\)\\(\\\\?\\$\\)\\([^\n$]*\\)$"
|
|
"\\(\\(\\\\?\\$\\)\\)"
|
|
"\\([a-za-z0-9]+\\|[ \t\n]\\|\\b\\|\\\\\\)\\(_\\|\\^\\)\\([a-za-z0-9]+\\|[ \t\n]\\|[:punct:]\\|{[a-za-z0-9]+}\\|([a-za-z0-9]+)\\)"
|
|
"\\(.\\|^\\)\\(\\\\\\)\\([ \t\n]\\|[a-zA-Z&#%{}\"]+\\)"
|
|
"\\(.\\|^\\)\\(&\\)"
|
|
"\\(.\\|^\\)\\(#\\)"
|
|
"\\(.\\|^\\)\\(%\\)"
|
|
"\\(.\\|^\\)\\({\\)"
|
|
"\\(.\\|^\\)\\(}\\)"
|
|
"\\(.\\|^\\)\\(~\\)"
|
|
"\\(.\\|^\\)\\(\\.\\.\\.\\)"
|
|
;; (?\< . "\\textless{}")
|
|
;; (?\> . "\\textgreater{}")
|
|
)))
|
|
|
|
(defun org-inside-latex-math-p ()
|
|
(get-text-property (point) 'org-latex-math))
|
|
|
|
(defun org-export-latex-treat-sub-super-char
|
|
(subsup char string-before string-after)
|
|
"Convert the \"_\" and \"^\" characters to LaTeX.
|
|
SUBSUP corresponds to the ^: option in the #+OPTIONS line.
|
|
Convert CHAR depending on STRING-BEFORE and STRING-AFTER."
|
|
(cond ((equal string-before "\\")
|
|
(concat string-before char string-after))
|
|
;; this is part of a math formula
|
|
((and (string-match "\\S-+" string-before)
|
|
(string-match "\\S-+" string-after))
|
|
(cond ((eq 'org-link (get-text-property 0 'face char))
|
|
(concat string-before "\\" char string-after))
|
|
((save-match-data (org-inside-latex-math-p))
|
|
(if subsup
|
|
(cond ((eq 1 (length string-after))
|
|
(concat string-before char string-after))
|
|
((string-match "[({]?\\([^)}]+\\)[)}]?" string-after)
|
|
(format "%s%s{%s}" string-before char
|
|
(match-string 1 string-after))))))
|
|
((and (> (length string-after) 1)
|
|
(or (eq subsup t)
|
|
(and (equal subsup '{}) (eq (string-to-char string-after) ?\{)))
|
|
(string-match "[({]?\\([^)}]+\\)[)}]?" string-after))
|
|
(format "%s$%s{%s}$" string-before char
|
|
(if (> (match-end 1) (1+ (match-beginning 1)))
|
|
(concat "\\mathrm{" (match-string 1 string-after) "}")
|
|
(match-string 1 string-after))))
|
|
((eq subsup t) (concat string-before "$" char string-after "$"))
|
|
(t (org-export-latex-protect-string
|
|
(concat string-before "\\" char "{}" string-after)))))
|
|
(t (org-export-latex-protect-string
|
|
(concat string-before "\\" char "{}" string-after)))))
|
|
|
|
(defun org-export-latex-treat-backslash-char (string-before string-after)
|
|
"Convert the \"$\" special character to LaTeX.
|
|
The conversion is made depending of STRING-BEFORE and STRING-AFTER."
|
|
(cond ((member (list string-after) org-html-entities)
|
|
;; backslash is part of a special entity (like "\alpha")
|
|
(concat string-before "$\\"
|
|
(or (cdar (member (list string-after) org-html-entities))
|
|
string-after) "$"))
|
|
((and (not (string-match "^[ \n\t]" string-after))
|
|
(not (string-match "[ \t]\\'\\|^" string-before)))
|
|
;; backslash is inside a word
|
|
(org-export-latex-protect-string
|
|
(concat string-before "\\textbackslash{}" string-after)))
|
|
((not (or (equal string-after "")
|
|
(string-match "^[ \t\n]" string-after)))
|
|
;; backslash might escape a character (like \#) or a user TeX
|
|
;; macro (like \setcounter)
|
|
(org-export-latex-protect-string
|
|
(concat string-before "\\" string-after)))
|
|
((and (string-match "^[ \t\n]" string-after)
|
|
(string-match "[ \t\n]\\'" string-before))
|
|
;; backslash is alone, convert it to $\backslash$
|
|
(org-export-latex-protect-string
|
|
(concat string-before "\\textbackslash{}" string-after)))
|
|
(t (org-export-latex-protect-string
|
|
(concat string-before "\\textbackslash{}" string-after)))))
|
|
|
|
(defun org-export-latex-keywords ()
|
|
"Convert special keywords to LaTeX."
|
|
(goto-char (point-min))
|
|
(let ((re (concat org-export-latex-special-keyword-regexp
|
|
".*" ; including the time stamp....
|
|
)))
|
|
(while (re-search-forward re nil t)
|
|
(replace-match (format "\\\\texttt{%s}" (match-string 0)) t))))
|
|
|
|
(defun org-export-latex-fixed-width (opt)
|
|
"When OPT is non-nil convert fixed-width sections to LaTeX."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "^[ \t]*:\\([ \t]\\|$\\)" nil t)
|
|
(if opt
|
|
(progn (goto-char (match-beginning 0))
|
|
(insert "\\begin{verbatim}\n")
|
|
(while (looking-at "^\\([ \t]*\\):\\(\\([ \t]\\|$\\).*\\)$")
|
|
(replace-match (concat (match-string 1)
|
|
(match-string 2)) t t)
|
|
(forward-line))
|
|
(insert "\\end{verbatim}\n\n"))
|
|
(progn (goto-char (match-beginning 0))
|
|
(while (looking-at "^\\([ \t]*\\):\\(\\([ \t]\\|$\\).*\\)$")
|
|
(replace-match (concat "%" (match-string 1)
|
|
(match-string 2)) t t)
|
|
(forward-line))))))
|
|
|
|
|
|
(defvar org-table-last-alignment) ; defined in org-table.el
|
|
(declare-function orgtbl-to-latex "org-table" (table params) t)
|
|
(defun org-export-latex-tables (insert)
|
|
"Convert tables to LaTeX and INSERT it."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "^\\([ \t]*\\)|" nil t)
|
|
;; FIXME really need to save-excursion?
|
|
(save-excursion (org-table-align))
|
|
(let* ((beg (org-table-begin))
|
|
(end (org-table-end))
|
|
(raw-table (buffer-substring beg end))
|
|
fnum fields line lines olines gr colgropen line-fmt align
|
|
caption label attr floatp longtblp)
|
|
(if org-export-latex-tables-verbatim
|
|
(let* ((tbl (concat "\\begin{verbatim}\n" raw-table
|
|
"\\end{verbatim}\n")))
|
|
(apply 'delete-region (list beg end))
|
|
(insert (org-export-latex-protect-string tbl)))
|
|
(progn
|
|
(setq caption (org-find-text-property-in-string
|
|
'org-caption raw-table)
|
|
attr (org-find-text-property-in-string
|
|
'org-attributes raw-table)
|
|
label (org-find-text-property-in-string
|
|
'org-label raw-table)
|
|
longtblp (and attr (stringp attr)
|
|
(string-match "\\<longtable\\>" attr))
|
|
align (and attr (stringp attr)
|
|
(string-match "\\<align=\\([^ \t\n\r,]+\\)" attr)
|
|
(match-string 1 attr))
|
|
floatp (or caption label))
|
|
(setq lines (split-string raw-table "\n" t))
|
|
(apply 'delete-region (list beg end))
|
|
(when org-export-table-remove-special-lines
|
|
(setq lines (org-table-clean-before-export lines 'maybe-quoted)))
|
|
;; make a formatting string to reflect aligment
|
|
(setq olines lines)
|
|
(while (and (not line-fmt) (setq line (pop olines)))
|
|
(unless (string-match "^[ \t]*|-" line)
|
|
(setq fields (org-split-string line "[ \t]*|[ \t]*"))
|
|
(setq fnum (make-vector (length fields) 0))
|
|
(setq line-fmt
|
|
(mapconcat
|
|
(lambda (x)
|
|
(setq gr (pop org-table-colgroup-info))
|
|
(format "%s%%s%s"
|
|
(cond ((eq gr ':start)
|
|
(prog1 (if colgropen "|" "")
|
|
(setq colgropen t)))
|
|
((eq gr ':startend)
|
|
(prog1 (if colgropen "|" "|")
|
|
(setq colgropen nil)))
|
|
(t ""))
|
|
(if (memq gr '(:end :startend))
|
|
(progn (setq colgropen nil) "|")
|
|
"")))
|
|
fnum ""))))
|
|
;; fix double || in line-fmt
|
|
(setq line-fmt (replace-regexp-in-string "||" "|" line-fmt))
|
|
;; maybe remove the first and last "|"
|
|
(when (and (not org-export-latex-tables-column-borders)
|
|
(string-match "^\\(|\\)?\\(.+\\)|$" line-fmt))
|
|
(setq line-fmt (match-string 2 line-fmt)))
|
|
;; format alignment
|
|
(unless align
|
|
(setq align (apply 'format
|
|
(cons line-fmt
|
|
(mapcar (lambda (x) (if x "r" "l"))
|
|
org-table-last-alignment)))))
|
|
;; prepare the table to send to orgtbl-to-latex
|
|
(setq lines
|
|
(mapcar
|
|
(lambda(elem)
|
|
(or (and (string-match "[ \t]*|-+" elem) 'hline)
|
|
(split-string (org-trim elem) "|" t)))
|
|
lines))
|
|
(when insert
|
|
(insert (org-export-latex-protect-string
|
|
(concat
|
|
(if longtblp
|
|
(concat "\\begin{longtable}{" align "}\n")
|
|
(if floatp "\\begin{table}[htb]\n"))
|
|
(if (or floatp longtblp)
|
|
(format
|
|
"\\caption{%s%s}"
|
|
(if label (concat "\\\label{" label "}") "")
|
|
(or caption "")))
|
|
(if longtblp "\\\\\n" "\n")
|
|
(if (not longtblp) "\\begin{center}\n")
|
|
(if (not longtblp) (concat "\\begin{tabular}{" align "}\n"))
|
|
(orgtbl-to-latex
|
|
lines
|
|
`(:tstart nil :tend nil
|
|
:hlend ,(if longtblp
|
|
(format "\\\\
|
|
\\hline
|
|
\\endhead
|
|
\\hline\\multicolumn{%d}{r}{Continued on next page}\\
|
|
\\endfoot
|
|
\\endlastfoot" (length org-table-last-alignment))
|
|
nil)))
|
|
(if (not longtblp) (concat "\n\\end{tabular}"))
|
|
(if longtblp "\n" "\n\\end{center}\n")
|
|
(if longtblp
|
|
"\\end{longtable}"
|
|
(if floatp "\\end{table}"))))
|
|
"\n\n")))))))
|
|
|
|
(defun org-export-latex-fontify ()
|
|
"Convert fontification to LaTeX."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward org-emph-re nil t)
|
|
;; The match goes one char after the *string*
|
|
(let ((emph (assoc (match-string 3)
|
|
org-export-latex-emphasis-alist))
|
|
(beg (match-beginning 0))
|
|
(end (match-end 0))
|
|
rpl)
|
|
(unless (or (get-text-property (1- (point)) 'org-protected)
|
|
(save-excursion
|
|
(goto-char (match-beginning 1))
|
|
(save-match-data
|
|
(and (org-at-table-p)
|
|
(string-match
|
|
"[|\n]" (buffer-substring beg end))))))
|
|
(setq rpl (concat (match-string 1)
|
|
(format (org-export-latex-protect-char-in-string
|
|
'("\\" "{" "}") (cadr emph))
|
|
(match-string 4))
|
|
(match-string 5)))
|
|
(if (caddr emph)
|
|
(setq rpl (org-export-latex-protect-string rpl)))
|
|
(replace-match rpl t t)))
|
|
(backward-char)))
|
|
|
|
(defun org-export-latex-links ()
|
|
;; Make sure to use the LaTeX hyperref and graphicx package
|
|
;; or send some warnings.
|
|
"Convert links to LaTeX."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward org-bracket-link-analytic-regexp++ nil t)
|
|
(org-if-unprotected
|
|
(goto-char (match-beginning 0))
|
|
(let* ((re-radio org-export-latex-all-targets-re)
|
|
(remove (list (match-beginning 0) (match-end 0)))
|
|
(raw-path (org-extract-attributes (match-string 3)))
|
|
(full-raw-path (concat (match-string 1) raw-path))
|
|
(desc (match-string 5))
|
|
(type (or (match-string 2)
|
|
(if (or (file-name-absolute-p raw-path)
|
|
(string-match "^\\.\\.?/" raw-path))
|
|
"file")))
|
|
(coderefp (equal type "coderef"))
|
|
(caption (org-find-text-property-in-string 'org-caption raw-path))
|
|
(attr (org-find-text-property-in-string 'org-attributes raw-path))
|
|
(label (org-find-text-property-in-string 'org-label raw-path))
|
|
(floatp (or label caption))
|
|
imgp radiop
|
|
;; define the path of the link
|
|
(path (cond
|
|
((member type '("coderef"))
|
|
raw-path)
|
|
((member type '("http" "https" "ftp"))
|
|
(concat type ":" raw-path))
|
|
((and re-radio (string-match re-radio raw-path))
|
|
(setq radiop t))
|
|
((equal type "mailto")
|
|
(concat type ":" raw-path))
|
|
((equal type "file")
|
|
(if (and (org-file-image-p
|
|
(expand-file-name
|
|
raw-path)
|
|
org-export-latex-inline-image-extensions)
|
|
(equal desc full-raw-path))
|
|
(setq imgp t)
|
|
(progn (when (string-match "\\(.+\\)::.+" raw-path)
|
|
(setq raw-path (match-string 1 raw-path)))
|
|
(if (file-exists-p raw-path)
|
|
(concat type "://" (expand-file-name raw-path))
|
|
(concat type "://" (org-export-directory
|
|
:LaTeX org-export-latex-options-plist)
|
|
raw-path))))))))
|
|
;; process with link inserting
|
|
(apply 'delete-region remove)
|
|
(cond ((and imgp (plist-get org-export-latex-options-plist :inline-images))
|
|
(insert
|
|
(concat
|
|
(if floatp "\\begin{figure}[htb]\n")
|
|
(format "\\centerline{\\includegraphics[%s]{%s}}\n"
|
|
(or attr org-export-latex-image-default-option)
|
|
(if (file-name-absolute-p raw-path)
|
|
(expand-file-name raw-path)
|
|
raw-path))
|
|
(if floatp
|
|
(format "\\caption{%s%s}\n"
|
|
(if label (concat "\\label{" label "}") "")
|
|
(or caption "")))
|
|
(if floatp "\\end{figure}\n"))))
|
|
(coderefp
|
|
(insert (format
|
|
(org-export-get-coderef-format path desc)
|
|
(cdr (assoc path org-export-code-refs)))))
|
|
(radiop (insert (format "\\hyperref[%s]{%s}"
|
|
(org-solidify-link-text raw-path) desc)))
|
|
((not type)
|
|
(insert (format "\\hyperref[%s]{%s}"
|
|
(org-solidify-link-text raw-path) desc)))
|
|
(path (insert (format "\\href{%s}{%s}" path desc)))
|
|
(t (insert "\\texttt{" desc "}")))))))
|
|
|
|
(defvar org-latex-entities) ; defined below
|
|
(defvar org-latex-entities-regexp) ; defined below
|
|
|
|
(defun org-export-latex-preprocess ()
|
|
"Clean stuff in the LaTeX export."
|
|
;; Preserve line breaks
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "\\\\\\\\" nil t)
|
|
(add-text-properties (match-beginning 0) (match-end 0)
|
|
'(org-protected t)))
|
|
|
|
;; Preserve latex environments
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "^[ \t]*\\\\begin{\\([a-zA-Z]+\\)}" nil t)
|
|
(let* ((start (progn (beginning-of-line) (point)))
|
|
(end (or (and (re-search-forward
|
|
(concat "^[ \t]*\\\\end{" (match-string 1) "}") nil t)
|
|
(point-at-eol))
|
|
(point-max))))
|
|
(add-text-properties start end '(org-protected t))))
|
|
|
|
;; Preserve math snippets
|
|
|
|
(let* ((matchers (plist-get org-format-latex-options :matchers))
|
|
(re-list org-latex-regexps)
|
|
beg end re e m n block off)
|
|
;; Check the different regular expressions
|
|
(while (setq e (pop re-list))
|
|
(setq m (car e) re (nth 1 e) n (nth 2 e)
|
|
block (if (nth 3 e) "\n\n" ""))
|
|
(setq off (if (member m '("$" "$1")) 1 0))
|
|
(when (and (member m matchers) (not (equal m "begin")))
|
|
(goto-char (point-min))
|
|
(while (re-search-forward re nil t)
|
|
(setq beg (+ (match-beginning 0) off) end (- (match-end 0) 0))
|
|
(add-text-properties beg end '(org-protected t org-latex-math t))))))
|
|
|
|
;; Convert LaTeX to \LaTeX{}
|
|
(goto-char (point-min))
|
|
(let ((case-fold-search nil))
|
|
(while (re-search-forward "\\([^+_]\\)LaTeX" nil t)
|
|
(org-if-unprotected
|
|
(replace-match (org-export-latex-protect-string
|
|
(concat (match-string 1) "\\LaTeX{}")) t t))))
|
|
|
|
;; Convert blockquotes
|
|
(goto-char (point-min))
|
|
(while (search-forward "ORG-BLOCKQUOTE-START" nil t)
|
|
(replace-match "\\begin{quote}" t t))
|
|
(goto-char (point-min))
|
|
(while (search-forward "ORG-BLOCKQUOTE-END" nil t)
|
|
(replace-match "\\end{quote}" t t))
|
|
|
|
;; Convert verse
|
|
(goto-char (point-min))
|
|
(while (search-forward "ORG-VERSE-START" nil t)
|
|
(replace-match "\\begin{verse}" t t))
|
|
(goto-char (point-min))
|
|
(while (search-forward "ORG-VERSE-END" nil t)
|
|
(replace-match "\\end{verse}" t t))
|
|
|
|
;; Convert horizontal rules
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "^----+.$" nil t)
|
|
(org-if-unprotected
|
|
(replace-match (org-export-latex-protect-string "\\hrule") t t)))
|
|
|
|
;; Protect LaTeX commands like \command[...]{...} or \command{...}
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "\\\\[a-zA-Z]+\\(?:\\[.*\\]\\)?{.*}" nil t)
|
|
(add-text-properties (match-beginning 0) (match-end 0)
|
|
'(org-protected t)))
|
|
|
|
;; Protect LaTeX entities
|
|
(goto-char (point-min))
|
|
(while (re-search-forward org-latex-entities-regexp nil t)
|
|
(add-text-properties (match-beginning 0) (match-end 0)
|
|
'(org-protected t)))
|
|
|
|
;; Replace radio links
|
|
(goto-char (point-min))
|
|
(while (re-search-forward
|
|
(concat "<<<?" org-export-latex-all-targets-re
|
|
">>>?\\((INVISIBLE)\\)?") nil t)
|
|
(org-if-unprotected
|
|
(replace-match
|
|
(org-export-latex-protect-string
|
|
(format "\\label{%s}%s" (save-match-data (org-solidify-link-text
|
|
(match-string 1)))
|
|
(if (match-string 2) "" (match-string 1)))) t t)))
|
|
|
|
;; Delete @<...> constructs
|
|
;; Thanks to Daniel Clemente for this regexp
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "@<\\(?:[^\"\n]\\|\".*\"\\)*?>" nil t)
|
|
(org-if-unprotected
|
|
(replace-match "")))
|
|
|
|
;; When converting to LaTeX, replace footnotes
|
|
;; FIXME: don't protect footnotes from conversion
|
|
(when (plist-get org-export-latex-options-plist :footnotes)
|
|
(goto-char (point-min))
|
|
(while (re-search-forward "\\[\\([0-9]+\\)\\]" nil t)
|
|
(org-if-unprotected
|
|
(when (save-match-data
|
|
(save-excursion (beginning-of-line)
|
|
(looking-at "[^:|#]")))
|
|
(let ((foot-beg (match-beginning 0))
|
|
(foot-end (match-end 0))
|
|
(foot-prefix (match-string 0))
|
|
footnote footnote-rpl)
|
|
(save-excursion
|
|
(if (not (re-search-forward (concat "^" (regexp-quote foot-prefix))
|
|
nil t))
|
|
(replace-match "$^{\\1}$")
|
|
(replace-match "")
|
|
(let ((end (save-excursion
|
|
(if (re-search-forward "^$\\|^#.*$\\|\\[[0-9]+\\]" nil t)
|
|
(match-beginning 0) (point-max)))))
|
|
(setq footnote (concat (org-trim (buffer-substring (point) end))
|
|
" ")) ; prevent last } being part of a link
|
|
(delete-region (point) end))
|
|
(goto-char foot-beg)
|
|
(delete-region foot-beg foot-end)
|
|
(unless (null footnote)
|
|
(setq footnote-rpl (format "\\footnote{%s}" footnote))
|
|
(add-text-properties 0 10 '(org-protected t) footnote-rpl)
|
|
(add-text-properties (1- (length footnote-rpl))
|
|
(length footnote-rpl)
|
|
'(org-protected t) footnote-rpl)
|
|
(insert footnote-rpl)))
|
|
)))))
|
|
|
|
;; Remove footnote section tag for LaTeX
|
|
(goto-char (point-min))
|
|
(while (re-search-forward
|
|
(concat "^" footnote-section-tag-regexp) nil t)
|
|
(org-if-unprotected
|
|
(replace-match "")))))
|
|
|
|
;;; List handling:
|
|
|
|
(defun org-export-latex-lists ()
|
|
"Convert plain text lists in current buffer into LaTeX lists."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward org-list-beginning-re nil t)
|
|
(org-if-unprotected
|
|
(beginning-of-line)
|
|
(insert (org-list-to-latex (org-list-parse-list t)
|
|
org-export-latex-list-parameters))
|
|
"\n")))
|
|
|
|
(defconst org-latex-entities
|
|
'("\\!"
|
|
"\\'"
|
|
"\\+"
|
|
"\\,"
|
|
"\\-"
|
|
"\\:"
|
|
"\\;"
|
|
"\\<"
|
|
"\\="
|
|
"\\>"
|
|
"\\Huge"
|
|
"\\LARGE"
|
|
"\\Large"
|
|
"\\Styles"
|
|
"\\\\"
|
|
"\\`"
|
|
"\\addcontentsline"
|
|
"\\address"
|
|
"\\addtocontents"
|
|
"\\addtocounter"
|
|
"\\addtolength"
|
|
"\\addvspace"
|
|
"\\alph"
|
|
"\\appendix"
|
|
"\\arabic"
|
|
"\\author"
|
|
"\\begin{array}"
|
|
"\\begin{center}"
|
|
"\\begin{description}"
|
|
"\\begin{enumerate}"
|
|
"\\begin{eqnarray}"
|
|
"\\begin{equation}"
|
|
"\\begin{figure}"
|
|
"\\begin{flushleft}"
|
|
"\\begin{flushright}"
|
|
"\\begin{itemize}"
|
|
"\\begin{list}"
|
|
"\\begin{minipage}"
|
|
"\\begin{picture}"
|
|
"\\begin{quotation}"
|
|
"\\begin{quote}"
|
|
"\\begin{tabbing}"
|
|
"\\begin{table}"
|
|
"\\begin{tabular}"
|
|
"\\begin{thebibliography}"
|
|
"\\begin{theorem}"
|
|
"\\begin{titlepage}"
|
|
"\\begin{verbatim}"
|
|
"\\begin{verse}"
|
|
"\\bf"
|
|
"\\bf"
|
|
"\\bibitem"
|
|
"\\bigskip"
|
|
"\\cdots"
|
|
"\\centering"
|
|
"\\circle"
|
|
"\\cite"
|
|
"\\cleardoublepage"
|
|
"\\clearpage"
|
|
"\\cline"
|
|
"\\closing"
|
|
"\\dashbox"
|
|
"\\date"
|
|
"\\ddots"
|
|
"\\dotfill"
|
|
"\\em"
|
|
"\\fbox"
|
|
"\\flushbottom"
|
|
"\\fnsymbol"
|
|
"\\footnote"
|
|
"\\footnotemark"
|
|
"\\footnotesize"
|
|
"\\footnotetext"
|
|
"\\frac"
|
|
"\\frame"
|
|
"\\framebox"
|
|
"\\hfill"
|
|
"\\hline"
|
|
"\\hrulespace"
|
|
"\\hspace"
|
|
"\\huge"
|
|
"\\hyphenation"
|
|
"\\include"
|
|
"\\includeonly"
|
|
"\\indent"
|
|
"\\input"
|
|
"\\it"
|
|
"\\kill"
|
|
"\\label"
|
|
"\\large"
|
|
"\\ldots"
|
|
"\\line"
|
|
"\\linebreak"
|
|
"\\linethickness"
|
|
"\\listoffigures"
|
|
"\\listoftables"
|
|
"\\location"
|
|
"\\makebox"
|
|
"\\maketitle"
|
|
"\\mark"
|
|
"\\mbox"
|
|
"\\medskip"
|
|
"\\multicolumn"
|
|
"\\multiput"
|
|
"\\newcommand"
|
|
"\\newcounter"
|
|
"\\newenvironment"
|
|
"\\newfont"
|
|
"\\newlength"
|
|
"\\newline"
|
|
"\\newpage"
|
|
"\\newsavebox"
|
|
"\\newtheorem"
|
|
"\\nocite"
|
|
"\\nofiles"
|
|
"\\noindent"
|
|
"\\nolinebreak"
|
|
"\\nopagebreak"
|
|
"\\normalsize"
|
|
"\\onecolumn"
|
|
"\\opening"
|
|
"\\oval"
|
|
"\\overbrace"
|
|
"\\overline"
|
|
"\\pagebreak"
|
|
"\\pagenumbering"
|
|
"\\pageref"
|
|
"\\pagestyle"
|
|
"\\par"
|
|
"\\parbox"
|
|
"\\put"
|
|
"\\raggedbottom"
|
|
"\\raggedleft"
|
|
"\\raggedright"
|
|
"\\raisebox"
|
|
"\\ref"
|
|
"\\rm"
|
|
"\\roman"
|
|
"\\rule"
|
|
"\\savebox"
|
|
"\\sc"
|
|
"\\scriptsize"
|
|
"\\setcounter"
|
|
"\\setlength"
|
|
"\\settowidth"
|
|
"\\sf"
|
|
"\\shortstack"
|
|
"\\signature"
|
|
"\\sl"
|
|
"\\small"
|
|
"\\smallskip"
|
|
"\\sqrt"
|
|
"\\tableofcontents"
|
|
"\\telephone"
|
|
"\\thanks"
|
|
"\\thispagestyle"
|
|
"\\tiny"
|
|
"\\title"
|
|
"\\tt"
|
|
"\\twocolumn"
|
|
"\\typein"
|
|
"\\typeout"
|
|
"\\underbrace"
|
|
"\\underline"
|
|
"\\usebox"
|
|
"\\usecounter"
|
|
"\\value"
|
|
"\\vdots"
|
|
"\\vector"
|
|
"\\verb"
|
|
"\\vfill"
|
|
"\\vline"
|
|
"\\vspace")
|
|
"A list of LaTeX commands to be protected when performing conversion.")
|
|
|
|
(defconst org-latex-entities-regexp
|
|
(let (names rest)
|
|
(dolist (x org-latex-entities)
|
|
(if (string-match "[a-z][A-Z]$" x)
|
|
(push x names)
|
|
(push x rest)))
|
|
(concat "\\(" (regexp-opt (nreverse names)) "\\>\\)"
|
|
"\\|\\(" (regexp-opt (nreverse rest)) "\\)")))
|
|
|
|
(provide 'org-export-latex)
|
|
|
|
;; arch-tag: 23c2b87d-da04-4c2d-ad2d-1eb6487bc3ad
|
|
|
|
;;; org-export-latex.el ends here
|