lisp/org-latex.el

   1 ;;; org-latex.el --- LaTeX exporter for org-mode
   2 ;;
   3 ;; Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
   4 ;;
   5 ;; Emacs Lisp Archive Entry
   6 ;; Filename: org-latex.el
   7 ;; Version: 6.27trans
   8 ;; Author: Bastien Guerry <bzg AT altern DOT org>
   9 ;; Maintainer: Carsten Dominik <carsten.dominik AT gmail DOT com>
  10 ;; Keywords: org, wp, tex
  11 ;; Description: Converts an org-mode buffer into LaTeX
  12
  13 ;; This file is part of GNU Emacs.
  14
  15 ;; GNU Emacs is free software: you can redistribute it and/or modify
  16 ;; it under the terms of the GNU General Public License as published by
  17 ;; the Free Software Foundation, either version 3 of the License, or
  18 ;; (at your option) any later version.
  19
  20 ;; GNU Emacs is distributed in the hope that it will be useful,
  21 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  22 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23 ;; GNU General Public License for more details.
  24
  25 ;; You should have received a copy of the GNU General Public License
  26 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  27
  28 ;;; Commentary:
  29 ;;
  30 ;; This library implements a LaTeX exporter for org-mode.
  31 ;;
  32 ;; It is part of Org and will be autoloaded
  33 ;;
  34 ;; The interactive functions are similar to those of the HTML exporter:
  35 ;;
  36 ;; M-x `org-export-as-latex'
  37 ;; M-x `org-export-as-pdf'
  38 ;; M-x `org-export-as-pdf-and-open'
  39 ;; M-x `org-export-as-latex-batch'
  40 ;; M-x `org-export-as-latex-to-buffer'
  41 ;; M-x `org-export-region-as-latex'
  42 ;; M-x `org-replace-region-by-latex'
  43 ;;
  44 ;;; Code:
  45
  46 (eval-when-compile
  47   (require 'cl))
  48
  49 (require 'footnote)
  50 (require 'org)
  51 (require 'org-exp)
  52
  53 ;;; Variables:
  54 (defvar org-export-latex-class nil)
  55 (defvar org-export-latex-header nil)
  56 (defvar org-export-latex-append-header nil)
  57 (defvar org-export-latex-options-plist nil)
  58 (defvar org-export-latex-todo-keywords-1 nil)
  59 (defvar org-export-latex-complex-heading-re nil)
  60 (defvar org-export-latex-not-done-keywords nil)
  61 (defvar org-export-latex-done-keywords nil)
  62 (defvar org-export-latex-display-custom-times nil)
  63 (defvar org-export-latex-all-targets-re nil)
  64 (defvar org-export-latex-add-level 0)
  65 (defvar org-export-latex-sectioning "")
  66 (defvar org-export-latex-sectioning-depth 0)
  67 (defvar org-export-latex-special-keyword-regexp
  68   (concat "\\<\\(" org-scheduled-string "\\|"
  69           org-deadline-string "\\|"
  70           org-closed-string"\\)")
  71   "Regexp matching special time planning keywords plus the time after it.")
  72
  73 (defvar latexp)    ; dynamically scoped from org.el
  74 (defvar re-quote)  ; dynamically scoped from org.el
  75 (defvar commentsp) ; dynamically scoped from org.el
  76
  77 ;;; User variables:
  78
  79 (defgroup org-export-latex nil
  80   "Options for exporting Org-mode files to LaTeX."
  81   :tag "Org Export LaTeX"
  82   :group 'org-export)
  83
  84 (defcustom org-export-latex-default-class "article"
  85   "The default LaTeX class."
  86   :group 'org-export-latex
  87   :type '(string :tag "LaTeX class"))
  88
  89 (defcustom org-export-latex-classes
  90   '(("article"
  91      "\\documentclass[11pt]{article}
  92 \\usepackage[utf8]{inputenc}
  93 \\usepackage[T1]{fontenc}
  94 \\usepackage{graphicx}
  95 \\usepackage{longtable}
  96 \\usepackage{hyperref}"
  97      ("\\section{%s}" . "\\section*{%s}")
  98      ("\\subsection{%s}" . "\\subsection*{%s}")
  99      ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
 100      ("\\paragraph{%s}" . "\\paragraph*{%s}")
 101      ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
 102     ("report"
 103      "\\documentclass[11pt]{report}
 104 \\usepackage[utf8]{inputenc}
 105 \\usepackage[T1]{fontenc}
 106 \\usepackage{graphicx}
 107 \\usepackage{longtable}
 108 \\usepackage{hyperref}"
 109      ("\\part{%s}" . "\\part*{%s}")
 110      ("\\chapter{%s}" . "\\chapter*{%s}")
 111      ("\\section{%s}" . "\\section*{%s}")
 112      ("\\subsection{%s}" . "\\subsection*{%s}")
 113      ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
 114     ("book"
 115      "\\documentclass[11pt]{book}
 116 \\usepackage[utf8]{inputenc}
 117 \\usepackage[T1]{fontenc}
 118 \\usepackage{graphicx}
 119 \\usepackage{longtable}
 120 \\usepackage{hyperref}"
 121      ("\\part{%s}" . "\\part*{%s}")
 122      ("\\chapter{%s}" . "\\chapter*{%s}")
 123      ("\\section{%s}" . "\\section*{%s}")
 124      ("\\subsection{%s}" . "\\subsection*{%s}")
 125      ("\\subsubsection{%s}" . "\\subsubsection*{%s}")))
 126   "Alist of LaTeX classes and associated header and structure.
 127 If #+LaTeX_CLASS is set in the buffer, use its value and the
 128 associated information.  Here is the structure of each cell:
 129
 130   \(class-name
 131     header-string
 132     (numbered-section . unnumbered-section\)
 133     ...\)
 134
 135 A %s formatter is mandatory in each section string and will be
 136 replaced by the title of the section.
 137
 138 Instead of a cons cell (numbered . unnumbered), you can also provide a list
 139 of 2-4 elements,
 140
 141   (numbered-open numbered-close)
 142
 143 or
 144
 145   (numbered-open numbered-close unnumbered-open unnumbered-close)
 146
 147 providing opening and closing strings for an environment that should
 148 represent the document section.  The opening clause should have a %s
 149 to represent the section title."
 150   :group 'org-export-latex
 151   :type '(repeat
 152           (list (string :tag "LaTeX class")
 153                 (string :tag "LaTeX header")
 154                 (repeat :tag "Levels" :inline t
 155                         (choice
 156                          (cons :tag "Heading"
 157                                (string :tag "numbered")
 158                                (string :tag "unnumbered)"))
 159                          (list :tag "Environment"
 160                                (string :tag "Opening (numbered)  ")
 161                                (string :tag "Closing (numbered)  ")
 162                                (string :tag "Opening (unnumbered)")
 163                                (string :tag "Closing (unnumbered)")))))))
 164
 165 (defcustom org-export-latex-emphasis-alist
 166   '(("*" "\\textbf{%s}" nil)
 167     ("/" "\\emph{%s}" nil)
 168     ("_" "\\underline{%s}" nil)
 169     ("+" "\\texttt{%s}" nil)
 170     ("=" "\\verb" t)
 171     ("~" "\\verb" t))
 172   "Alist of LaTeX expressions to convert emphasis fontifiers.
 173 Each element of the list is a list of three elements.
 174 The first element is the character used as a marker for fontification.
 175 The second element is a formatting string to wrap fontified text with.
 176 If it is \"\\verb\", Org will automatically select a deimiter
 177 character that is not in the string.
 178 The third element decides whether to protect converted text from other
 179 conversions."
 180   :group 'org-export-latex
 181   :type 'alist)
 182
 183 (defcustom org-export-latex-title-command "\\maketitle"
 184   "The command used to insert the title just after \\begin{document}.
 185 If this string contains the formatting specification \"%s\" then
 186 it will be used as a formatting string, passing the title as an
 187 argument."
 188   :group 'org-export-latex
 189   :type 'string)
 190
 191 (defcustom org-export-latex-import-inbuffer-stuff nil
 192   "Non-nil means define TeX macros for Org's inbuffer definitions.
 193 For example \orgTITLE for #+TITLE."
 194   :group 'org-export-latex
 195   :type 'boolean)
 196
 197 (defcustom org-export-latex-date-format
 198   "%d %B %Y"
 199   "Format string for \\date{...}."
 200   :group 'org-export-latex
 201   :type 'string)
 202
 203 (defcustom org-export-latex-todo-keyword-markup "\\textbf{%s}"
 204   "Markup for TODO keywords, as a printf format.
 205 This can be a single format for all keywords, a cons cell with separate
 206 formats for not-done and done states, or an association list with setup
 207 for individual keywords.  If a keyword shows up for which there is no
 208 markup defined, the first one in the association list will be used."
 209   :group 'org-export-latex
 210   :type '(choice
 211           (string :tag "Default")
 212           (cons :tag "Distinguish undone and done"
 213                 (string :tag "Not-DONE states")
 214                 (string :tag "DONE states"))
 215           (repeat :tag "Per keyword markup"
 216                   (cons
 217                    (string :tag "Keyword")
 218                    (string :tag "Markup")))))
 219
 220 (defcustom org-export-latex-timestamp-markup "\\textit{%s}"
 221   "A printf format string to be applied to time stamps."
 222   :group 'org-export-latex
 223   :type 'string)
 224
 225 (defcustom org-export-latex-timestamp-keyword-markup "\\texttt{%s}"
 226   "A printf format string to be applied to time stamps."
 227   :group 'org-export-latex
 228   :type 'string)
 229
 230 (defcustom org-export-latex-tables-verbatim nil
 231   "When non-nil, tables are exported verbatim."
 232   :group 'org-export-latex
 233   :type 'boolean)
 234
 235 (defcustom org-export-latex-tables-centered t
 236   "When non-nil, tables are exported in a center environment."
 237   :group 'org-export-latex
 238   :type 'boolean)
 239
 240 (defcustom org-export-latex-tables-column-borders nil
 241   "When non-nil, grouping columns can cause outer vertical lines in tables.
 242 When nil, grouping causes only separation lines between groups."
 243   :group 'org-export-latex
 244   :type 'boolean)
 245
 246 (defcustom org-export-latex-packages-alist nil
 247   "Alist of packages to be inserted in the header.
 248 Each cell is of the forma \( \"option\" . \"package\" \)."
 249   :group 'org-export-latex
 250   :type 'alist)
 251
 252 (defcustom org-export-latex-low-levels 'itemize
 253   "How to convert sections below the current level of sectioning.
 254 This is specified by the `org-export-headline-levels' option or the
 255 value of \"H:\" in Org's #+OPTION line.
 256
 257 This can be either nil (skip the sections), `description', `itemize',
 258 or `enumerate' (convert the sections as the corresponding list type), or
 259 a string to be used instead of \\section{%s}.  In this latter case,
 260 the %s stands here for the inserted headline and is mandatory."
 261   :group 'org-export-latex
 262   :type '(choice (const :tag "Ignore" nil)
 263                  (const :tag "Convert as descriptive list" description)
 264                  (const :tag "Convert as itemized list" itemize)
 265                  (const :tag "Convert as enumerated list" enumerate)
 266                  (string :tag "Use a section string" :value "\\subparagraph{%s}")))
 267
 268 (defcustom org-export-latex-list-parameters
 269   '(:cbon "\\texttt{[X]}" :cboff "\\texttt{[ ]}")
 270   "Parameters for the LaTeX list exporter.
 271 These parameters will be passed on to `org-list-to-latex', which in turn
 272 will pass them (combined with the LaTeX default list parameters) to
 273 `org-list-to-generic'."
 274   :group 'org-export-latex
 275   :type 'plist)
 276
 277 (defcustom org-export-latex-verbatim-wrap
 278   '("\\begin{verbatim}\n" . "\\end{verbatim}\n")
 279   "Environment to be wrapped around a fixed-width section in LaTeX export.
 280 This is a cons with two strings, to be added before and after the
 281 fixed-with text.
 282
 283 Defaults to \\begin{verbatim} and \\end{verbatim}."
 284   :group 'org-export_translation
 285   :group 'org-export-latex
 286   :type '(cons (string :tag "Open")
 287                (string :tag "Close")))
 288
 289 (defcustom org-export-latex-remove-from-headlines
 290   '(:todo nil :priority nil :tags nil)
 291   "A plist of keywords to remove from headlines. OBSOLETE.
 292 Non-nil means remove this keyword type from the headline.
 293
 294 Don't remove the keys, just change their values.
 295
 296 Obsolete, this variable is no longer used.  Use the separate
 297 variables `org-export-with-todo-keywords', `org-export-with-priority',
 298 and `org-export-with-tags' instead."
 299   :type 'plist
 300   :group 'org-export-latex)
 301
 302 (defcustom org-export-latex-image-default-option "width=10em"
 303   "Default option for images."
 304   :group 'org-export-latex
 305   :type 'string)
 306
 307 (defcustom org-export-latex-inline-image-extensions
 308   '("pdf" "jpeg" "jpg" "png")
 309   "Extensions of image files that can be inlined into LaTeX.
 310 Note that this depends on the way the LaTeX file is processed.
 311 The default setting (pdf and jpg) assumes that pdflatex is doing the
 312 processing.  If you are using latex and dvips or something similar,
 313 only postscript files can be included."
 314   :group 'org-export-latex
 315   :type '(repeat (string :tag "Extension")))
 316
 317 (defcustom org-export-latex-coding-system nil
 318   "Coding system for the exported LaTex file."
 319   :group 'org-export-latex
 320   :type 'coding-system)
 321
 322 (defgroup org-export-pdf nil
 323   "Options for exporting Org-mode files to PDF, via LaTeX."
 324   :tag "Org Export LaTeX"
 325   :group 'org-export-latex
 326   :group 'org-export)
 327
 328 (defcustom org-latex-to-pdf-process
 329   '("pdflatex -interaction nonstopmode %s"
 330     "pdflatex -interaction nonstopmode %s")
 331   "Commands to process a LaTeX file to a PDF file.
 332 This is a list of strings, each of them will be given to the shell
 333 as a command.  %s in the command will be replaced by the full file name, %b
 334 by the file base name (i.e. without extension).
 335 The reason why this is a list is that it usually takes several runs of
 336 pdflatex, maybe mixed with a call to bibtex.  Org does not have a clever
 337 mechanism to detect whihc of these commands have to be run to get to a stable
 338 result, and it also does not do any error checking.
 339
 340 Alternatively, this may be a Lisp function that does the processing, so you
 341 could use this to apply the machinery of AUCTeX or the Emacs LaTeX mode.
 342 THis function should accept the file name as its single argument."
 343   :group 'org-export-latex
 344   :type '(choice (repeat :tag "Shell command sequence"
 345                   (string :tag "Shell command"))
 346                  (function)))
 347
 348 (defcustom org-export-pdf-remove-logfiles t
 349   "Non-nil means, remove the logfiles produced by PDF production.
 350 These are the .aux, .log, .out, and .toc files."
 351   :group 'org-export-pdf
 352   :type 'boolean)
 353
 354 ;;; Hooks
 355
 356 (defvar org-export-latex-after-blockquotes-hook nil
 357   "Hook run during LaTeX export, after blockquote, verse, center are done.")
 358
 359 ;;; Autoload functions:
 360
 361 ;;;###autoload
 362 (defun org-export-as-latex-batch ()
 363   "Call `org-export-as-latex', may be used in batch processing.
 364 For example:
 365
 366 emacs   --batch
 367         --load=$HOME/lib/emacs/org.el
 368         --eval \"(setq org-export-headline-levels 2)\"
 369         --visit=MyFile --funcall org-export-as-latex-batch"
 370   (org-export-as-latex org-export-headline-levels 'hidden))
 371
 372 ;;;###autoload
 373 (defun org-export-as-latex-to-buffer (arg)
 374   "Call `org-export-as-latex` with output to a temporary buffer.
 375 No file is created.  The prefix ARG is passed through to `org-export-as-latex'."
 376   (interactive "P")
 377   (org-export-as-latex arg nil nil "*Org LaTeX Export*")
 378   (when org-export-show-temporary-export-buffer
 379     (switch-to-buffer-other-window "*Org LaTeX Export*")))
 380
 381 ;;;###autoload
 382 (defun org-replace-region-by-latex (beg end)
 383   "Replace the region from BEG to END with its LaTeX export.
 384 It assumes the region has `org-mode' syntax, and then convert it to
 385 LaTeX.  This can be used in any buffer.  For example, you could
 386 write an itemized list in `org-mode' syntax in an LaTeX buffer and
 387 then use this command to convert it."
 388   (interactive "r")
 389   (let (reg latex buf)
 390     (save-window-excursion
 391       (if (org-mode-p)
 392           (setq latex (org-export-region-as-latex
 393                        beg end t 'string))
 394         (setq reg (buffer-substring beg end)
 395               buf (get-buffer-create "*Org tmp*"))
 396         (save-excursion
 397           (set-buffer buf)
 398           (erase-buffer)
 399           (insert reg)
 400           (org-mode)
 401           (setq latex (org-export-region-as-latex
 402                        (point-min) (point-max) t 'string)))
 403         (kill-buffer buf)))
 404     (delete-region beg end)
 405     (insert latex)))
 406
 407 ;;;###autoload
 408 (defun org-export-region-as-latex (beg end &optional body-only buffer)
 409   "Convert region from BEG to END in `org-mode' buffer to LaTeX.
 410 If prefix arg BODY-ONLY is set, omit file header, footer, and table of
 411 contents, and only produce the region of converted text, useful for
 412 cut-and-paste operations.
 413 If BUFFER is a buffer or a string, use/create that buffer as a target
 414 of the converted LaTeX.  If BUFFER is the symbol `string', return the
 415 produced LaTeX as a string and leave no buffer behind.  For example,
 416 a Lisp program could call this function in the following way:
 417
 418   (setq latex (org-export-region-as-latex beg end t 'string))
 419
 420 When called interactively, the output buffer is selected, and shown
 421 in a window.  A non-interactive call will only return the buffer."
 422   (interactive "r\nP")
 423   (when (interactive-p)
 424     (setq buffer "*Org LaTeX Export*"))
 425   (let ((transient-mark-mode t) (zmacs-regions t)
 426         ext-plist rtn)
 427     (setq ext-plist (plist-put ext-plist :ignore-subree-p t))
 428     (goto-char end)
 429     (set-mark (point)) ;; to activate the region
 430     (goto-char beg)
 431     (setq rtn (org-export-as-latex
 432                nil nil ext-plist
 433                buffer body-only))
 434     (if (fboundp 'deactivate-mark) (deactivate-mark))
 435     (if (and (interactive-p) (bufferp rtn))
 436         (switch-to-buffer-other-window rtn)
 437       rtn)))
 438
 439 ;;;###autoload
 440 (defun org-export-as-latex (arg &optional hidden ext-plist
 441                                 to-buffer body-only pub-dir)
 442   "Export current buffer to a LaTeX file.
 443 If there is an active region, export only the region.  The prefix
 444 ARG specifies how many levels of the outline should become
 445 headlines.  The default is 3.  Lower levels will be exported
 446 depending on `org-export-latex-low-levels'.  The default is to
 447 convert them as description lists.
 448 HIDDEN is obsolete and does nothing.
 449 EXT-PLIST is a property list with
 450 external parameters overriding org-mode's default settings, but
 451 still inferior to file-local settings.  When TO-BUFFER is
 452 non-nil, create a buffer with that name and export to that
 453 buffer.  If TO-BUFFER is the symbol `string', don't leave any
 454 buffer behind but just return the resulting LaTeX as a string.
 455 When BODY-ONLY is set, don't produce the file header and footer,
 456 simply return the content of \begin{document}...\end{document},
 457 without even the \begin{document} and \end{document} commands.
 458 when PUB-DIR is set, use this as the publishing directory."
 459   (interactive "P")
 460   ;; Make sure we have a file name when we need it.
 461   (when (and (not (or to-buffer body-only))
 462              (not buffer-file-name))
 463     (if (buffer-base-buffer)
 464         (org-set-local 'buffer-file-name
 465                        (with-current-buffer (buffer-base-buffer)
 466                          buffer-file-name))
 467       (error "Need a file name to be able to export")))
 468
 469   (message "Exporting to LaTeX...")
 470   (org-unmodified
 471    (remove-text-properties (point-min) (point-max)
 472                            '(:org-license-to-kill nil)))
 473   (org-update-radio-target-regexp)
 474   (org-export-latex-set-initial-vars ext-plist arg)
 475   (let* ((wcf (current-window-configuration))
 476          (opt-plist org-export-latex-options-plist)
 477          (region-p (org-region-active-p))
 478          (rbeg (and region-p (region-beginning)))
 479          (rend (and region-p (region-end)))
 480          (subtree-p
 481           (if (plist-get opt-plist :ignore-subree-p)
 482               nil
 483             (when region-p
 484               (save-excursion
 485                 (goto-char rbeg)
 486                 (and (org-at-heading-p)
 487                      (>= (org-end-of-subtree t t) rend))))))
 488          (opt-plist (setq org-export-opt-plist
 489                           (if subtree-p
 490                               (org-export-add-subtree-options opt-plist rbeg)
 491                             opt-plist)))
 492          ;; Make sure the variable contains the updated values.
 493          (org-export-latex-options-plist opt-plist)
 494          (title (or (and subtree-p (org-export-get-title-from-subtree))
 495                     (plist-get opt-plist :title)
 496                     (and (not
 497                           (plist-get opt-plist :skip-before-1st-heading))
 498                          (org-export-grab-title-from-buffer))
 499                     (file-name-sans-extension
 500                      (file-name-nondirectory buffer-file-name))))
 501          (filename (concat (file-name-as-directory
 502                             (or pub-dir
 503                                 (org-export-directory :LaTeX ext-plist)))
 504                            (file-name-sans-extension
 505                             (or (and subtree-p
 506                                      (org-entry-get rbeg "EXPORT_FILE_NAME" t))
 507                                 (file-name-nondirectory ;sans-extension
 508                                  buffer-file-name)))
 509                            ".tex"))
 510          (filename (if (equal (file-truename filename)
 511                               (file-truename buffer-file-name))
 512                        (concat filename ".tex")
 513                      filename))
 514          (buffer (if to-buffer
 515                      (cond
 516                       ((eq to-buffer 'string) (get-buffer-create
 517                                                "*Org LaTeX Export*"))
 518                       (t (get-buffer-create to-buffer)))
 519                    (find-file-noselect filename)))
 520          (odd org-odd-levels-only)
 521          (header (org-export-latex-make-header title opt-plist))
 522          (skip (cond (subtree-p nil)
 523                      (region-p nil)
 524                      (t (plist-get opt-plist :skip-before-1st-heading))))
 525          (text (plist-get opt-plist :text))
 526          (org-export-preprocess-hook
 527           (cons
 528            `(lambda () (org-set-local 'org-complex-heading-regexp
 529                                       ,org-export-latex-complex-heading-re))
 530            org-export-preprocess-hook))
 531          (first-lines (if skip "" (org-export-latex-first-lines
 532                                    opt-plist
 533                                    (if subtree-p
 534                                        (save-excursion
 535                                          (goto-char rbeg)
 536                                          (point-at-bol 2))
 537                                      rbeg)
 538                                    (if region-p rend))))
 539          (coding-system (and (boundp 'buffer-file-coding-system)
 540                              buffer-file-coding-system))
 541          (coding-system-for-write (or org-export-latex-coding-system
 542                                       coding-system))
 543          (save-buffer-coding-system (or org-export-latex-coding-system
 544                                         coding-system))
 545          (region (buffer-substring
 546                   (if region-p (region-beginning) (point-min))
 547                   (if region-p (region-end) (point-max))))
 548          (string-for-export
 549           (org-export-preprocess-string
 550            region
 551            :emph-multiline t
 552            :for-LaTeX t
 553            :comments nil
 554            :tags (plist-get opt-plist :tags)
 555            :priority (plist-get opt-plist :priority)
 556            :footnotes (plist-get opt-plist :footnotes)
 557            :timestamps (plist-get opt-plist :timestamps)
 558            :todo-keywords (plist-get opt-plist :todo-keywords)
 559            :add-text (if (eq to-buffer 'string) nil text)
 560            :skip-before-1st-heading skip
 561            :select-tags (plist-get opt-plist :select-tags)
 562            :exclude-tags (plist-get opt-plist :exclude-tags)
 563            :LaTeX-fragments nil)))
 564
 565     (set-buffer buffer)
 566     (erase-buffer)
 567
 568     (and (fboundp 'set-buffer-file-coding-system)
 569          (set-buffer-file-coding-system coding-system-for-write))
 570
 571     ;; insert the header and initial document commands
 572     (unless (or (eq to-buffer 'string) body-only)
 573       (insert header))
 574
 575     ;; insert text found in #+TEXT
 576     (when (and text (not (eq to-buffer 'string)))
 577       (insert (org-export-latex-content
 578                text '(lists tables fixed-width keywords))
 579                "\n\n"))
 580
 581     ;; insert lines before the first headline
 582     (unless skip
 583       (insert first-lines))
 584
 585     ;; export the content of headlines
 586     (org-export-latex-global
 587      (with-temp-buffer
 588        (insert string-for-export)
 589        (goto-char (point-min))
 590        (when (re-search-forward "^\\(\\*+\\) " nil t)
 591          (let* ((asters (length (match-string 1)))
 592                 (level (if odd (- asters 2) (- asters 1))))
 593            (setq org-export-latex-add-level
 594                  (if odd (1- (/ (1+ asters) 2)) (1- asters)))
 595            (org-export-latex-parse-global level odd)))))
 596
 597     ;; finalization
 598     (unless body-only (insert "\n\\end{document}"))
 599
 600     ;; Relocate the table of contents
 601     (goto-char (point-min))
 602     (when (re-search-forward "\\[TABLE-OF-CONTENTS\\]" nil t)
 603       (goto-char (point-min))
 604       (while (re-search-forward "\\\\tableofcontents\\>[ \t]*\n?" nil t)
 605         (replace-match ""))
 606       (goto-char (point-min))
 607       (and (re-search-forward "\\[TABLE-OF-CONTENTS\\]" nil t)
 608            (replace-match "\\tableofcontents" t t)))
 609
 610     (or to-buffer (save-buffer))
 611     (goto-char (point-min))
 612     (or (org-export-push-to-kill-ring "LaTeX")
 613         (message "Exporting to LaTeX...done"))
 614     (prog1
 615         (if (eq to-buffer 'string)
 616             (prog1 (buffer-substring (point-min) (point-max))
 617               (kill-buffer (current-buffer)))
 618           (current-buffer))
 619       (set-window-configuration wcf))))
 620
 621 ;;;###autoload
 622 (defun org-export-as-pdf (arg &optional hidden ext-plist
 623                               to-buffer body-only pub-dir)
 624   "Export as LaTeX, then process through to PDF."
 625   (interactive "P")
 626   (message "Exporting to PDF...")
 627   (let* ((wconfig (current-window-configuration))
 628          (lbuf (org-export-as-latex arg hidden ext-plist
 629                                     to-buffer body-only pub-dir))
 630          (file (buffer-file-name lbuf))
 631          (base (file-name-sans-extension (buffer-file-name lbuf)))
 632          (pdffile (concat base ".pdf"))
 633          (cmds org-latex-to-pdf-process)
 634          (outbuf (get-buffer-create "*Org PDF LaTeX Output*"))
 635          (bibtex-p (with-current-buffer lbuf
 636                      (save-excursion
 637                        (goto-char (point-min))
 638                        (re-search-forward "\\\\bibliography{" nil t))))
 639          cmd)
 640     (with-current-buffer outbuf (erase-buffer))
 641     (and (file-exists-p pdffile) (delete-file pdffile))
 642     (message "Processing LaTeX file...")
 643     (if (and cmds (symbolp cmds))
 644         (funcall cmds file)
 645       (while cmds
 646         (setq cmd (pop cmds))
 647         (while (string-match "%b" cmd)
 648           (setq cmd (replace-match (shell-quote-argument base) t t cmd)))
 649         (while (string-match "%s" cmd)
 650           (setq cmd (replace-match (shell-quote-argument file) t t cmd)))
 651         (shell-command cmd outbuf outbuf)))
 652     (message "Processing LaTeX file...done")
 653     (if (not (file-exists-p pdffile))
 654         (error "PDF file was not produced")
 655       (set-window-configuration wconfig)
 656       (when org-export-pdf-remove-logfiles
 657         (dolist (ext '("aux" "log" "out" "toc"))
 658           (setq file (concat base "." ext))
 659           (and (file-exists-p file) (delete-file file))))
 660       (message "Exporting to PDF...done")
 661       pdffile)))
 662
 663 ;;;###autoload
 664 (defun org-export-as-pdf-and-open (arg)
 665   "Export as LaTeX, then process through to PDF, and open."
 666   (interactive "P")
 667   (let ((pdffile (org-export-as-pdf arg)))
 668     (if pdffile
 669         (org-open-file pdffile)
 670       (error "PDF file was not produced"))))
 671
 672 ;;; Parsing functions:
 673
 674 (defun org-export-latex-parse-global (level odd)
 675   "Parse the current buffer recursively, starting at LEVEL.
 676 If ODD is non-nil, assume the buffer only contains odd sections.
 677 Return a list reflecting the document structure."
 678   (save-excursion
 679     (goto-char (point-min))
 680     (let* ((cnt 0) output
 681            (depth org-export-latex-sectioning-depth))
 682       (while (re-search-forward
 683               (concat "^\\(\\(?:\\*\\)\\{"
 684                       (number-to-string (+ (if odd 2 1) level))
 685                       "\\}\\) \\(.*\\)$")
 686               ;; make sure that there is no upper heading
 687               (when (> level 0)
 688                 (save-excursion
 689                   (save-match-data
 690                     (re-search-forward
 691                      (concat "^\\(\\(?:\\*\\)\\{"
 692                              (number-to-string level)
 693                              "\\}\\) \\(.*\\)$") nil t)))) t)
 694         (setq cnt (1+ cnt))
 695         (let* ((pos (match-beginning 0))
 696                (heading (match-string 2))
 697                (nlevel (if odd (/ (+ 3 level) 2) (1+ level))))
 698           (save-excursion
 699             (narrow-to-region
 700              (point)
 701              (save-match-data
 702                (if (re-search-forward
 703                     (concat "^\\(\\(?:\\*\\)\\{"
 704                             (number-to-string (+ (if odd 2 1) level))
 705                             "\\}\\) \\(.*\\)$") nil t)
 706                    (match-beginning 0)
 707                  (point-max))))
 708             (goto-char (point-min))
 709             (setq output
 710                   (append output
 711                           (list
 712                            (list
 713                             `(pos . ,pos)
 714                             `(level . ,nlevel)
 715                             `(occur . ,cnt)
 716                             `(heading . ,heading)
 717                             `(content . ,(org-export-latex-parse-content))
 718                             `(subcontent . ,(org-export-latex-parse-subcontent
 719                                              level odd)))))))
 720           (widen)))
 721       (list output))))
 722
 723 (defun org-export-latex-parse-content ()
 724   "Extract the content of a section."
 725   (let ((beg (point))
 726         (end (if (re-search-forward "^\\(\\*\\)+ .*$" nil t)
 727                  (progn (beginning-of-line) (point))
 728                (point-max))))
 729     (buffer-substring beg end)))
 730
 731 (defun org-export-latex-parse-subcontent (level odd)
 732   "Extract the subcontent of a section at LEVEL.
 733 If ODD Is non-nil, assume subcontent only contains odd sections."
 734   (if (not (re-search-forward
 735             (concat "^\\(\\(?:\\*\\)\\{"
 736                     (number-to-string (+ (if odd 4 2) level))
 737                     "\\}\\) \\(.*\\)$")
 738             nil t))
 739       nil ; subcontent is nil
 740     (org-export-latex-parse-global (+ (if odd 2 1) level) odd)))
 741
 742 ;;; Rendering functions:
 743 (defun org-export-latex-global (content)
 744   "Export CONTENT to LaTeX.
 745 CONTENT is an element of the list produced by
 746 `org-export-latex-parse-global'."
 747   (if (eq (car content) 'subcontent)
 748       (mapc 'org-export-latex-sub (cdr content))
 749     (org-export-latex-sub (car content))))
 750
 751 (defun org-export-latex-sub (subcontent)
 752   "Export the list SUBCONTENT to LaTeX.
 753 SUBCONTENT is an alist containing information about the headline
 754 and its content."
 755   (let ((num (plist-get org-export-latex-options-plist :section-numbers)))
 756     (mapc (lambda(x) (org-export-latex-subcontent x num)) subcontent)))
 757
 758 (defun org-export-latex-subcontent (subcontent num)
 759   "Export each cell of SUBCONTENT to LaTeX.
 760 If NUM, export sections as numerical sections."
 761   (let* ((heading (org-export-latex-fontify-headline
 762                    (cdr (assoc 'heading subcontent))))
 763          (level (- (cdr (assoc 'level subcontent))
 764                    org-export-latex-add-level))
 765          (occur (number-to-string (cdr (assoc 'occur subcontent))))
 766          (content (cdr (assoc 'content subcontent)))
 767          (subcontent (cadr (assoc 'subcontent subcontent)))
 768          (label (org-get-text-property-any 0 'target heading))
 769          (label-list (cons label (cdr (assoc label
 770                                              org-export-target-aliases)))))
 771     (cond
 772      ;; Normal conversion
 773      ((<= level org-export-latex-sectioning-depth)
 774       (let* ((sec (nth (1- level) org-export-latex-sectioning))
 775              start end)
 776         (if (consp (cdr sec))
 777             (setq start (nth (if num 0 2) sec)
 778                   end (nth (if num 1 3) sec))
 779           (setq start (if num (car sec) (cdr sec))))
 780         (insert (format start heading) "\n")
 781         (when label
 782           (insert (mapconcat (lambda (l) (format "\\label{%s}" l))
 783                              label-list "\n") "\n"))
 784         (insert (org-export-latex-content content))
 785         (cond ((stringp subcontent) (insert subcontent))
 786               ((listp subcontent) (org-export-latex-sub subcontent)))
 787         (if end (insert end "\n"))))
 788      ;; At a level under the hl option: we can drop this subsection
 789      ((> level org-export-latex-sectioning-depth)
 790       (cond ((eq org-export-latex-low-levels 'description)
 791              (if (string-match "% ends low level$"
 792                                (buffer-substring (point-at-bol 0) (point)))
 793                  (delete-region (point-at-bol 0) (point))
 794                (insert "\\begin{description}\n"))
 795              (insert (format "\n\\item[%s]%s~\n\n"
 796                              heading
 797                              (if label (format "\\label{%s}" label) "")))
 798              (insert (org-export-latex-content content))
 799              (cond ((stringp subcontent) (insert subcontent))
 800                    ((listp subcontent) (org-export-latex-sub subcontent)))
 801              (insert "\\end{description} % ends low level\n"))
 802             ((memq org-export-latex-low-levels '(itemize enumerate))
 803              (if (string-match "% ends low level$"
 804                                (buffer-substring (point-at-bol 0) (point)))
 805                  (delete-region (point-at-bol 0) (point))
 806                (insert (format "\\begin{%s}\n"
 807                                (symbol-name org-export-latex-low-levels))))
 808              (insert (format "\n\\item %s\\\\\n%s\n"
 809                              heading
 810                              (if label (format "\\label{%s}" label) "")))
 811              (insert (org-export-latex-content content))
 812              (cond ((stringp subcontent) (insert subcontent))
 813                    ((listp subcontent) (org-export-latex-sub subcontent)))
 814              (insert (format "\\end{%s} %% ends low level\n"
 815                              (symbol-name org-export-latex-low-levels))))
 816             ((stringp org-export-latex-low-levels)
 817              (insert (format org-export-latex-low-levels heading) "\n")
 818              (when label (insert (format "\\label{%s}\n" label)))
 819              (insert (org-export-latex-content content))
 820              (cond ((stringp subcontent) (insert subcontent))
 821                    ((listp subcontent) (org-export-latex-sub subcontent)))))))))
 822
 823 ;;; Exporting internals:
 824 (defun org-export-latex-set-initial-vars (ext-plist level)
 825   "Store org local variables required for LaTeX export.
 826 EXT-PLIST is an optional additional plist.
 827 LEVEL indicates the default depth for export."
 828   (setq org-export-latex-todo-keywords-1 org-todo-keywords-1
 829         org-export-latex-done-keywords org-done-keywords
 830         org-export-latex-not-done-keywords org-not-done-keywords
 831         org-export-latex-complex-heading-re org-complex-heading-regexp
 832         org-export-latex-display-custom-times org-display-custom-times
 833         org-export-latex-all-targets-re
 834         (org-make-target-link-regexp (org-all-targets))
 835         org-export-latex-options-plist
 836         (org-combine-plists (org-default-export-plist) ext-plist
 837                             (org-infile-export-plist))
 838         org-export-latex-class
 839         (or (and (org-region-active-p)
 840                  (save-excursion
 841                    (goto-char (region-beginning))
 842                    (and (looking-at org-complex-heading-regexp)
 843                         (org-entry-get nil "LaTeX_CLASS" 'selective))))
 844             (save-excursion
 845               (save-restriction
 846                 (widen)
 847                 (goto-char (point-min))
 848                 (and (re-search-forward "^#\\+LaTeX_CLASS:[ \t]*\\([a-zA-Z]+\\)" nil t)
 849                      (match-string 1))))
 850             org-export-latex-default-class)
 851         org-export-latex-class
 852         (or (car (assoc org-export-latex-class org-export-latex-classes))
 853             (error "No definition for class `%s' in `org-export-latex-classes'"
 854                    org-export-latex-class))
 855         org-export-latex-header
 856         (cadr (assoc org-export-latex-class org-export-latex-classes))
 857         org-export-latex-sectioning
 858         (cddr (assoc org-export-latex-class org-export-latex-classes))
 859         org-export-latex-sectioning-depth
 860         (or level
 861             (let ((hl-levels
 862                    (plist-get org-export-latex-options-plist :headline-levels))
 863                   (sec-depth (length org-export-latex-sectioning)))
 864               (if (> hl-levels sec-depth) sec-depth hl-levels)))))
 865
 866 (defun org-export-latex-make-header (title opt-plist)
 867   "Make the LaTeX header and return it as a string.
 868 TITLE is the current title from the buffer or region.
 869 OPT-PLIST is the options plist for current buffer."
 870   (let ((toc (plist-get opt-plist :table-of-contents))
 871         (author (plist-get opt-plist :author)))
 872     (concat
 873      (if (plist-get opt-plist :time-stamp-file)
 874          (format-time-string "%% Created %Y-%m-%d %a %H:%M\n"))
 875      ;; insert LaTeX custom header
 876      (org-export-apply-macros-in-string org-export-latex-header)
 877      "\n"
 878      ;; insert information on LaTeX packages
 879      (when org-export-latex-packages-alist
 880        (mapconcat (lambda(p)
 881                     (if (equal "" (car p))
 882                         (format "\\usepackage{%s}" (cadr p))
 883                       (format "\\usepackage[%s]{%s}"
 884                               (car p) (cadr p))))
 885                   org-export-latex-packages-alist "\n"))
 886      ;; insert additional commands in the header
 887      (org-export-apply-macros-in-string
 888       (plist-get opt-plist :latex-header-extra))
 889      (org-export-apply-macros-in-string org-export-latex-append-header)
 890      ;; insert the title
 891      (format
 892       "\n\n\\title{%s}\n"
 893       ;; convert the title
 894       (org-export-latex-content
 895        title '(lists tables fixed-width keywords)))
 896      ;; insert author info
 897      (if (plist-get opt-plist :author-info)
 898          (format "\\author{%s}\n"
 899                  (or author user-full-name))
 900        (format "%%\\author{%s}\n"
 901                (or author user-full-name)))
 902      ;; insert the date
 903      (format "\\date{%s}\n"
 904              (format-time-string
 905               (or (plist-get opt-plist :date)
 906                   org-export-latex-date-format)))
 907      ;; beginning of the document
 908      "\n\\begin{document}\n\n"
 909      ;; insert the title command
 910      (if (string-match "%s" org-export-latex-title-command)
 911          (format org-export-latex-title-command title)
 912        org-export-latex-title-command)
 913      "\n\n"
 914      ;; table of contents
 915      (when (and org-export-with-toc
 916                 (plist-get opt-plist :section-numbers))
 917        (cond ((numberp toc)
 918               (format "\\setcounter{tocdepth}{%s}\n\\tableofcontents\n\\vspace*{1cm}\n"
 919                       (min toc (plist-get opt-plist :headline-levels))))
 920              (toc (format "\\setcounter{tocdepth}{%s}\n\\tableofcontents\n\\vspace*{1cm}\n"
 921                           (plist-get opt-plist :headline-levels))))))))
 922
 923 (defun org-export-latex-first-lines (opt-plist &optional beg end)
 924   "Export the first lines before first headline.
 925 If BEG is non-nil, it is the beginning of the region.
 926 If END is non-nil, it is the end of the region."
 927   (save-excursion
 928     (goto-char (or beg (point-min)))
 929     (let* ((pt (point))
 930            (end (if (re-search-forward "^\\*+ " end t)
 931                     (goto-char (match-beginning 0))
 932                   (goto-char (point-max)))))
 933       (prog1
 934           (org-export-latex-content
 935            (org-export-preprocess-string
 936             (buffer-substring pt end)
 937             :for-LaTeX t
 938             :emph-multiline t
 939             :add-text nil
 940             :comments nil
 941             :skip-before-1st-heading nil
 942             :LaTeX-fragments nil
 943             :timestamps (plist-get opt-plist :timestamps)
 944             :footnotes (plist-get opt-plist :footnotes)))
 945         (org-unmodified
 946          (add-text-properties pt (max pt (1- end))
 947                               '(:org-license-to-kill t)))))))
 948
 949 (defvar org-export-latex-header-defs nil
 950   "The header definitions that might be used in the LaTeX body.")
 951 (defvar org-export-latex-header-defs-re nil
 952   "The header definitions that might be used in the LaTeX body.")
 953
 954 (defun org-export-latex-content (content &optional exclude-list)
 955   "Convert CONTENT string to LaTeX.
 956 Don't perform conversions that are in EXCLUDE-LIST.  Recognized
 957 conversion types are: quotation-marks, emphasis, sub-superscript,
 958 links, keywords, lists, tables, fixed-width"
 959   (with-temp-buffer
 960    (insert content)
 961    (unless (memq 'timestamps exclude-list)
 962      (org-export-latex-time-stamps))
 963    (unless (memq 'quotation-marks exclude-list)
 964      (org-export-latex-quotation-marks))
 965    (unless (memq 'emphasis exclude-list)
 966      (when (plist-get org-export-latex-options-plist :emphasize)
 967        (org-export-latex-fontify)))
 968    (unless (memq 'sub-superscript exclude-list)
 969      (org-export-latex-special-chars
 970       (plist-get org-export-latex-options-plist :sub-superscript)))
 971    (unless (memq 'links exclude-list)
 972      (org-export-latex-links))
 973    (unless (memq 'keywords exclude-list)
 974      (org-export-latex-keywords))
 975    (unless (memq 'lists exclude-list)
 976      (org-export-latex-lists))
 977    (unless (memq 'tables exclude-list)
 978      (org-export-latex-tables
 979       (plist-get org-export-latex-options-plist :tables)))
 980    (unless (memq 'fixed-width exclude-list)
 981      (org-export-latex-fixed-width
 982       (plist-get org-export-latex-options-plist :fixed-width)))
 983    ;; return string
 984    (buffer-substring (point-min) (point-max))))
 985
 986 (defun org-export-latex-protect-string (s)
 987   "Add the org-protected property to string S."
 988   (add-text-properties 0 (length s) '(org-protected t) s) s)
 989
 990 (defun org-export-latex-protect-char-in-string (char-list string)
 991   "Add org-protected text-property to char from CHAR-LIST in STRING."
 992   (with-temp-buffer
 993     (save-match-data
 994       (insert string)
 995       (goto-char (point-min))
 996       (while (re-search-forward (regexp-opt char-list) nil t)
 997         (add-text-properties (match-beginning 0)
 998                              (match-end 0) '(org-protected t)))
 999       (buffer-string))))
1000
1001 (defun org-export-latex-keywords-maybe (&optional remove-list)
1002   "Maybe remove keywords depending on rules in REMOVE-LIST."
1003   (goto-char (point-min))
1004   (let ((re-todo (mapconcat 'identity org-export-latex-todo-keywords-1 "\\|"))
1005         (case-fold-search nil)
1006         (todo-markup org-export-latex-todo-keyword-markup)
1007         fmt)
1008     ;; convert TODO keywords
1009     (when (re-search-forward (concat "^\\(" re-todo "\\)") nil t)
1010       (if (plist-get remove-list :todo)
1011           (replace-match "")
1012         (setq fmt (cond
1013                    ((stringp todo-markup) todo-markup)
1014                    ((and (consp todo-markup) (stringp (car todo-markup)))
1015                     (if (member (match-string 1) org-export-latex-done-keywords)
1016                         (cdr todo-markup) (car todo-markup)))
1017                    (t (cdr (or (assoc (match-string 1) todo-markup)
1018                                (car todo-markup))))))
1019         (replace-match (format fmt (match-string 1)) t t)))
1020     ;; convert priority string
1021     (when (re-search-forward "\\[\\\\#.\\]" nil t)
1022       (if (plist-get remove-list :priority)
1023           (replace-match "")
1024         (replace-match (format "\\textbf{%s}" (match-string 0)) t t)))
1025     ;; convert tags
1026     (when (re-search-forward "\\(:[a-zA-Z0-9_@]+\\)+:" nil t)
1027       (if (or (not org-export-with-tags)
1028               (plist-get remove-list :tags))
1029           (replace-match "")
1030         (replace-match
1031          (org-export-latex-protect-string
1032           (format "\\textbf{%s}"
1033                   (save-match-data
1034                     (replace-regexp-in-string
1035                      "_" "\\\\_" (match-string 0)))))
1036          t t)))))
1037
1038 (defun org-export-latex-fontify-headline (string)
1039   "Fontify special words in STRING."
1040   (with-temp-buffer
1041     ;; FIXME: org-inside-LaTeX-fragment-p doesn't work when the $...$ is at
1042     ;; the beginning of the buffer - inserting "\n" is safe here though.
1043     (insert "\n" string)
1044     (goto-char (point-min))
1045     (when (plist-get org-export-latex-options-plist :emphasize)
1046       (org-export-latex-fontify))
1047     (org-export-latex-keywords-maybe)
1048     (org-export-latex-special-chars
1049      (plist-get org-export-latex-options-plist :sub-superscript))
1050     (org-export-latex-links)
1051     (org-trim (buffer-string))))
1052
1053 (defun org-export-latex-time-stamps ()
1054   "Format time stamps."
1055   (goto-char (point-min))
1056   (let ((org-display-custom-times org-export-latex-display-custom-times))
1057     (while (re-search-forward org-ts-regexp-both nil t)
1058       (org-if-unprotected-at (1- (point))
1059        (replace-match
1060         (org-export-latex-protect-string
1061          (format org-export-latex-timestamp-markup
1062                  (substring (org-translate-time (match-string 0)) 1 -1)))
1063         t t)))))
1064
1065 (defun org-export-latex-quotation-marks ()
1066   "Export quotation marks depending on language conventions."
1067   (let* ((lang (plist-get org-export-latex-options-plist :language))
1068          (quote-rpl (if (equal lang "fr")
1069                         '(("\\(\\s-\\)\"" "«~")
1070                           ("\\(\\S-\\)\"" "~»")
1071                           ("\\(\\s-\\)'" "`"))
1072                       '(("\\(\\s-\\)\"" "``")
1073                         ("\\(\\S-\\)\"" "''")
1074                         ("\\(\\s-\\)'" "`")))))
1075     (mapc (lambda(l) (goto-char (point-min))
1076             (while (re-search-forward (car l) nil t)
1077               (let ((rpl (concat (match-string 1) (cadr l))))
1078                 (org-export-latex-protect-string rpl)
1079                 (org-if-unprotected-1
1080                  (replace-match rpl t t))))) quote-rpl)))
1081
1082 (defun org-export-latex-special-chars (sub-superscript)
1083   "Export special characters to LaTeX.
1084 If SUB-SUPERSCRIPT is non-nil, convert \\ and ^.
1085 See the `org-export-latex.el' code for a complete conversion table."
1086   (goto-char (point-min))
1087   (mapc (lambda(c)
1088           (goto-char (point-min))
1089           (while (re-search-forward c nil t)
1090             ;; Put the point where to check for org-protected
1091             (unless (get-text-property (match-beginning 2) 'org-protected)
1092               (cond ((member (match-string 2) '("\\$" "$"))
1093                      (if (equal (match-string 2) "\\$")
1094                          nil
1095                        (replace-match "\\$" t t)))
1096                     ((member (match-string 2) '("&" "%" "#"))
1097                      (if (equal (match-string 1) "\\")
1098                          (replace-match (match-string 2) t t)
1099                        (replace-match (concat (match-string 1) "\\"
1100                                               (match-string 2)) t t)))
1101                     ((equal (match-string 2) "...")
1102                      (replace-match
1103                       (concat (match-string 1)
1104                               (org-export-latex-protect-string "\\ldots{}")) t t))
1105                     ((equal (match-string 2) "~")
1106                      (cond ((equal (match-string 1) "\\") nil)
1107                            ((eq 'org-link (get-text-property 0 'face (match-string 2)))
1108                             (replace-match (concat (match-string 1) "\\~") t t))
1109                            (t (replace-match
1110                                (org-export-latex-protect-string
1111                                 (concat (match-string 1) "\\~{}")) t t))))
1112                     ((member (match-string 2) '("{" "}"))
1113                      (unless (save-match-data (org-inside-latex-math-p))
1114                        (if (equal (match-string 1) "\\")
1115                            (replace-match (match-string 2) t t)
1116                          (replace-match (concat (match-string 1) "\\"
1117                                                 (match-string 2)) t t)))))
1118               (unless (save-match-data (org-inside-latex-math-p))
1119                 (cond ((equal (match-string 2) "\\")
1120                        (replace-match (or (save-match-data
1121                                             (org-export-latex-treat-backslash-char
1122                                              (match-string 1)
1123                                              (or (match-string 3) "")))
1124                                           "") t t))
1125                       ((member (match-string 2) '("_" "^"))
1126                        (replace-match (or (save-match-data
1127                                             (org-export-latex-treat-sub-super-char
1128                                              sub-superscript
1129                                              (match-string 2)
1130                                              (match-string 1)
1131                                              (match-string 3))) "") t t)))))))
1132         '(;"^\\([^\n$]*?\\|^\\)\\(\\\\?\\$\\)\\([^\n$]*\\)$"
1133           "\\(\\(\\\\?\\$\\)\\)"
1134           "\\([a-za-z0-9]+\\|[ \t\n]\\|\\b\\|\\\\\\)\\(_\\|\\^\\)\\({[^{}]+}\\|[a-za-z0-9]+\\|[ \t\n]\\|[:punct:]\\|{[a-za-z0-9]+}\\|([a-za-z0-9]+)\\)"
1135           "\\(.\\|^\\)\\(\\\\\\)\\([ \t\n]\\|[a-zA-Z&#%{}\"]+\\)"
1136           "\\(.\\|^\\)\\(&\\)"
1137           "\\(.\\|^\\)\\(#\\)"
1138           "\\(.\\|^\\)\\(%\\)"
1139           "\\(.\\|^\\)\\({\\)"
1140           "\\(.\\|^\\)\\(}\\)"
1141           "\\(.\\|^\\)\\(~\\)"
1142           "\\(.\\|^\\)\\(\\.\\.\\.\\)"
1143           ;; (?\< . "\\textless{}")
1144           ;; (?\> . "\\textgreater{}")
1145           )))
1146
1147 (defun org-inside-latex-math-p ()
1148   (get-text-property (point) 'org-latex-math))
1149
1150 (defun org-export-latex-treat-sub-super-char
1151   (subsup char string-before string-after)
1152   "Convert the \"_\" and \"^\" characters to LaTeX.
1153 SUBSUP corresponds to the ^: option in the #+OPTIONS line.
1154 Convert CHAR depending on STRING-BEFORE and STRING-AFTER."
1155   (cond ((equal string-before "\\")
1156          (concat string-before char string-after))
1157         ;; this is part of a math formula
1158         ((and (string-match "\\S-+" string-before)
1159               (string-match "\\S-+" string-after))
1160          (cond ((eq 'org-link (get-text-property 0 'face char))
1161                 (concat string-before "\\" char string-after))
1162                ((save-match-data (org-inside-latex-math-p))
1163                 (if subsup
1164                     (cond ((eq 1 (length string-after))
1165                            (concat string-before char string-after))
1166                           ((string-match "[({]?\\([^)}]+\\)[)}]?" string-after)
1167                            (format "%s%s{%s}" string-before char
1168                                    (match-string 1 string-after))))))
1169                ((and (> (length string-after) 1)
1170                      (or (eq subsup t)
1171                          (and (equal subsup '{}) (eq (string-to-char string-after) ?\{)))
1172                      (string-match "[({]?\\([^)}]+\\)[)}]?" string-after))
1173                 (org-export-latex-protect-string
1174                  (format "%s$%s{%s}$" string-before char
1175                          (if (and (> (match-end 1) (1+ (match-beginning 1)))
1176                                   (not (equal (substring string-after 0 2) "{\\")))
1177                              (concat "\\mathrm{" (match-string 1 string-after) "}")
1178                            (match-string 1 string-after)))))
1179                ((eq subsup t) (concat string-before "$" char string-after "$"))
1180                (t (org-export-latex-protect-string
1181                    (concat string-before "\\" char "{}" string-after)))))
1182         (t (org-export-latex-protect-string
1183             (concat string-before "\\" char "{}" string-after)))))
1184
1185 (defun org-export-latex-treat-backslash-char (string-before string-after)
1186   "Convert the \"$\" special character to LaTeX.
1187 The conversion is made depending of STRING-BEFORE and STRING-AFTER."
1188   (cond ((member (list string-after) org-html-entities)
1189          ;; backslash is part of a special entity (like "\alpha")
1190          (concat string-before "$\\"
1191                  (or (cdar (member (list string-after) org-html-entities))
1192                      string-after) "$"))
1193         ((and (not (string-match "^[ \n\t]" string-after))
1194               (not (string-match "[ \t]\\'\\|^" string-before)))
1195          ;; backslash is inside a word
1196          (org-export-latex-protect-string
1197           (concat string-before "\\textbackslash{}" string-after)))
1198         ((not (or (equal string-after "")
1199                   (string-match "^[ \t\n]" string-after)))
1200          ;; backslash might escape a character (like \#) or a user TeX
1201          ;; macro (like \setcounter)
1202          (org-export-latex-protect-string
1203           (concat string-before "\\" string-after)))
1204         ((and (string-match "^[ \t\n]" string-after)
1205               (string-match "[ \t\n]\\'" string-before))
1206          ;; backslash is alone, convert it to $\backslash$
1207          (org-export-latex-protect-string
1208           (concat string-before "\\textbackslash{}" string-after)))
1209         (t (org-export-latex-protect-string
1210             (concat string-before "\\textbackslash{}" string-after)))))
1211
1212 (defun org-export-latex-keywords ()
1213   "Convert special keywords to LaTeX."
1214   (goto-char (point-min))
1215   (while (re-search-forward org-export-latex-special-keyword-regexp nil t)
1216     (replace-match (format org-export-latex-timestamp-keyword-markup
1217                            (match-string 0)) t t)
1218     (save-excursion
1219       (beginning-of-line 1)
1220       (unless (looking-at ".*\\\\newline[ \t]*$")
1221         (end-of-line 1)
1222         (insert "\\newline")))))
1223
1224 (defun org-export-latex-fixed-width (opt)
1225   "When OPT is non-nil convert fixed-width sections to LaTeX."
1226   (goto-char (point-min))
1227   (while (re-search-forward "^[ \t]*:\\([ \t]\\|$\\)" nil t)
1228     (if opt
1229         (progn (goto-char (match-beginning 0))
1230                (insert "\\begin{verbatim}\n")
1231                (while (looking-at "^\\([ \t]*\\):\\(\\([ \t]\\|$\\).*\\)$")
1232                  (replace-match (concat (match-string 1)
1233                                         (match-string 2)) t t)
1234                  (forward-line))
1235                (insert "\\end{verbatim}\n\n"))
1236       (progn (goto-char (match-beginning 0))
1237              (while (looking-at "^\\([ \t]*\\):\\(\\([ \t]\\|$\\).*\\)$")
1238                (replace-match (concat "%" (match-string 1)
1239                                       (match-string 2)) t t)
1240                (forward-line))))))
1241
1242
1243 (defvar org-table-last-alignment) ; defined in org-table.el
1244 (declare-function orgtbl-to-latex "org-table" (table params) t)
1245 (defun org-export-latex-tables (insert)
1246   "Convert tables to LaTeX and INSERT it."
1247   (goto-char (point-min))
1248   (while (re-search-forward "^\\([ \t]*\\)|" nil t)
1249     ;; FIXME really need to save-excursion?
1250     (save-excursion (org-table-align))
1251     (let* ((beg (org-table-begin))
1252            (end (org-table-end))
1253            (raw-table (buffer-substring beg end))
1254            fnum fields line lines olines gr colgropen line-fmt align
1255            caption label attr floatp longtblp)
1256       (if org-export-latex-tables-verbatim
1257           (let* ((tbl (concat "\\begin{verbatim}\n" raw-table
1258                               "\\end{verbatim}\n")))
1259             (apply 'delete-region (list beg end))
1260             (insert (org-export-latex-protect-string tbl)))
1261         (progn
1262           (setq caption (org-find-text-property-in-string
1263                          'org-caption raw-table)
1264                 attr (org-find-text-property-in-string
1265                       'org-attributes raw-table)
1266                 label (org-find-text-property-in-string
1267                        'org-label raw-table)
1268                 longtblp (and attr (stringp attr)
1269                               (string-match "\\<longtable\\>" attr))
1270                 align (and attr (stringp attr)
1271                            (string-match "\\<align=\\([^ \t\n\r,]+\\)" attr)
1272                            (match-string 1 attr))
1273                 floatp (or caption label))
1274           (setq lines (org-split-string raw-table "\n"))
1275           (apply 'delete-region (list beg end))
1276           (when org-export-table-remove-special-lines
1277             (setq lines (org-table-clean-before-export lines 'maybe-quoted)))
1278           ;; make a formatting string to reflect aligment
1279           (setq olines lines)
1280           (while (and (not line-fmt) (setq line (pop olines)))
1281             (unless (string-match "^[ \t]*|-" line)
1282               (setq fields (org-split-string line "[ \t]*|[ \t]*"))
1283               (setq fnum (make-vector (length fields) 0))
1284               (setq line-fmt
1285                     (mapconcat
1286                      (lambda (x)
1287                        (setq gr (pop org-table-colgroup-info))
1288                        (format "%s%%s%s"
1289                                (cond ((eq gr :start)
1290                                       (prog1 (if colgropen "|" "|")
1291                                         (setq colgropen t)))
1292                                      ((eq gr :startend)
1293                                       (prog1 (if colgropen "|" "|")
1294                                         (setq colgropen nil)))
1295                                      (t ""))
1296                                (if (memq gr '(:end :startend))
1297                                    (progn (setq colgropen nil) "|")
1298                                  "")))
1299                      fnum ""))))
1300           ;; fix double || in line-fmt
1301           (setq line-fmt (replace-regexp-in-string "||" "|" line-fmt))
1302           ;; maybe remove the first and last "|"
1303           (when (and (not org-export-latex-tables-column-borders)
1304                      (string-match "^\\(|\\)?\\(.+\\)|$" line-fmt))
1305             (setq line-fmt (match-string 2 line-fmt)))
1306           ;; format alignment
1307           (unless align
1308             (setq align (apply 'format
1309                                (cons line-fmt
1310                                      (mapcar (lambda (x) (if x "r" "l"))
1311                                              org-table-last-alignment)))))
1312           ;; prepare the table to send to orgtbl-to-latex
1313           (setq lines
1314                 (mapcar
1315                  (lambda(elem)
1316                    (or (and (string-match "[ \t]*|-+" elem) 'hline)
1317                        (org-split-string (org-trim elem) "|")))
1318                  lines))
1319           (when insert
1320             (insert (org-export-latex-protect-string
1321                      (concat
1322                       (if longtblp
1323                           (concat "\\begin{longtable}{" align "}\n")
1324                         (if floatp "\\begin{table}[htb]\n"))
1325                       (if (or floatp longtblp)
1326                           (format
1327                            "\\caption{%s%s}"
1328                            (if label (concat "\\\label{" label "}") "")
1329                            (or caption "")))
1330                       (if longtblp "\\\\\n" "\n")
1331                       (if (and org-export-latex-tables-centered (not longtblp))
1332                           "\\begin{center}\n")
1333                       (if (not longtblp) (concat "\\begin{tabular}{" align "}\n"))
1334                       (orgtbl-to-latex
1335                        lines
1336                        `(:tstart nil :tend nil
1337                                  :hlend ,(if longtblp
1338                                              (format "\\\\
1339 \\hline
1340 \\endhead
1341 \\hline\\multicolumn{%d}{r}{Continued on next page}\\
1342 \\endfoot
1343 \\endlastfoot" (length org-table-last-alignment))
1344                                            nil)))
1345                       (if (not longtblp) (concat "\n\\end{tabular}"))
1346                       (if longtblp "\n" (if org-export-latex-tables-centered
1347                                             "\n\\end{center}\n" "\n"))
1348                       (if longtblp
1349                           "\\end{longtable}"
1350                         (if floatp "\\end{table}"))))
1351                     "\n\n")))))))
1352
1353 (defun org-export-latex-fontify ()
1354   "Convert fontification to LaTeX."
1355   (goto-char (point-min))
1356   (while (re-search-forward org-emph-re nil t)
1357     ;; The match goes one char after the *string*
1358     (let ((emph (assoc (match-string 3)
1359                        org-export-latex-emphasis-alist))
1360           (beg (match-beginning 0))
1361           (end (match-end 0))
1362           rpl)
1363       (unless emph
1364         (message "`org-export-latex-emphasis-alist' has no entry for formatting triggered by \"%s\""
1365                  (match-string 3)))
1366       (unless (or (get-text-property (1- (point)) 'org-protected)
1367                   (save-excursion
1368                     (goto-char (match-beginning 1))
1369                     (save-match-data
1370                       (and (org-at-table-p)
1371                            (string-match
1372                             "[|\n]" (buffer-substring beg end))))))
1373         (setq rpl (concat (match-string 1)
1374                           (org-export-latex-emph-format (cadr emph)
1375                                                         (match-string 4))
1376                           (match-string 5)))
1377         (if (caddr emph)
1378             (setq rpl (org-export-latex-protect-string rpl)))
1379         (replace-match rpl t t)))
1380     (backward-char)))
1381
1382 (defvar org-export-latex-use-verb nil)
1383 (defun org-export-latex-emph-format (format string)
1384   "Format an emphasis string and handle the \\verb special case."
1385   (when (equal format "\\verb")
1386     (save-match-data
1387       (if org-export-latex-use-verb
1388           (let ((ll "~,./?;':\"|!@#%^&-_=+abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ<>()[]{}"))
1389             (catch 'exit
1390               (loop for i from 0 to (1- (length ll)) do
1391                     (if (not (string-match (regexp-quote (substring ll i (1+ i)))
1392                                            string))
1393                         (progn
1394                           (setq format (concat "\\verb" (substring ll i (1+ i))
1395                                                "%s" (substring ll i (1+ i))))
1396                           (throw 'exit nil))))))
1397         (let ((start 0)
1398               (trans '(("\\" . "\\backslash")
1399                        ("~" . "\\ensuremath{\\sim}")
1400                        ("^" . "\\ensuremath{\\wedge}")))
1401               (rtn "") char)
1402           (while (string-match "[\\{}$%&_#~^]" string)
1403             (setq char (match-string 0 string))
1404             (if (> (match-beginning 0) 0)
1405                 (setq rtn (concat rtn (substring string
1406                                                  0 (match-beginning 0)))))
1407             (setq string (substring string (1+ (match-beginning 0))))
1408             (setq char (or (cdr (assoc char trans)) (concat "\\" char))
1409                   rtn (concat rtn char)))
1410           (setq string (concat rtn string) format "\\texttt{%s}")))))
1411   (setq string (org-export-latex-protect-string
1412                 (format format string))))
1413
1414 (defun org-export-latex-links ()
1415   ;; Make sure to use the LaTeX hyperref and graphicx package
1416   ;; or send some warnings.
1417   "Convert links to LaTeX."
1418   (goto-char (point-min))
1419   (while (re-search-forward org-bracket-link-analytic-regexp++ nil t)
1420     (org-if-unprotected
1421      (goto-char (match-beginning 0))
1422      (let* ((re-radio org-export-latex-all-targets-re)
1423             (remove (list (match-beginning 0) (match-end 0)))
1424             (raw-path (org-extract-attributes (match-string 3)))
1425             (full-raw-path (concat (match-string 1) raw-path))
1426             (desc (match-string 5))
1427             (type (or (match-string 2)
1428                       (if (or (file-name-absolute-p raw-path)
1429                               (string-match "^\\.\\.?/" raw-path))
1430                           "file")))
1431             (coderefp (equal type "coderef"))
1432             (caption (org-find-text-property-in-string 'org-caption raw-path))
1433             (attr (or (org-find-text-property-in-string 'org-attributes raw-path)
1434                       (plist-get org-export-latex-options-plist :latex-image-options)))
1435             (label (org-find-text-property-in-string 'org-label raw-path))
1436             (floatp (or label caption))
1437             imgp radiop
1438             ;; define the path of the link
1439             (path (cond
1440                    ((member type '("coderef"))
1441                     raw-path)
1442                    ((member type '("http" "https" "ftp"))
1443                     (concat type ":" raw-path))
1444                    ((and re-radio (string-match re-radio raw-path))
1445                     (setq radiop t))
1446                    ((equal type "mailto")
1447                     (concat type ":" raw-path))
1448                    ((equal type "file")
1449                     (if (and (org-file-image-p
1450                               (expand-file-name
1451                                raw-path)
1452                               org-export-latex-inline-image-extensions)
1453                              (equal desc full-raw-path))
1454                         (setq imgp t)
1455                       (progn (when (string-match "\\(.+\\)::.+" raw-path)
1456                                (setq raw-path (match-string 1 raw-path)))
1457                              (if (file-exists-p raw-path)
1458                                  (concat type "://" (expand-file-name raw-path))
1459                                (concat type "://" (org-export-directory
1460                                                    :LaTeX org-export-latex-options-plist)
1461                                        raw-path))))))))
1462        ;; process with link inserting
1463        (apply 'delete-region remove)
1464        (cond ((and imgp (plist-get org-export-latex-options-plist :inline-images))
1465               (insert
1466                (concat
1467                 (if floatp "\\begin{figure}[htb]\n")
1468                 (format "\\centerline{\\includegraphics[%s]{%s}}\n"
1469                         attr
1470                         (if (file-name-absolute-p raw-path)
1471                             (expand-file-name raw-path)
1472                           raw-path))
1473                 (if floatp
1474                     (format "\\caption{%s%s}\n"
1475                             (if label (concat "\\label{" label "}") "")
1476                             (or caption "")))
1477                 (if floatp "\\end{figure}\n"))))
1478              (coderefp
1479               (insert (format
1480                        (org-export-get-coderef-format path desc)
1481                        (cdr (assoc path org-export-code-refs)))))
1482              (radiop (insert (format "\\hyperref[%s]{%s}"
1483                                      (org-solidify-link-text raw-path) desc)))
1484              ((not type)
1485               (insert (format "\\hyperref[%s]{%s}"
1486                               (org-solidify-link-text raw-path) desc)))
1487              (path (insert (format "\\href{%s}{%s}" path desc)))
1488              (t (insert "\\texttt{" desc "}")))))))
1489
1490 (defvar org-latex-entities)   ; defined below
1491 (defvar org-latex-entities-regexp)   ; defined below
1492 (defvar org-latex-entities-exceptions)   ; defined below
1493
1494 (defun org-export-latex-preprocess (parameters)
1495   "Clean stuff in the LaTeX export."
1496   ;; Preserve line breaks
1497   (goto-char (point-min))
1498   (while (re-search-forward "\\\\\\\\" nil t)
1499     (add-text-properties (match-beginning 0) (match-end 0)
1500                          '(org-protected t)))
1501
1502   ;; Preserve latex environments
1503   (goto-char (point-min))
1504   (while (re-search-forward "^[ \t]*\\\\begin{\\([a-zA-Z]+\\*?\\)}" nil t)
1505     (let* ((start (progn (beginning-of-line) (point)))
1506            (end (or (and (re-search-forward
1507                           (concat "^[ \t]*\\\\end{"
1508                                   (regexp-quote (match-string 1))
1509                                   "}") nil t)
1510                          (point-at-eol))
1511                     (point-max))))
1512       (add-text-properties start end '(org-protected t))))
1513
1514   ;; Preserve math snippets
1515
1516   (let* ((matchers (plist-get org-format-latex-options :matchers))
1517          (re-list org-latex-regexps)
1518          beg end re e m n block off)
1519     ;; Check the different regular expressions
1520     (while (setq e (pop re-list))
1521       (setq m (car e) re (nth 1 e) n (nth 2 e)
1522             block (if (nth 3 e) "\n\n" ""))
1523       (setq off (if (member m '("$" "$1")) 1 0))
1524       (when (and (member m matchers) (not (equal m "begin")))
1525         (goto-char (point-min))
1526         (while (re-search-forward re nil t)
1527           (setq beg (+ (match-beginning 0) off) end (- (match-end 0) 0))
1528           (add-text-properties beg end '(org-protected t org-latex-math t))))))
1529
1530   ;; Convert LaTeX to \LaTeX{}
1531   (goto-char (point-min))
1532   (let ((case-fold-search nil))
1533     (while (re-search-forward "\\([^+_]\\)LaTeX" nil t)
1534       (org-if-unprotected
1535        (replace-match (org-export-latex-protect-string
1536                        (concat (match-string 1) "\\LaTeX{}")) t t))))
1537
1538   ;; Convert blockquotes
1539   (goto-char (point-min))
1540   (while (search-forward "ORG-BLOCKQUOTE-START" nil t)
1541     (org-replace-match-keep-properties "\\begin{quote}" t t))
1542   (goto-char (point-min))
1543   (while (search-forward "ORG-BLOCKQUOTE-END" nil t)
1544     (org-replace-match-keep-properties "\\end{quote}" t t))
1545
1546   ;; Convert verse
1547   (goto-char (point-min))
1548   (while (search-forward "ORG-VERSE-START" nil t)
1549     (org-replace-match-keep-properties "\\begin{verse}" t t)
1550     (beginning-of-line 2)
1551     (while (and (not (looking-at "[ \t]*ORG-VERSE-END.*")) (not (eobp)))
1552       (when (looking-at "\\([ \t]+\\)\\([^ \t\n]\\)")
1553         (goto-char (match-end 1))
1554         (org-replace-match-keep-properties
1555          (org-export-latex-protect-string
1556           (concat "\\hspace*{1cm}" (match-string 2))) t t)
1557         (beginning-of-line 1))
1558       (unless (looking-at ".*?[^ \t\n].*?\\\\\\\\[ \t]*$")
1559         (end-of-line 1)
1560         (insert "\\\\"))
1561       (beginning-of-line 2))
1562     (and (looking-at "[ \t]*ORG-VERSE-END.*")
1563          (org-replace-match-keep-properties "\\end{verse}" t t)))
1564
1565   ;; Convert center
1566   (goto-char (point-min))
1567   (while (search-forward "ORG-CENTER-START" nil t)
1568     (org-replace-match-keep-properties "\\begin{center}" t t))
1569   (goto-char (point-min))
1570   (while (search-forward "ORG-CENTER-END" nil t)
1571     (org-replace-match-keep-properties "\\end{center}" t t))
1572
1573   (run-hooks 'org-export-latex-after-blockquotes-hook)
1574
1575   ;; Convert horizontal rules
1576   (goto-char (point-min))
1577   (while (re-search-forward "^----+.$" nil t)
1578     (org-if-unprotected
1579      (replace-match (org-export-latex-protect-string "\\hrule") t t)))
1580
1581   ;; Protect LaTeX commands like \command[...]{...} or \command{...}
1582   (let ((re (concat "\\\\[a-zA-Z]+\\(?:"
1583                     "\\[.*\\]"
1584                     "\\)?"
1585                     (org-create-multibrace-regexp "{" "}" 3))))
1586     (while (re-search-forward re nil t)
1587       (add-text-properties (match-beginning 0) (match-end 0)
1588                            '(org-protected t))))
1589
1590   ;; Protect LaTeX entities
1591   (goto-char (point-min))
1592   (let (a)
1593     (while (re-search-forward org-latex-entities-regexp nil t)
1594       (if (setq a (assoc (match-string 0) org-latex-entities-exceptions))
1595           (replace-match (org-add-props (nth 1 a) nil 'org-protected t)
1596                          t t)
1597         (add-text-properties (match-beginning 0) (match-end 0)
1598                              '(org-protected t)))))
1599
1600   ;; Replace radio links
1601   (goto-char (point-min))
1602   (while (re-search-forward
1603           (concat "<<<?" org-export-latex-all-targets-re
1604                   ">>>?\\((INVISIBLE)\\)?") nil t)
1605     (org-if-unprotected
1606      (replace-match
1607       (org-export-latex-protect-string
1608        (format "\\label{%s}%s" (save-match-data (org-solidify-link-text
1609                                                  (match-string 1)))
1610                (if (match-string 2) "" (match-string 1)))) t t)))
1611
1612   ;; Delete @<...> constructs
1613   ;; Thanks to Daniel Clemente for this regexp
1614   (goto-char (point-min))
1615   (while (re-search-forward "@<\\(?:[^\"\n]\\|\".*\"\\)*?>" nil t)
1616     (org-if-unprotected
1617      (replace-match "")))
1618
1619   ;; When converting to LaTeX, replace footnotes
1620   ;; FIXME: don't protect footnotes from conversion
1621   (when (plist-get org-export-latex-options-plist :footnotes)
1622     (goto-char (point-min))
1623     (while (re-search-forward "\\[\\([0-9]+\\)\\]" nil t)
1624       (org-if-unprotected
1625        (when (save-match-data
1626                (save-excursion (beginning-of-line)
1627                                (looking-at "[^:|#]")))
1628          (let ((foot-beg (match-beginning 0))
1629                (foot-end (match-end 0))
1630                (foot-prefix (match-string 0))
1631                footnote footnote-rpl)
1632            (save-excursion
1633              (if (not (re-search-forward (concat "^" (regexp-quote foot-prefix))
1634                                          nil t))
1635                  (replace-match "$^{\\1}$")
1636                (replace-match "")
1637                (let ((end (save-excursion
1638                             (if (re-search-forward "^$\\|^#.*$\\|\\[[0-9]+\\]" nil t)
1639                                 (match-beginning 0) (point-max)))))
1640                  (setq footnote (concat (org-trim (buffer-substring (point) end))
1641                                         " ")) ; prevent last } being part of a link
1642                  (delete-region (point) end))
1643                (goto-char foot-beg)
1644                (delete-region foot-beg foot-end)
1645                (unless (null footnote)
1646                  (setq footnote-rpl (format "\\footnote{%s}" footnote))
1647                  (add-text-properties 0 10 '(org-protected t) footnote-rpl)
1648                  (add-text-properties (1- (length footnote-rpl))
1649                                       (length footnote-rpl)
1650                                       '(org-protected t) footnote-rpl)
1651                  (insert footnote-rpl)))
1652              )))))
1653
1654     ;; Remove footnote section tag for LaTeX
1655     (goto-char (point-min))
1656     (while (re-search-forward
1657             (concat "^" footnote-section-tag-regexp) nil t)
1658       (org-if-unprotected
1659        (replace-match "")))))
1660
1661 ;;; List handling:
1662
1663 (defun org-export-latex-lists ()
1664   "Convert plain text lists in current buffer into LaTeX lists."
1665   (goto-char (point-min))
1666   (while (re-search-forward org-list-beginning-re nil t)
1667     (org-if-unprotected
1668      (beginning-of-line)
1669      (insert (org-list-to-latex (org-list-parse-list t)
1670                                 org-export-latex-list-parameters))
1671      "\n")))
1672
1673 (defconst org-latex-entities
1674  '("\\!"
1675    "\\'"
1676    "\\+"
1677    "\\,"
1678    "\\-"
1679    "\\:"
1680    "\\;"
1681    "\\<"
1682    "\\="
1683    "\\>"
1684    "\\Huge"
1685    "\\LARGE"
1686    "\\Large"
1687    "\\Styles"
1688    "\\\\"
1689    "\\`"
1690    "\\addcontentsline"
1691    "\\address"
1692    "\\addtocontents"
1693    "\\addtocounter"
1694    "\\addtolength"
1695    "\\addvspace"
1696    "\\alph"
1697    "\\appendix"
1698    "\\arabic"
1699    "\\author"
1700    "\\begin{array}"
1701    "\\begin{center}"
1702    "\\begin{description}"
1703    "\\begin{enumerate}"
1704    "\\begin{eqnarray}"
1705    "\\begin{equation}"
1706    "\\begin{figure}"
1707    "\\begin{flushleft}"
1708    "\\begin{flushright}"
1709    "\\begin{itemize}"
1710    "\\begin{list}"
1711    "\\begin{minipage}"
1712    "\\begin{picture}"
1713    "\\begin{quotation}"
1714    "\\begin{quote}"
1715    "\\begin{tabbing}"
1716    "\\begin{table}"
1717    "\\begin{tabular}"
1718    "\\begin{thebibliography}"
1719    "\\begin{theorem}"
1720    "\\begin{titlepage}"
1721    "\\begin{verbatim}"
1722    "\\begin{verse}"
1723    "\\bf"
1724    "\\bf"
1725    "\\bibitem"
1726    "\\bigskip"
1727    "\\cdots"
1728    "\\centering"
1729    "\\circle"
1730    "\\cite"
1731    "\\cleardoublepage"
1732    "\\clearpage"
1733    "\\cline"
1734    "\\closing"
1735    "\\dashbox"
1736    "\\date"
1737    "\\ddots"
1738    "\\dotfill"
1739    "\\em"
1740    "\\fbox"
1741    "\\flushbottom"
1742    "\\fnsymbol"
1743    "\\footnote"
1744    "\\footnotemark"
1745    "\\footnotesize"
1746    "\\footnotetext"
1747    "\\frac"
1748    "\\frame"
1749    "\\framebox"
1750    "\\hfill"
1751    "\\hline"
1752    "\\hrulespace"
1753    "\\hspace"
1754    "\\huge"
1755    "\\hyphenation"
1756    "\\include"
1757    "\\includeonly"
1758    "\\indent"
1759    "\\input"
1760    "\\it"
1761    "\\kill"
1762    "\\label"
1763    "\\large"
1764    "\\ldots"
1765    "\\line"
1766    "\\linebreak"
1767    "\\linethickness"
1768    "\\listoffigures"
1769    "\\listoftables"
1770    "\\location"
1771    "\\makebox"
1772    "\\maketitle"
1773    "\\mark"
1774    "\\mbox"
1775    "\\medskip"
1776    "\\multicolumn"
1777    "\\multiput"
1778    ("\\nbsp" "~")
1779    "\\newcommand"
1780    "\\newcounter"
1781    "\\newenvironment"
1782    "\\newfont"
1783    "\\newlength"
1784    "\\newline"
1785    "\\newpage"
1786    "\\newsavebox"
1787    "\\newtheorem"
1788    "\\nocite"
1789    "\\nofiles"
1790    "\\noindent"
1791    "\\nolinebreak"
1792    "\\nopagebreak"
1793    "\\normalsize"
1794    "\\onecolumn"
1795    "\\opening"
1796    "\\oval"
1797    "\\overbrace"
1798    "\\overline"
1799    "\\pagebreak"
1800    "\\pagenumbering"
1801    "\\pageref"
1802    "\\pagestyle"
1803    "\\par"
1804    "\\parbox"
1805    "\\put"
1806    "\\raggedbottom"
1807    "\\raggedleft"
1808    "\\raggedright"
1809    "\\raisebox"
1810    "\\ref"
1811    "\\rm"
1812    "\\roman"
1813    "\\rule"
1814    "\\savebox"
1815    "\\sc"
1816    "\\scriptsize"
1817    "\\setcounter"
1818    "\\setlength"
1819    "\\settowidth"
1820    "\\sf"
1821    "\\shortstack"
1822    "\\signature"
1823    "\\sl"
1824    "\\small"
1825    "\\smallskip"
1826    "\\sqrt"
1827    "\\tableofcontents"
1828    "\\telephone"
1829    "\\thanks"
1830    "\\thispagestyle"
1831    "\\tiny"
1832    "\\title"
1833    "\\tt"
1834    "\\twocolumn"
1835    "\\typein"
1836    "\\typeout"
1837    "\\underbrace"
1838    "\\underline"
1839    "\\usebox"
1840    "\\usecounter"
1841    "\\value"
1842    "\\vdots"
1843    "\\vector"
1844    "\\verb"
1845    "\\vfill"
1846    "\\vline"
1847    "\\vspace")
1848  "A list of LaTeX commands to be protected when performing conversion.")
1849
1850 (defvar org-latex-entities-exceptions nil)
1851
1852 (defconst org-latex-entities-regexp
1853   (let (names rest)
1854     (dolist (x org-latex-entities)
1855       (when (consp x)
1856         (add-to-list 'org-latex-entities-exceptions x)
1857         (setq x (car x)))
1858       (if (string-match "[a-z][A-Z]$" x)
1859           (push x names)
1860         (push x rest)))
1861     (concat "\\(" (regexp-opt (nreverse names)) "\\>\\)"
1862             "\\|\\(" (regexp-opt (nreverse rest)) "\\)")))
1863
1864 (provide 'org-export-latex)
1865 (provide 'org-latex)
1866
1867 ;; arch-tag: 23c2b87d-da04-4c2d-ad2d-1eb6487bc3ad
1868
1869 ;;; org-latex.el ends here