slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

site: update intro blurb & faq, link ledger more prominently

Browse Source
This commit is contained in:
Simon Michael 2011-07-15 00:27:12 +00:00
parent bd17d37dee
commit 7b36e2d398
2 changed files with 45 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
MANUAL.md
View File

@ -37,30 +37,44 @@ This is the manual for hledger 0.14.0.
## Frequently asked questions ## Frequently asked questions
- **How does hledger relate to John Wiegley's ledger project ?** - **How does hledger relate to [John Wiegley's ledger](http://ledger-cli.org) ?**
hledger was very much inspired by, and is partly a clone of, Short version: hledger is a friendly, co-evolving, compatible
[ledger](http://wiki.github.com/jwiegley/ledger) (also called "c++ reimplementation in Haskell, lacking some of ledger's power features
ledger" in these docs.) I was a happy ledger user and contributor for and raw performance, and focussing on robustness, usability, ease of
some time, and I still use it occasionally. I wrote hledger because I development, and experimental add-ons, notably the (separate,
wanted to develop financial tools in the Haskell programming language optional) [web interface](#web).
and ecosystem, whose advantages I believe are compelling. I have also
tried to make hledger a little more simple, usable, installable, and
documented, and to provide alternate user interfaces and other
enhancements to make it more widely useful.
ledger has more advanced command-line power features (periodic
transactions, budgets, capital gains tracking, value expressions,
custom output formats, ...) and it remains faster and more memory
efficient on large data files.
The two projects (indeed the whole family of ledger-inspired projects)
collaborate freely, and we share ledger's IRC channel (but have our
own mail list.) We stay compatible with ledger wherever possible,
intending that you can use both tools on the same data, each for its
strengths. Here is
[more detail about compatibility](#compatibility-with-c-ledger).
Long version:
hledger was inspired by and is partly a clone of ledger (also called
"c++ ledger" here.) I was a happy ledger user and contributor for some
time; I still use it occasionally. I wrote hledger because I wanted to
develop financial tools in the Haskell programming language and
ecosystem, whose advantages I believe are compelling. I have also
tried to make hledger a little more simple, usable, installable,
documented, appealing to collaborators, and to provide alternate user
interfaces to make it more widely useful.
ledger has more advanced power-user features on the command-line
(periodic and modifier transactions, budgets, capital gains tracking,
value expressions, custom output formats, etc.) and it remains faster
and more memory efficient (for now!)...
hledger builds faster and has an up-to-date manual and an optional web
interface (which often works on ledger files too)...
The two projects collaborate freely. We share the
[#ledger](irc://irc.freenode.net/#ledger) IRC channel but have
separate mail lists
([hledger list](http://groups.google.com/group/hledger/),
[ledger-cli list](http://groups.google.com/group/ledger-cli/)). I try
to give back by providing infrastructure
([ledger-cli.org](http://ledger-cli.org)) and IRC support.
hledger stays compatible with ledger wherever possible, so that you
can often use both tools on the same data file. Here is
[more about compatibility](#compatibility-with-c-ledger).
## Installing ## Installing
hledger works on all major platforms *(except microsoft windows, as of hledger works on all major platforms *(except microsoft windows, as of
@ -822,8 +836,10 @@ Examples:
The web command starts a web server providing a web-based user interface, The web command starts a web server providing a web-based user interface,
and if possible opens a web browser to view it. The web UI combines the and if possible opens a web browser to view it. The web UI combines the
features of the print, register, balance and add commands, and adds a features of the print, register, balance and add commands, and also
general edit command. supports data entry and modification. You can see it in action here:
[current release demo](http://demo.hledger.org),
[latest development demo](http://demo.hledger.org:5001).
There are some web-specific options: There are some web-specific options:

11
README.md
View File

@ -4,12 +4,11 @@ title: hledger
# hledger # hledger
hledger is a computer program for easily tracking money, time, or hledger is a computer program for easily tracking money, time, or other
other commodities, using standard accounting principles. It is commodities, inspired by [ledger](MANUAL.html#faq). It is quite limited in
quite limited in features, but reliable. For some, it is a features, but lightweight and reliable. For some, it is a bare-bones,
bare-bones, less complex, less expensive alternative to Quicken or simpler, less expensive alternative to Quicken or GnuCash.
Microsoft Money. hledger is available for free under the GNU It is available for free under the GNU General Public License.
General Public License.
hledger aims to help both computer experts and every-day users gain hledger aims to help both computer experts and every-day users gain
clarity in their finances and time management. I use it every day clarity in their finances and time management. I use it every day