hledger/README2
2009-12-05 06:47:21 +00:00

88 lines
3.8 KiB
Plaintext

hledger for techies
===================
hledger_ is a remix, in haskell_, of John Wiegley's excellent ledger_ accounting tool.
It reads a plain text `ledger file`_ or timelog_ describing your transactions
and displays reports via `command line`_, curses_ or `web interface`_ (click for a demo).
The hledger project aims to produce:
- a practical, accessible, dependable tool for end users
- a useful library and toolbox for finance-minded haskell programmers
- a successful, time-and-money-solvent project within a thriving ecosystem of financial software projects.
hledger is free software by `Simon Michael`_ & `co.`_, released under GNU GPLv3.
**Learn**
manual_, news_, screenshots_, `some extra tips`_
**Download**
``cabal install hledger``,
or try these ready-to-run binaries_,
or see the `installing docs <MANUAL.html#installing>`_
**Develop**
``darcs get http://joyful.com/repos/hledger``,
`browse the repo`_,
`code docs`_,
`hackage page`_,
notes_,
benchmark_\/profile_\/heap_\/coverage_ reports
.. raw:: html
<a name="support" />
**Support**
- chat Simon (sm) on the `#ledger`_ irc channel which we share, or `email me`_
- report problems in the `issue tracker`_
- .. raw:: html
<form action="http://groups.google.com/group/hledger/boxsubscribe" >
join the <a href="http://hledger.org/list">mail list</a>. Your email:
<input type=text name=email><input type=submit name="sub" value="Subscribe">
</form>
**Related projects**
- John Wiegley's ledger_ inspired hledger, and we try to stay compatible. You can often use both tools on the same ledger file.
- Uwe Hollerbach's umm_ is another haskell tool inspired by h/ledger.
- Tim Docker's ledger-reports_ uses hledger as a library to generate `html reports`_.
- I have a few older bits and pieces `here <http://joyful.com/Ledger>`_.
.. raw:: html
<a href="http://joyful.com/darcsweb/darcsweb.cgi?r=hledger;a=shortlog"><img src=http://joyful.com/repos/hledger/commits.png border=0></a>
<a href="https://www.google.com/analytics/reporting/?reset=1&id=15489822" accesskey="a"></a>
.. _hledger: README.html
.. _`ledger file`: http://joyful.com/repos/hledger/sample.ledger
.. _timelog: http://joyful.com/repos/hledger/sample.timelog
.. _command line: SCREENSHOTS.html#hledger-screen-1
.. _curses: SCREENSHOTS.html#sshot
.. _web interface: http://demo.hledger.org
.. _mail list: http://list.hledger.org
.. _issue tracker: http://bugs.hledger.org
.. _binaries: http://hledger.org/binaries/
.. _manual: MANUAL.html
.. _news: NEWS.html
.. _screenshots: SCREENSHOTS.html
.. _code docs: http://hledger.org/api-doc
.. _notes: http://joyful.com/darcsweb/darcsweb.cgi?r=hledger;a=plainblob;f=/NOTES
.. _benchmark: http://hledger.org/profs/latest.bench
.. _profile: http://hledger.org/profs/latest.prof
.. _heap: http://hledger.org/profs/latest.ps
.. _coverage: http://hledger.org/profs/coverage/hpc_index_fun.html
.. _browse the repo: http://joyful.com/darcsweb/darcsweb.cgi?r=hledger
.. _email me: mailto:simon@joyful.com
.. _Simon Michael: http://joyful.com
.. _co.: http://hledger.org/CONTRIBUTORS.html
.. _hackage page: http://hackage.haskell.org/package/hledger
.. _#ledger: irc://irc.freenode.net/#ledger
.. _haskell: http://haskell.org
.. _ledger: http://wiki.github.com/jwiegley/ledger
.. _umm: http://www.korgwal.com/umm/
.. _ledger-reports: http://dockerz.net/repos/ledger-reports
.. _html reports: http://dockerz.net/software/hledger_report_sample/report.html
.. _some extra tips: http://podcastle.org/2009/10/09/pc-miniature-38-accounting-for-dragons/