boec

Usage

Boec operates on the XML output from ledger-cli:

ledger xml | boec

The output of the vanilla boec command is a simple LaTeX table, formatting the ledger data as a journal (or "register" as ledger calls it). The table layout is as follows:

| ID | Date       | Acc.Code | Details                     | Debet  | Credit |
|----|------------|----------|-----------------------------|--------|--------|
|0001|2017/01/01  |          | **Customer name**           |        |        |
|    |            |          | *Invoice #2017/003*         |        |        |
|    |            | 110101000| Balance:Accounts Receivable | 700.00 |        |
|    |            | 800305000| Results:Sales:Services      |        | 700.00 |
|----|------------|----------|-----------------------------|--------|--------|
|0002|2017/01/02  |          | **Customer name**           |        |        |
|    |            |          | *Invoice #2017/004*         |        |        |
|    |            | 110101000| Balance:Accounts Receivable | 968.00 |        |
|    |            | 800305000| Results:Sales:Services      |        | 800.00 |
|    |            | 800305000| Results:VAT:To pay          |        | 168.00 |
|----|------------|----------|-----------------------------|--------|--------|
|0003|2017/01/02  |          | **Vendor name**             |        |        |
|    |            |          | *Some book, bill #1342*     |        |        |
|    |            | 800305000| Results:Expenses:Books      |  15.00 |        |
|    |            | 800305000| Results:VAT:To recuperate   |   3.15 |        |
|    |            | 420904000| Balance:Accounts Payable    |        |  18.15 |
|----|------------|----------|-----------------------------|--------|--------|

Some notes on this layout and how it relates to the ledger entries:

• The ID is dynamically generated based on the amount of transactions in the ledger output, and always starts with 1.
• The account codes can be specified in a dictionary, located in $HOME/.boecdict. The layout of this file is quite simple, and can be copied from the example file in this repository. The codes should always be equal in length (in this sample the codes are 9 characters long). 9 is the default value. If your code lengths aren't 9, add the --codelength flag like so: boec --codelength 6.
• "Customer name" and "Vendor name", i.e. the first line of each entry in the details cell, is what is called the payee in ledger-cli. It is printed in bold in the LaTeX output.
• What is shown as "Invoice #2017/003", "Bill #1342", etc., are notes in ledger-cli. It is printed in italics (emph) in the LaTeX output

Extending a LaTeX template

You can easily incorporate the output of boec in an existing LaTeX template. Just ensure that the exact spot where you'd like to insert the boec output has the line \input{__BOEC__}, and call the program with the following parameter:

ledger xml | boec --template path/to/template.tex

# Or to compile the PDF at once:
ledger xml | boec --template path/to/template.tex > /tmp/report.tex && pdflatex /tmp/report.tex

For an example, have a look in the samples directory: Extending template.tex while parsing ledgerfile.ldg gives us the output as seen below.

Installing boec

Building from source

Clone this repository and run make.

Install

Run make install as root (or with sudo).