112 lines
5.0 KiB
Plaintext
112 lines
5.0 KiB
Plaintext
hledger
|
|
=======
|
|
***double-entry accounting.. just the numbers***
|
|
|
|
Welcome! hledger is a software tool for double-entry accounting.
|
|
It reads a plain text
|
|
`ledger file`_ or `timelog`_ describing your transactions and displays
|
|
precise reports via
|
|
`command-line <SCREENSHOTS.html#hledger-screen-1>`_,
|
|
`curses <SCREENSHOTS.html#sshot>`_ or
|
|
`web interface <http://hledger.org:5000/balance>`_.
|
|
|
|
hledger aims to be:
|
|
|
|
- a practical, accessible, dependable 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.
|
|
|
|
hledger is free software by Simon Michael & co., released under GNU GPLv3.
|
|
It is a remix, in haskell_, of John Wiegley's excellent c++ ledger_.
|
|
|
|
|
|
.. raw:: html
|
|
<a name="contact" />
|
|
|
|
.. comment
|
|
|
|
.. raw:: html
|
|
|
|
<a href="SCREENSHOTS.html#hledger-screen-1"><img src=hledger-screen-1.png border=0 height=100 title="Basic command-line reports, like ledger"></a>
|
|
<a href="SCREENSHOTS.html#sshot"><img src=sshot.png border=0 height=100 title="The interactive curses interface"></a>
|
|
<a href="SCREENSHOTS.html#watchhours"><img src=watchhours.png border=0 height=100 title="A time dashboard in emacs"></a>
|
|
|
|
Getting started
|
|
---------------
|
|
hledger works on all major platforms.
|
|
One of these `experimental binaries`_ might work for you.
|
|
Otherwise: install the `Haskell Platform`_, then ``cabal install hledger``.
|
|
See also the `User's Guide`_ | News_ | `Screenshots <SCREENSHOTS.html>`_ as well as c++ ledger's `home page`_ and manual_.
|
|
|
|
If you're a developer, you can get the latest code with ``darcs get http://joyful.com/repos/hledger`` or `browse with darcsweb`_.
|
|
See also the `Developer API docs`_ | `Developer Notes`_ | `Contributor List`_ |
|
|
hackage_ page | latest benchmark_, profile_, heap_, `test coverage`_ reports.
|
|
|
|
.. include:: NEWS
|
|
|
|
Getting help
|
|
-------------
|
|
To get help or share tips, use one of the channels below.
|
|
Reports and/or patches for website issues, unclear/stale/missing
|
|
docs, or any difficulty encountered while installing, using, or
|
|
contributing to hledger are appreciated!
|
|
|
|
- chat Simon (sm) on the `#ledger irc channel`_ which we share with ledger
|
|
- join the `hledger google group`_
|
|
- use the `issue tracker`_
|
|
- for something private, `email me`_.
|
|
|
|
.. comment
|
|
.. 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
|
|
----------------
|
|
- John Wiegley's ledger_ inspired hledger, and the two projects are coevolving. If you like hledger, try ledger too.
|
|
- Tim Docker's ledger-reports_ uses hledger as a library to generate `html reports`_.
|
|
- I have a few older bits and pieces at http://joyful.com/Ledger .
|
|
|
|
.. raw:: html
|
|
|
|
<a href="https://www.google.com/analytics/reporting/?reset=1&id=15489822" accesskey="a"></a>
|
|
|
|
|
|
.. _`ledger file`: http://joyful.com/repos/hledger/sample.ledger
|
|
.. _timelog: http://joyful.com/repos/hledger/sample.timelog
|
|
.. _balance: http://hledger.org:5000/balance
|
|
.. _register: http://hledger.org:5000/register?a=checking&p=weekly
|
|
.. _hledger google group: http://groups.google.com/group/hledger
|
|
.. _issue tracker: http://code.google.com/p/hledger/issues/list?can=1&q=&colspec=ID+Type+Status+Priority+Milestone+Owner+Summary&x=status&y=type&mode=grid&cells=tiles
|
|
.. _experimental binaries: http://hledger.org/binaries/
|
|
.. _User's Guide: README.html
|
|
.. _News: NEWS.html
|
|
.. _Contributor List: CONTRIBUTORS.html
|
|
.. _Developer API docs: http://hledger.org/api-doc
|
|
.. _Developer 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
|
|
.. _test coverage: http://hledger.org/profs/coverage/hpc_index_fun.html
|
|
.. _browse with darcsweb: http://joyful.com/darcsweb/darcsweb.cgi?r=hledger
|
|
.. _email me: mailto:simon@joyful.com
|
|
.. _Simon Michael: http://joyful.com
|
|
.. _haskell: http://haskell.org
|
|
.. _GHC: http://haskell.org/ghc
|
|
.. _cabal: http://haskell.org/cabal/download.html
|
|
.. _Haskell Platform: http://hackage.haskell.org/platform/
|
|
.. _hackage: http://hackage.haskell.org/cgi-bin/hackage-scripts/package/hledger
|
|
.. _#ledger irc channel: irc://irc.freenode.net/#ledger
|
|
.. _ledger: http://wiki.github.com/jwiegley/ledger
|
|
.. _home page: http://wiki.github.com/jwiegley/ledger
|
|
.. _manual: http://joyful.com/repos/ledger/doc/ledger.html
|
|
.. _ledger-reports: http://dockerz.net/repos/ledger-reports
|
|
.. _html reports: http://dockerz.net/software/hledger_report_sample/report.html
|
|
|
|
|
|
.. rst quick reference: http://docutils.sourceforge.net/docs/user/rst/quickref.html
|
|
|
|
.. Local variables:
|
|
.. mode: rst
|
|
.. End:
|