hledger/site/docs.md
2017-12-21 15:47:01 -08:00

5.8 KiB
Raw Blame History

hledger docs

hledger-specific docs are collected here. For more docs relevant to all ledger-likes, see plaintextaccounting.org.

Help/feedback

IRC #hledger on Freenode ( see also #ledger)
Twitter #hledger hashtag (see also #plaintextaccounting, @LedgerTips)
Mail list mail.hledger.org
Issue tracker bugs.hledger.org (just the bugs), issues.hledger.org (all issues).

Introduction

What is… hledger?

An enhanced, well-documented rewrite of the original plain text accounting tool. Loved Ledger so much, I had to rebuild it!
hledger intro
Frequently Asked Questions
Download
Release notes

Plain text accounting?

Using plain text data formats and quick, modular free software tools for robust, transparent, powerful accounting.
plaintextaccounting.org

Accounting?

Tracking the flow of valuable commodities, such as money or time. Reduce stress, increase success!
Selected accounting links

Guide

A growing collection of tutorials, how-tos and discussion of general topics. (Please help complete this!)

Getting started

hledger Step by Step tutorial

Journal management

Start a journal
Track changes with version control

Account names

PTA: choosing accounts
Rewrite account names
Use another account separator character

Journal entries

Basic journal entries
Project accounting

Data entry/import

Convert CSV files

Investing

Track investments

More..

Save frequently used options
PTA: Common tasks

Reference

Reference manuals, covering every part of hledgers functionality.

File formats

hledger_journal(5) is hledgers native data format, representing an accounting journal

hledger_csv(5) allows CSV import/export

hledger_timeclock(5) is for clock-in/clock-out time logging

hledger_timedot(5) is for human-friendly time logging

Core tools

hledger(1) is the command-line UI

hledger-ui(1) is a curses-style UI

hledger-web(1) is a web UI

hledger-api(1) is a HTTP-JSON API

Addon tools

(cf download -> D)

hledger-diff shows differences in an accounts transactions between one journal file and another.

hledger-iadd is a curses-style replacement for hledgers add command.

hledger-interest generates interest transactions for an account according to various schemes.

hledger-irr calculates the internal rate of return of an investment account.

Some experimental tools:

hledger-budget.hs adds Ledger-style periodic transactions and budget reports.

hledger-check.hs checks more powerful account balance assertions.

Also:

ledger-autosync, can download, deduplicate and/or convert OFX data (includes hledger support, rename/symlink it to hledger-autosync to see it in commands list)

PTA: related tools lists all known plain text accounting helper tools