CUSTOM_IDs for headlines in ox-beamer.org
authorSuvayu Ali <fatkasuvayu+linux@gmail.com>
Wed, 6 Mar 2013 17:15:48 +0000 (18:15 +0100)
committerSuvayu Ali <fatkasuvayu+linux@gmail.com>
Wed, 6 Mar 2013 17:15:48 +0000 (18:15 +0100)
exporters/beamer/ox-beamer.org

index e3d5b29..366dc40 100644 (file)
@@ -21,6 +21,10 @@ the reader is already acquainted with GNU Emacs and Org mode itself.
 Basic understanding of LaTeX and the Beamer package is also assumed.
 
 ** Initial setup
+   :PROPERTIES:
+   :CUSTOM_ID: setup
+   :END:
+
 Unlike the old exporter, requiring the beamer exporter is not enough
 to export to beamer slides with =ox=.  This difference arises from a
 new feature in =ox-beamer= that allows, in the author's words, a
@@ -45,6 +49,10 @@ name however should be the argument to the =LaTeX_CLASS= file header
 option (or =EXPORT_LaTeX_CLASS= subtree property).
 
 * Configuring export options
+  :PROPERTIES:
+  :CUSTOM_ID: config
+  :END:
+
 Apart from the usual export options provided by the =OPTIONS= keyword,
 you can put additional beamer export options in the file header.  For
 a minimal beamer export, you have to specify the =LaTeX_CLASS= and the
@@ -81,6 +89,10 @@ property.
 | =EXPORT_FILE_NAME= | Export file name |
 
 ** A simple example
+   :PROPERTIES:
+   :CUSTOM_ID: simple-example
+   :END:
+
 A simple file header might look like the example below.
 #+begin_example
   ,#+LaTeX_CLASS: beamer
@@ -103,7 +115,10 @@ The export class, as defined in =org-latex-classes=, determines the
 arguments (note the presence of square brackets).
 : \documentclass[smaller,presentation]{beamer}
 
-** Configuring export level
+** Configuring frame export level
+   :PROPERTIES:
+   :CUSTOM_ID: frame-level
+   :END:
 The new exporter allows the grouping slides into LaTeX sections.  The
 sectioning behaviour is controlled by =org-latex-classes=, where as
 heading levels to be exported as frames are controlled by the =H:n=
@@ -117,6 +132,9 @@ setting the =BEAMER_opt= property on the headline.  This also adds the
 =fragile= option to the frame.
 
 ** Use of filters to customise export
+   :PROPERTIES:
+   :CUSTOM_ID: export-filters
+   :END:
 =ox= also gives you access to all =org-element= entities in the
 exported text for customisation with user filters.  Filters are
 essentially simple lisp functions that reformat the exported elements.
@@ -141,6 +159,9 @@ Another example would be to translate +strike through text+ to
 #+end_src
 
 * Structure editing, environments and markup
+  :PROPERTIES:
+  :CUSTOM_ID: editing-environments-markup
+  :END:
 All the usual Org mode structure editing commands work.  The minor
 mode =org-beamer-mode= is also provided to make it convenient to
 insert Beamer specific environments in an org-mode buffer.
@@ -149,6 +170,10 @@ A notable change in =ox-beamer= with regards to markup is, *bold text*
 is translated as =\alert{bold text}= by default.
 
 ** Block environments and overlay specifications
+   :PROPERTIES:
+   :CUSTOM_ID: environments-overlay
+   :END:
+
 All headlines below the =org-beamer-frame-level= (i.e. below =H= value
 in =OPTIONS=), are exported as blocks with =ox-beamer=.  You can
 choose special block environments by setting the =BEAMER_env= property
@@ -178,6 +203,10 @@ below adds support for =only= environment and associates to the letter
 #+end_src
 
 ** Special enviroments
+  :PROPERTIES:
+  :CUSTOM_ID: special-environments
+  :END:
+
 Environments can be put in a column by setting the =BEAMER_col=
 property on a headline.  It accepts decimal point numbers which is
 interpreted as a fraction of the text width.  If the beadline does not
@@ -212,6 +241,10 @@ environment, although it can be forced at any point by setting the
 to pass special options.
 
 * New features available with the new exporter
+  :PROPERTIES:
+  :CUSTOM_ID: new-features
+  :END:
+
 ** TODO Beamer article
 Discuss that =EXPORT_LaTeX_CLASS= need not be beamer.  Useful to
 export =beamerarticle= document for slides.
@@ -235,6 +268,10 @@ http://mid.gmane.org/87hapz3na9.fsf@gmail.com
 ** DONE Environments
 
 * TODO Examples
+  :PROPERTIES:
+  :CUSTOM_ID: examples
+  :END:
+
 1) [ ] Sectioning and TOC (progress state between sections)
 2) [ ] Overlays
 3) [ ] Blocks
@@ -251,6 +288,10 @@ http://mid.gmane.org/87hapz3na9.fsf@gmail.com
 9) [ ] Caveats about using alternate TeX binaries
 
 * TODO Migrating from the old to the new exporter
+  :PROPERTIES:
+  :CUSTOM_ID: migration
+  :END:
+
 - Backwards incompatible changes in the new exporter
 - Configuration:
   1. variable name changes,