Ledger: Difference between revisions

Latest revision as of 06:31, 21 April 2024

Ledger is a powerful, double-entry accounting system that is accessed from the UNIX command-line. Ledger, begun in 2003, is written by John Wiegley and released under the BSD license.

Installation

There are several ports of ledger to various languages. Install one of:

ledger: the original implementation,
hledger: a port to haskell, which is also popular.

Usage

The online documentation contains a tutorial to help new users get started.

Tip: To avoid having to type --file /path/to/finances.ledger every time you invoke ledger, consider setting LEDGER_FILE as one of your environment variables or add --file /path/to/finances.ledger to your .ledgerrc.

Emacs users may be interested in using ledger-mode. ledger-mode is available on MELPA and comes with info, accessible via C-h i m Ledger mode RET.

Tips and tricks

Assign commodity during ledger convert

By default, ledger does not assign a commodity when it converts from csv files to ledger format. To have it assign a currency when one is missing, you can make a currency the default commodity of a ledger file by adding something like this to the file:

commodity $
  note US Dollar
  default
  nomarket
  format $1,000.00

@@ Line 6: / Line 6: @@
 == Installation ==
-There are several ports of ledger to various languages. {{Pkg|ledger}} is the original. {{Pkg|hledger}} is a port to haskell, which is also popular.
+There are several ports of ledger to various languages. [[Install]] one of:
+* {{Pkg|ledger}}: the original implementation,
+* {{Pkg|hledger}}: a port to haskell, which is also popular.
 == Usage ==
-[https://www.ledger-cli.org/3.0/doc/ledger3.html The online documentation] contains [https://www.ledger-cli.org/3.0/doc/ledger3.html#Ledger-Tutorial a tutorial] to help new users get started.
+The [https://www.ledger-cli.org/3.0/doc/ledger3.html online documentation] contains [https://www.ledger-cli.org/3.0/doc/ledger3.html#Ledger-Tutorial a tutorial] to help new users get started.
-{{Tip| To avoid having to type {{ic|--file /path/to/finances.ledger}} every time you invoke ledger, consider setting {{ic|LEDGER_FILE}} as one of your [[Environment variables]] or add {{ic|--file /path/to/finances.ledger}} to your {{ic|.ledgerrc}}.}}
+{{Tip| To avoid having to type {{ic|--file /path/to/finances.ledger}} every time you invoke ledger, consider setting {{ic|LEDGER_FILE}} as one of your [[environment variables]] or add {{ic|--file /path/to/finances.ledger}} to your {{ic|.ledgerrc}}.}}
 Emacs users may be interested in using ledger-mode. ledger-mode is available on MELPA and comes with info, accessible via {{ic|C-h i m Ledger mode RET}}.