emacs-orgmode
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[O] ox-tufte-latex


From: Thomas S . Dye
Subject: [O] ox-tufte-latex
Date: Mon, 01 Feb 2016 14:26:53 -1000
User-agent: mu4e 0.9.16-1c0bfe8; emacs 24.5.1

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.
└────

Attachment: ox-tufte-latex.el
Description: Ox-tufte-latex.el


-- 
Thomas S. Dye
http://www.tsdye.com

reply via email to

[Prev in Thread] Current Thread [Next in Thread]