Aloha Titus,
I have bits and pieces of a tutorial, which I plan to finalize
and contribute to Worg in the next week or two. I'll let the ML
know when I have it done.
All the best, Tom
Titus von der Malsburg <address@hidden> writes:
Hi Tom,
thanks for sharing this. I’m looking forward to using it. Do
you happen to have an example file that showcases the features?
Titus
On 2016-02-01 Mon 16:26, Thomas S. Dye wrote:
Aloha all,
I've cobbled together an exporter for the Tufte LaTeX classes,
which I'd like to contribute to Org mode contrib/. A brief
description of the derived backend can be found below, and
I've attached the ox-tufte-latex.el file for the review
described on http://orgmode.org/worg/org-contribute.html.
I've been using the derived backend for a while now and am
happy with how it is working. The Tufte LaTeX classes
(especially the book class) require quite a bit of set up to
work optimally, and I'll be sharing what I've learned along
these lines in the next couple of weeks. Org mode is a great
tool for authoring Tufte LaTeX documents!
All the best, Tom
━━━━━━━━━━━━━━━━
OX-TUFTE-LATEX
Thomas S. Dye
━━━━━━━━━━━━━━━━
The file `ox-tufte-latex.el' implements an Org mode export
backend for the Tufte LaTeX classes, which are designed to
produce books and handouts in the style developed by Edward
Tufte. The backend is derived from `ox-latex.el'.
A characteristic of Tufte's style is a page layout with a wide
margin on one side (typically the right side) in which notes,
references, small tables, and small figures are placed.
The Tufte LaTeX classes implement several non-standard LaTeX
commands to achieve this page layout, including
`marginfigure', `margintable', and `sidenote'.
`Ox-tufte-latex.el' implements these commands.
The `marginfigure' command is controlled by a new LaTeX
attribute `:float margin'. In addition, there are attributes
to: set the offset, e.g., `:offset 1in', which adjusts the
position of the figure up or down in the margin; the vertical
alignment of figure captions, e.g., `:vertical-alignment t|b',
so they align with either the top or bottom of the float; and
`:horizontal-alignment l|r' in case a figure and its caption
end up on different pages.
The `margintable' command is controlled by the LaTeX attribute
`:float margin' associated with a table.
The Org mode footnote mechanism has been hijacked to produce
`sidenote' commands, instead of `footnote' commands. The
`sidenote' command takes an optional parameter for the offset,
and this is implemented as a LaTeX attribute associated with
the Org mode footnote definition, e.g., ┌──── │ #+attr_latex:
:offset 36pt │ [fn:1] Cook referred to Koa`a as Koah. └────