- publishing free software manuals
The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
ISBN 9781906966089
RRP £9.95 ($14.95)

Sales of this book support the Org project! Get a printed copy>>>

12.2 Export options

The exporter recognizes special lines in the buffer which provide additional information. These lines may be put anywhere in the file. The whole set of lines can be inserted into the buffer with C-c C-e t. For individual lines, a good way to make sure the keyword is correct is to type ‘#+’ and then use M-TAB completion (see section 16.1 Completion). For a summary of other in-buffer settings not specifically related to export, see section 16.6 Summary of in-buffer settings. In particular, note that you can place commonly-used (export) options in a separate file which can be included using #+SETUPFILE.

C-c C-e t
Insert template with export options, see example below.
#+TITLE:       the title to be shown (default is the buffer name)
#+AUTHOR:      the author (default taken from user-full-name)
#+DATE:        a date, fixed, or a format string for format-time-string
#+EMAIL:       his/her email address (default from user-mail-address)
#+DESCRIPTION: the page description, e.g., for the XHTML meta tag
#+KEYWORDS:    the page keywords, e.g., for the XHTML meta tag
#+LANGUAGE:    language for HTML, 
               e.g., ‘en’ (org-export-default-language)
#+TEXT:        Some descriptive text to be inserted at the beginning.
#+TEXT:        Several lines may be given.
#+OPTIONS:     H:2 num:t toc:t \n:nil @:t ::t |:t ^:t f:t TeX:t ...
#+BIND:        lisp-var lisp-val, e.g.: org-export-latex-low-levels itemize
               You need to confirm using these, or configure
               org-export-allow-BIND
#+LINK_UP:     the “up” link of an exported page
#+LINK_HOME:   the “home” link of an exported page
#+LATEX_HEADER: extra line(s) for the LaTeX header, like \usepackage{xyz}
#+EXPORT_SELECT_TAGS:   Tags that select a tree for export
#+EXPORT_EXCLUDE_TAGS:  Tags that exclude a tree from export
#+XSLT:        the XSLT stylesheet used by DocBook exporter to
               generate FO file

The OPTIONS line is a compact(104) form to specify export settings. Here you can:

H: set the number of headline levels for export
num: turn on/off section-numbers
toc: turn on/off table of contents, or set level limit (integer)
\n: turn on/off line-break-preservation (DOES NOT WORK)
@: turn on/off quoted HTML tags
:: turn on/off fixed-width sections
|: turn on/off tables
^: turn on/off TeX-like syntax for sub- and superscripts. If you write "^:{}", a_{b} will be interpreted, but the simple a_b will be left as it is.
-: turn on/off conversion of special strings.
f: turn on/off footnotes like this[1].
todo: turn on/off inclusion of TODO keywords into exported text
pri: turn on/off priority cookies
tags: turn on/off inclusion of tags, may also be not-in-toc
<: turn on/off inclusion of any time/date stamps like DEADLINES
*: turn on/off emphasized text (bold, italic, underlined)
TeX: turn on/off simple TeX macros in plain text
LaTeX: configure export of LaTeX fragments. Default auto
skip: turn on/off skipping the text before the first heading
author: turn on/off inclusion of author name/email into exported file
email: turn on/off inclusion of author email into exported file
creator: turn on/off inclusion of creator info into exported file
timestamp: turn on/off inclusion creation time into exported file
d: turn on/off inclusion of drawers
These options take effect in both the HTML and LaTeX export, except for TeX and LaTeX, which are respectively t and nil for the LaTeX export. When exporting only a single subtree by selecting it with C-c @ before calling an export command, the subtree can overrule some of the file's export settings with properties EXPORT_FILE_NAME, EXPORT_TITLE, EXPORT_TEXT, EXPORT_AUTHOR, EXPORT_DATE, and EXPORT_OPTIONS.
ISBN 9781906966089The Org Mode 7 Reference ManualSee the print edition