81 lines
3.4 KiB
Plaintext
81 lines
3.4 KiB
Plaintext
hledger
|
|
=======
|
|
|
|
**Welcome! hledger is...**
|
|
|
|
- a command-line (or curses or web-based) double-entry accounting tool. It reads a
|
|
`plain text ledger <http://joyful.com/repos/hledger/sample.ledger>`_
|
|
describing your transactions and displays precise
|
|
`balance <http://hledger.org:5000/balance>`_ and
|
|
`register <http://hledger.org:5000/register?a=checking>`_ reports.
|
|
- a remix, in `haskell <http://haskell.org>`_, of John Wiegley's excellent
|
|
c++ `ledger <http://wiki.github.com/jwiegley/ledger>`_
|
|
- a Free Software project developed since 2008 by
|
|
`Simon Michael <http://joyful.com>`_ and contributors.
|
|
|
|
**hledger aims to be...**
|
|
|
|
- a practical, accessible tool for end users. I use it every day to track money and time.
|
|
- a useful library for finance-minded haskell programmers
|
|
- a successful, time-and-money-solvent project within a thriving ecosystem of financial software projects.
|
|
|
|
**To get help...**
|
|
|
|
- chat me (sm) on the `#ledger irc channel <irc://irc.freenode.net/#ledger>`_ which we share with ledger
|
|
- join the `hledger google group <http://groups.google.com/group/hledger>`_
|
|
- for something private, `email me <mailto:simon@joyful.com>`_.
|
|
|
|
Download
|
|
--------
|
|
hledger works on all major platforms, but does not yet have binaries or platform packages;
|
|
you'll need to install `GHC <http://haskell.org/ghc>`_ and `cabal
|
|
<http://www.haskell.org/cabal/download.html>`_, then
|
|
install hledger from `hackage
|
|
<http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hledger>`_ with:
|
|
``cabal install hledger``
|
|
|
|
Documentation
|
|
-------------
|
|
`User's Guide <README.html>`_
|
|
| `News <NEWS.html>`_
|
|
| c++ ledger's `home page <http://wiki.github.com/jwiegley/ledger>`_
|
|
and `manual <http://joyful.com/repos/ledger/doc/ledger.html>`_
|
|
|
|
`Developer API docs <http://hledger.org/api-doc>`_
|
|
| `Developer Notes <http://joyful.com/darcsweb/darcsweb.cgi?r=hledger;a=plainblob;f=/NOTES>`_
|
|
| `Contributor List <CONTRIBUTORS.html>`_
|
|
| latest `benchtest <http://joyful.com/repos/hledger/profs/latest.bench>`_,
|
|
`profile <http://joyful.com/repos/hledger/profs/latest.prof>`_,
|
|
`heap <http://joyful.com/repos/hledger/profs/latest.ps>`_
|
|
reports
|
|
|
|
Screenshots
|
|
-----------
|
|
|
|
.. raw:: html
|
|
|
|
<a href="SCREENSHOTS.html#hledger-screen-1"><img src=http://hledger.org/hledger-screen-1.png border=0 height=100></a>
|
|
<a href="SCREENSHOTS.html#sshot"><img src=http://hledger.org/sshot.png border=0 height=100></a>
|
|
<a href="SCREENSHOTS.html#watchhours"><img src=http://hledger.org/watchhours.png border=0 height=100></a>
|
|
|
|
Code repository
|
|
---------------
|
|
``darcs get http://joyful.com/repos/hledger``
|
|
|
|
or `browse with darcsweb <http://joyful.com/darcsweb/darcsweb.cgi?r=hledger>`_. Patches applied to this repo are announced on #ledger by hledgerbot.
|
|
|
|
.. 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>
|
|
|
|
Related projects
|
|
----------------
|
|
- `ledger <http://wiki.github.com/jwiegley/ledger>`_ inspired hledger, and the two projects are coevolving. If you like hledger, try ledger too.
|
|
- Tim Docker's `ledger-reports <http://dockerz.net/repos/ledger-reports>`_ uses hledger as a library to generate `html reports <http://dockerz.net/software/hledger_report_sample/report.html>`_.
|
|
- I have a few older bits and pieces at http://joyful.com/Ledger .
|
|
|
|
.. easy analytics access
|
|
.. raw:: html
|
|
|
|
<a href="https://www.google.com/analytics/reporting/?reset=1&id=15489822" accesskey="a"></a>
|