Bug: s5-export: Improved title template default. [8.2.1 (8.2.1-dist @ /usr/share/emacs/site-lisp/org-mode/)]

Bug: s5-export: Improved title template default. [8.2.1 (8.2.1-dist @ /usr/share/emacs/site-lisp/org-mode/)]

[Arne Babenhauserheide]

Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See

     http://orgmode.org/manual/Feedback.html#Feedback

Your bug report will be posted to the Org-mode mailing list.
------------------------------------------------------------------------

The current ox-s5.el code produces a title page with just <h1> and <h2> which does not fit the defaults of s5 and creates slightly off-looking presentations.

The s5 primer[1] specifies different levels of headlines for different content, though:

- h1: title
- h2: subtitle
- h3: presenter
- h4: affilitation

Same for the footer.

The following in ox-s5.el should fix this:

(defcustom org-s5-title-slide-template
  "<h1>%t</h1>
<h3>%a</h3>
<h4>%e</h4>
<h4>%d</h4>"
  "Format template to specify title page section.
See `org-html-postamble-format' for the valid elements which
can be included.

It will be wrapped in the element defined in the :html-container
property, and defaults to the value of `org-html-container-element',
and have the id \"title-slide\"."
  :group 'org-export-s5
  :type 'string)


(defcustom org-s5-postamble "<h1>%a - %d</h1><h2>%t</h2>"
  "Preamble inserted into the S5 layout section.
When set to a string, use this string as the postamble.

When set to a function, apply this function and insert the
returned string.  The function takes the property list of export
options as its only argument.

Setting the S5_POSTAMBLE option -- or the :s5-postamble in publishing
projects -- will take precedence over this variable.

Note that the default css styling will break if this is set to nil
or an empty string."
  :group 'org-export-s5
  :type '(choice (const :tag "No postamble" "&#x20;")
		 (string :tag "Custom formatting string")
		 (function :tag "Function (must return a string)")))

[1]: http://meyerweb.com/eric/tools/s5/primer.html

Happy Hacking!
Arne


Emacs  : GNU Emacs 24.3.1 (x86_64-pc-linux-gnu, GTK+ Version 3.8.2)
 of 2013-10-14 on fluss
Package: Org-mode version 8.2.1 (8.2.1-dist @ /usr/share/emacs/site-lisp/org-mode/)

Re: Bug: s5-export: Improved title template default. [8.2.1 (8.2.1-dist @ /usr/share/emacs/site-lisp/org-mode/)]

[Rick Frankel]

On Sat, Jan 11, 2014 at 02:27:01AM +0100, Arne Babenhauserheide wrote:
> The following in ox-s5.el should fix this:
> 
> (defcustom org-s5-title-slide-template
>   "<h1>%t</h1>
> <h3>%a</h3>
> <h4>%e</h4>
> <h4>%d</h4>"

applied in maint and master.