[O] org-export-latex-hyperref-options-format

[Joe Hirn]

Hello. I recently upgraded to org 8 from the builtin org (7.x) of Emacs 24.3 and lost the ability to customize the \hypersetup block via the custom var org-export-latex-hyperref-options-format. Platform is OSX, Emacs installed via homebrew and org-mode updated via package.el. 

Org 7.x defines the var in org-latex.el. Because it's a builtin, the custom var still displays in the 'org-latex-export group when configuring options. However, the new export logic from ox-latex.el does not define this custom var, nor does it respect the value if it is set. This is doubly confusing because it appears the var is available, but it actually unused.

I found this thread from September which describes the same issue, but the patch did not address adding the custom var back and seems to have died. http://lists.gnu.org/archive/html/emacs-orgmode/2013-09/msg01364.html

I've created a patch via git format-patch which adds the custom var to ox-latex.el and makes use of it. Thanks for considering it.

rom 0df51396b04bd785948032055e48b40787c15d98 Mon Sep 17 00:00:00 2001

From: Joe Hirn <address@hidden>

Date: Mon, 17 Feb 2014 14:39:35 -0600

Subject: [PATCH] add org-export-latex-hyperref-options-format custom var back

 to latex exporter

---

 ox-latex.el | 13 ++++++++++++-

 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/ox-latex.el b/ox-latex.el

index 19f055e..9724def 100644

--- a/ox-latex.el

+++ b/ox-latex.el

@@ -186,6 +186,17 @@

   :group 'org-export-latex

   :type '(string :tag "LaTeX class"))

+(defcustom org-export-latex-hyperref-options-format

+  "\\hypersetup{\n  pdfkeywords={%s},\n  pdfsubject={%s},\n  pdfcreator={Emacs Org-mode version %s}}\n"

+  "A format string for hyperref options.

+When non-nil, it must contain three %s format specifications

+which will respectively be replaced by the document's keywords,

+its description and the Org's version number, as a string.  Set

+this option to the empty string if you don't want to include

+hyperref options altogether."

+  :type 'string

+  :group 'org-export-latex)

+

 (defcustom org-latex-classes

   '(("article"

      "\\documentclass[11pt]{article}"

@@ -1119,7 +1130,7 @@ holding export options."

      (format "\\title{%s}\n" title)

      ;; Hyperref options.

      (when (plist-get info :latex-hyperref-p)

-       (format "\\hypersetup{\n  pdfkeywords={%s},\n  pdfsubject={%s},\n  pdfcreator={%s}}\n"

+       (format org-export-latex-hyperref-options-format

        (or (plist-get info :keywords) "")

        (or (plist-get info :description) "")

        (if (not (plist-get info :with-creator)) ""

--

1.8.5.4