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
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
| =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
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=
=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.
#+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.
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
#+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
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.
** DONE Environments
* TODO Examples
+ :PROPERTIES:
+ :CUSTOM_ID: examples
+ :END:
+
1) [ ] Sectioning and TOC (progress state between sections)
2) [ ] Overlays
3) [ ] Blocks
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,