Custom Reports Using Eguile

From GnuCash
Revision as of 22:38, 21 June 2009 by ChrisDennis (talk | contribs) (What is eguile?)
Jump to: navigation, search

What is eguile?

eguile is a way of processing a template file to create a guile script.

More specifically, within GnuCash, guile is used to combine HTML and guile code to create a report, such as an invoice or balance sheet.

The GnuCash version of eguile is eguile-gnc.scm, written in early 2009 by Chris Dennis, and based on Neale Pickett's eguile.scm.

For example,

<source lang="html4strict">
<h3><?scm:d coyname ?></h3>
<h2><?scm:d reportname ?> as at <?scm:d (gnc-print-date opt-date-tp) ?></h2>
</source>

could become

<source lang="scheme">
(display "<h3>")(display "Acme Tools Ltd.")(display "</h3>
<h2>)(display "Balance Sheet")(display " as at ")
(display "05/04/2009")(display "<h2">)
</source>

which is then evaluated as guile code to create the text of the report.

...the rest of this page will be here very soon

see [1] for more information.

How to install an eguile report

...

How to create an eguile report

...

Available Reports

The following eguile-based reports are available. More will be contributed soon (hopefully).

Tax Invoice

Report file: taxinvoice.scm
Template file: taxinvoice-eguile.scm
CSS file: none
Author: ChrisDennis
Version: 0.01
Last update: June 2009

Balance Sheet

Report file: balsheet-eg.scm
Template file: balsheet-eg.eguile.scm
CSS file: balsheet-eg.css
Sample output: PDF
Author: ChrisDennis
Version: 0.01
Last update: June 2009