;doc:beancount output: edits

This commit is contained in:
Simon Michael 2024-12-06 07:54:45 -10:00
parent 82fde8d2dc
commit 32182a05fc

View File

@ -832,17 +832,18 @@ You can use this to export your hledger data to [Beancount], eg to use the [Fava
hledger will try to adjust your data to suit Beancount, automatically. hledger will try to adjust your data to suit Beancount, automatically.
Be cautious and check the conversion until you are confident it is good. Be cautious and check the conversion until you are confident it is good.
If you plan to export to Beancount often, you may want to follow its [conventions], to make conversion easier: If you plan to export to Beancount often, you may want to follow its [conventions], for a cleaner conversion:
- Beancount-friendly account names
- currency codes instead of currency symbols - use Beancount-friendly account names
- costs instead of conversion postings - use currency codes instead of currency symbols
- no virtual postings, etc. - use cost notation instead of equity conversion postings
- avoid virtual postings
[conventions]: https://plaintextaccounting.org/#other-features [conventions]: https://plaintextaccounting.org/#other-features
Note there is one big adjustment you must handle yourself: There is one big adjustment you must handle yourself:
when exporting data for Beancount, your top level account names must be `Assets`, `Liabilities`, `Equity`, `Income`, and/or `Expenses`. for Beancount, the top level account names must be `Assets`, `Liabilities`, `Equity`, `Income`, and/or `Expenses`.
If needed you can use [account aliases](#alias-directive) to rewrite your account names temporarily. You can use [account aliases](#alias-directive) to rewrite your account names temporarily, if needed,
as in this [hledger2beancount.conf](https://github.com/simonmichael/hledger/blob/master/examples/hledger2beancount.conf) config file. as in this [hledger2beancount.conf](https://github.com/simonmichael/hledger/blob/master/examples/hledger2beancount.conf) config file.
<!-- (see also "hledger and Beancount" <https://hledger.org/beancount.html>). --> <!-- (see also "hledger and Beancount" <https://hledger.org/beancount.html>). -->