>From d7dfb6133bcea0127d0c386334a833e8ac64323e Mon Sep 17 00:00:00 2001 From: Suvayu Ali Date: Tue, 5 Feb 2013 10:21:23 +0100 Subject: [PATCH] Documentation for beamer export with new exporter Start an article to serve as initial documentation for beamer export using the new exporter. This is also the working document for a tutorial for the exporter. --- org-tutorials/org-beamer/org-e-beamer.org | 141 ++++++++++++++++++++++++++++++ 1 file changed, 141 insertions(+) create mode 100644 org-tutorials/org-beamer/org-e-beamer.org diff --git a/org-tutorials/org-beamer/org-e-beamer.org b/org-tutorials/org-beamer/org-e-beamer.org new file mode 100644 index 0000000..f857174 --- /dev/null +++ b/org-tutorials/org-beamer/org-e-beamer.org @@ -0,0 +1,141 @@ +#+TITLE: Beamer presentations using the new export engine +#+AUTHOR: Suvayu Ali +#+EMAIL: fatkasuvayu+linux at gmail dot com +#+DATE: 2013-02-05 +#+DESCRIPTION: +#+KEYWORDS: +#+LANGUAGE: en +#+OPTIONS: H:3 num:t toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t +#+OPTIONS: TeX:t LaTeX:t skip:nil d:nil todo:t pri:nil tags:not-in-toc +#+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js +#+EXPORT_SELECT_TAGS: export +#+EXPORT_EXCLUDE_TAGS: noexport +#+LINK_UP: +#+LINK_HOME: + +#+startup: folded + +* Introduction +This tutorial covers exporting org documents to LaTeX Beamer slides +using the new export engine, =org-elements= and =org-export=, written +by Nicolas Goaziou. + +_Note:_ It will not cover any of the basic features common with the +old beamer exporter; it will only focus on the improvements, new +additions and backwards incompatibilities. It is also assumed that +the reader is already acquainted with GNU Emacs and Org mode itself. +Basic understanding of LaTeX and the Beamer package is also assumed. + +* Configuring export options +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 +=LaTeX_CLASS_OPTIONS= keywords in the header of a file. A preset +export template can be inserted by calling the interactive function +=org-e-beamer-insert-options-template=. This can be further modified +as per your needs. You can also do a subtree export; in that case you +can provide the keywords as =PROPERTIES=. However the keyword names +should be prepended with =EXPORT_=. A list of supported +keywords are, + +#+caption: Export option keywords and corresponding subtree properties. +| File header keywords | Subtree properties | +|-----------------------+------------------------------| +| =OPTIONS= | =EXPORT_OPTIONS= | +| =LaTeX_CLASS= | =EXPORT_LaTeX_CLASS= | +| =LaTeX_CLASS_OPTIONS= | =EXPORT_LaTeX_CLASS_OPTIONS= | +| =LaTeX_HEADER= | =EXPORT_LaTeX_HEADER= | +| =BEAMER_THEME= | =EXPORT_BEAMER_THEME= | +| =BEAMER_FONT_THEME= | =EXPORT_BEAMER_FONT_THEME= | +| =BEAMER_INNER_THEME= | =EXPORT_BEAMER_INNER_THEME= | +| =BEAMER_OUTER_THEME= | =EXPORT_BEAMER_OUTER_THEME= | + +For a subtree export, a few extra keywords are supported. For example +you can specify the exported filename with the =EXPORT_FILE_NAME= +property. + +#+caption: Properties specific to subtree export +| Subtree properties | Functionality | +|--------------------+------------------| +| =EXPORT_TITLE= | Export title | +| =EXPORT_AUTHOR= | Export author | +| =EXPORT_DATE= | Export date | +| =EXPORT_FILE_NAME= | Export file name | + +A simple file header might look like the example below. +#+begin_example + ,#+LaTeX_CLASS: beamer + ,#+LaTeX_CLASS_OPTIONS: [smaller,presentation] + ,#+BEAMER_THEME: default +#+end_example +A corresponding subtree export should have properties as shown below. +#+begin_example + ,* Exported title + :PROPERTIES: + :EXPORT_LaTeX_CLASS: beamer + :EXPORT_LaTeX_CLASS_OPTIONS: [presentation,smaller] + :EXPORT_BEAMER_THEME: default + :EXPORT_FILE_NAME: presentation.pdf + :END: +#+end_example + +The export class is passed on to the =\documentclass= LaTeX command, +and the options go in as the optional arguments. +: \documentclass[smaller,presentation]{beamer} + +** TODO Export level +- To export third level headlines as frames, use the following in the + file header. + : #+OPTIONS: H:3 +- Can be overridden with the =frame= beamer environment (maybe link to + new features section below). + +** TODO Filters to customise export + +* Structure editing and beamer environments +All the usual Org mode structure editing commands work. However there +is also a minor mode called =org-e-beamer-mode=, that makes it very +convenient to insert Beamer specific environments in an org-mode +buffer. + +* New features available with the new exporter +** TODO Beamer article +Discuss that =EXPORT_LaTeX_CLASS= need not be beamer. Useful to +export =beamerarticle= document for slides. + +Email from Nicolas Goaziou discussing this feature: +http://mid.gmane.org/address@hidden + +** TODO Ordered and unordered lists + +** TODO Images + +** TODO Tables + +** TODO Environments + +** TODO Overlays + +** TODO Example and source blocks + +* TODO Examples +1) [ ] Sectioning and TOC (progress state between sections) +2) [ ] Overlays +3) [ ] Blocks + 1. [ ] Normal blocks + 2. [ ] Verbatim blocks + 3. [ ] Source blocks +4) [ ] Columns +5) [ ] Text / LaTeX commands in between frames +6) [ ] Images + + Centering + + Captions +7) [ ] Footnotes and references +8) [ ] Backup slides with =\appendix= +9) [ ] Caveats about using alternate TeX binaries + +* TODO Migrating from the old to the new exporter +- Backwards incompatible changes in the new exporter +- Configuration: + 1. variable name changes, + 2. filters instead of hooks (except for two) -- 1.8.1