[Pythonmac-SIG] ANN: emkey 0.2 - a simple post-processing tool for Keynote documents

[Dinu Gherman]

Hi,

I've released emkey 0.2, a simple post-processing tool for Keynote
documents. As of now it might be particularly useful for people using
Python code on Keynote slides, but it's easy to imagine additional
features. Please see the full Readme for this first release below.

Regards,

Dinu



emkey
=====

Summary
-------

emkey is an EmPy-based post-processing tool for Apple Keynote documents.

Overview
--------

emkey is a simple command-line tool for post-processing Apple Keynote
documents. It currently imports external text snippets on single
slides and can apply syntax color highlighting to them if these are
Python source code.

Basics
------

emkey works on the APXL [1]_ presentation file of a Keynote [2]_
document. Before using it you create a normal Keynote presentation
document. EmPy [3]_ tags like ``@load("fibo.py", colored=1)`` on
a slide will then be expanded during post-processing by emkey with
the content of the respective file, with syntax highlighting for
Python code if desired. The tool makes one backup of the APXL file
before modifying it, and allows to revert to this backup after
post-processing.

History
-------

:0.2:   first release

Requirements
------------

There are no special requirements for running emkey, except a Python
interpreter 2.x [4]_, EmPy 3.x (3.3 included), copyrighted by Erik Max
Francis and PyFontify (0.5 included), copyrighted by Just van Rossum.

Licence
-------

emkey is released under the GPL - see the included file, "GPL.txt".
The included EmPy and PyFontify modules are licensed under the LGPL
and the Python License, respectively.

Download
--------

The emkey distribution, including one Keynote sample document is
available from:

   http://python.net/~gherman/emkey.html

Notes
------

Thanks to Erik Max Francis and Just van Rossum who have kindly
allowed to include EmPy and PyFontify respectively into the emkey
distribution. Note, that there is no installation procedure by
which you might risk to overwrite an existing EmPy or PyFontify.

**Be careful when using emkey on Keynote documents! Remember to
revert to the original version before re-editing the document
with Keynote, again!**

Future
------

In principle one could extend this tool to provide further kinds
of post-processing capabilities on Keynote files, which, of course,
needs intimate knowledge of the APXL files.

Links
-----

.. [1] http://developer.apple.com/technotes/tn2002/tn2067.html
.. [2] http://www.apple.com/keynote
.. [3] http://www.alcyone.com/software/empy
.. [4] http://www.python.org

Author
------

Dinu Gherman,
http://python.net/~gherman/Contact.html,
2003-10-31