How to use cake with interactive documents

Jon F. Claerbout & Martin Karrenbach

Author has no known email address  

ABSTRACT

At SEP we file our research in electronic documents so that any of us can rebuild a research result of any other (on a wide variety of computers) by opening an electronic report, going to an illustration and pressing a button found in the figure caption. The caption button exposes a menu of choices, often including interaction and movies. Researchers achieve this reproducibility and interactivity by filing their work using systematic naming conventions, explained here and precisely defined by a four page document SEP.idoc.rules written in ``cake'' language. A typical research directory builds 1-10 illustrations. Each directory has a cakefile containing a list (FIGLIST) of buildable figure names. All figures can be built with the command cake figures and removed with cake burn. Precious figure files (ones not considered replaceable) are named NAME.save. The L^ATEX macro, $\backslash$activeplot, launches the UNIX command cake NAME.menu or cake NAME.idoc. The default cake rule is to come up with an XWINDOW menu xtpanel or to show a plot with tube or show a movie with X11movie. For unusual actions, you can override the default by making a rule for the target NAME.action.