Simon Michael edited this page Feb 18, 2019 · 83 revisions

Welcome to the hledger Cookbook! This complements the main hledger website and reference docs with additional how-tos, tutorials, notes, etc. Unlike the main content, it is stored in hledger's Github wiki. This means you can make quick edits via Github's web UI, without pull requests or tool setup. Please edit freely!

Editing tips:

  • Use the links below to organise Cookbook content. They (everything from the "Cookbook" heading down) will automatically appear on the hledger.org home page.
  • Github wikis help
  • editing requires a github account
  • edit by web, or by git clone, local edit, git push
  • link between wiki pages: [[Pagename]] or [[Other text|Pagename]]. Pagename is case insensitive and can have spaces.
  • link to wiki pages from elsewhere: https://github.com/simonmichael/hledger/wiki/Pagename. Pagename is case insensitive and can have spaces.
  • link to hledger manual sections from the wiki: http://hledger.org/manual#anchor. anchor is any manual heading's text, lowercased with punctuation removed and spaces replaced by hyphens.
  • when renaming a page, try also to update the links to it
  • For the most accurate rendering, live updating etc., you may prefer to render the hledger website and cookbook locally, with live updating, etc. In your copy of the hledger repo, clone the wiki to ./wiki and try make help-site, make site-liverender, make site-livereload, ./Shake help etc.

Cookbook

Getting started

hledger basics tutorial
hledger terminology
Create a journal
hledger accounting concepts
Common journal entries
FAQ
Accounting links

Managing data

Convert CSV files
Customize default CSV accounts
Track changes with version control
Use another account separator character
"Full-fledged Hledger" setup →
"hledger: Make It So" setup →

Reporting

Queries
hledger tags tutorial
Rewrite account names

Accounting tasks

hledger multicurrency tutorial
Foreign trip expenses
Budgeting and forecasting
Project accounting
Track investments
Time planning

Usage tips

Addons
Command-line completion
Editor configuration
hledger-web tips
Mobile apps
Save frequently used options
Scripting

See also...

plaintextaccounting.org (software, docs, common tasks, discussion)  →
Ledger (docs, wiki)  →
Beancount (docs)  →

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.