mirror of
https://github.com/simonmichael/hledger.git
synced 2024-12-27 20:36:07 +03:00
58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
|
# Start a journal
|
||
|
|
|
||
|
|
## by hand
|
||
|
|
|
||
|
|
(power users)
|
||
|
|
|
||
|
|
The simplest possible journal is just an empty file:\
|
||
|
|
`echo >2017.journal`
|
||
|
|
|
||
|
|
Record a transaction, using [journal format](/journal.html):
|
||
|
|
```shell
|
||
|
|
$ cat >>2017.journal
|
||
|
|
2017/1/26
|
||
|
|
expenses:food $10
|
||
|
|
assets:cash
|
||
|
|
<CTRL-D>
|
||
|
|
```
|
||
|
|
|
||
|
|
[Account names](/journal.html#account-names) can be anything
|
||
|
|
and you can change them later by search and replace.
|
||
|
|
If you don't know what to [choose](http://plaintextaccounting.org/#choosing-accounts),
|
||
|
|
start with these five:\
|
||
|
|
`expenses`, `income`, `assets`, `liabilities`, and `equity`,\
|
||
|
|
perhaps with one extra subcategory as above.
|
||
|
|
|
||
|
|
## by text editor
|
||
|
|
|
||
|
|
Use a [text editor](/journal.html#editor-support) to add transactions and save the file.
|
||
|
|
|
||
|
|
## by add
|
||
|
|
|
||
|
|
Use the [add](/hledger.html#add) command:\
|
||
|
|
`hledger add -f 2017.journal`\
|
||
|
|
enter one or more transactions
|
||
|
|
|
||
|
|
## set `LEDGER_FILE`
|
||
|
|
|
||
|
|
To avoid typing `-f FILE` every time, set the
|
||
|
|
[`LEDGER_FILE` environment variable](/hledger.html#input-files). Eg:\
|
||
|
|
`echo "export LEDGER_FILE=~/finance/2017.journal" >> ~/.bash_profile && source ~/.bash_profile`
|
||
|
|
|
||
|
|
Most examples here assume you have done this.
|
||
|
|
|
||
|
|
## by hledger-iadd
|
||
|
|
|
||
|
|
ensure $LEDGER_FILE exists\
|
||
|
|
`hledger iadd`\
|
||
|
|
enter one or more transactions
|
||
|
|
|
||
|
|
## by hledger-web
|
||
|
|
|
||
|
|
ensure $LEDGER_FILE exists\
|
||
|
|
`hledger web`\
|
||
|
|
wait for web browser to open\
|
||
|
|
click "add transaction" or press "a"\
|
||
|
|
enter a transaction, click ok or press enter
|
||
|
|
|