doc: move tutorial to Guide, update addons, blurbs

[ci skip]
This commit is contained in:
Simon Michael 2017-10-31 13:36:06 -07:00
parent 18d7c4b02c
commit c5cf6bcaad

View File

@ -48,11 +48,6 @@ For more docs relevant to all ledger-likes, see [plaintextaccounting.org](http:/
[Release notes](release-notes.html)\ [Release notes](release-notes.html)\
### Getting started
[hledger Step by Step](step-by-step.html) tutorial\
</div> </div>
@ -61,6 +56,14 @@ For more docs relevant to all ledger-likes, see [plaintextaccounting.org](http:/
## [Guide](guide.html){title="all on one page"} ## [Guide](guide.html){title="all on one page"}
A growing collection of tutorials, how-tos and discussion of general topics.
(Please help complete this!)
### Getting started
[hledger Step by Step](step-by-step.html) tutorial\
### Journal management ### Journal management
[Start a journal](start-journal.html)\ [Start a journal](start-journal.html)\
@ -102,6 +105,8 @@ For more docs relevant to all ledger-likes, see [plaintextaccounting.org](http:/
## [Reference](manual.html){title="all on one page"} ## [Reference](manual.html){title="all on one page"}
Reference manuals, covering every part of hledger's functionality.
### File formats ### File formats
[hledger_journal(5)](journal.html) [hledger_journal(5)](journal.html)
@ -116,7 +121,7 @@ is for clock-in/clock-out time logging
[hledger_timedot(5)](timedot.html) [hledger_timedot(5)](timedot.html)
is for human-friendly time logging is for human-friendly time logging
### Tools ### Core tools
[hledger(1)](hledger.html) [hledger(1)](hledger.html)
is the command-line UI is the command-line UI
@ -132,7 +137,7 @@ is a HTTP-JSON API
### Addon tools ### Addon tools
Available [on Hackage/Stackage](/download.html#d): (cf [download -> D](download.html#d))
[hledger-diff](http://hackage.haskell.org/package/hledger-diff) [hledger-diff](http://hackage.haskell.org/package/hledger-diff)
shows differences in an account's transactions between one journal file and another. shows differences in an account's transactions between one journal file and another.
@ -146,47 +151,22 @@ generates interest transactions for an account according to various schemes.
[hledger-irr](http://hackage.haskell.org/package/hledger-irr) [hledger-irr](http://hackage.haskell.org/package/hledger-irr)
calculates the internal rate of return of an investment account. calculates the internal rate of return of an investment account.
### Experimental tools Some experimental tools:
Available [in the hledger repo](/download.html#d):
[hledger-autosync](https://github.com/simonmichael/hledger/blob/master/bin/hledger-autosync)
is a symbolic link for running
[ledger-autosync](https://pypi.python.org/pypi/ledger-autosync),
which can download or convert OFX data.
[hledger-budget.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-budget.hs#L10) [hledger-budget.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-budget.hs#L10)
adds Ledger-style periodic transactions and budget reports. adds Ledger-style periodic transactions and budget reports.
[hledger-chart.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-chart.hs#L47)
is an old pie chart generator.
[hledger-check.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-check.hs) [hledger-check.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-check.hs)
checks more powerful account balance assertions. checks more powerful account balance assertions.
[hledger-check-dates.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-check-dates.hs#L15) Also:
checks that journal entries are ordered by date.
[hledger-check-dupes.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-check-dupes.hs#L21) [ledger-autosync](https://pypi.python.org/pypi/ledger-autosync),
checks for account names sharing the same leaf name. can download, deduplicate and/or convert OFX data (includes hledger support,
rename/symlink it to hledger-autosync to see it in commands list)
[hledger-equity.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-equity.hs#L17) [PTA: related tools](http://plaintextaccounting.org/#related-tools)
prints balance-clearing/restoring transactions, useful for bringing account balances across file boundaries. lists all known plain text accounting helper tools
[hledger-prices.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-prices.hs)
prints all prices from the journal.
[hledger-print-unique.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-print-unique.hs#L15)
prints transactions with unique descriptions.
[hledger-register-match.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-register-match.hs#L23)
helps ledger-autosync ignore previously imported transactions.
[hledger-rewrite.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-rewrite.hs#L28)
adds Ledger-style automatic postings to existing transactions.
[hledger-tags.hs](https://github.com/simonmichael/hledger/blob/master/bin/hledger-tags.hs)
lists tag names in use.
</div> <!-- col --> </div> <!-- col -->