# pub.solar finances
This repository is used to track the finances of pub.solar transparently.
We use [hledger](https://hledger.org/) to create finance report in a minimalistic, terminal friendly
way.
### Finances report table
Income Statement 2023-01-01..2024-12-31
Commodity
2023
2024
Total
Revenues
donations:member
€
415.00
390.00
805.00
donations:non-member
€
87.00
74.43
161.43
total
€
502.00
464.43
966.43
Expenses
infra:domain
€
52.40
0
52.40
infra:file-storage
€
26.02
11.77
37.79
infra:server
€
124.47
91.87
216.34
total
€
202.89
103.64
306.53
Net:
€
299.11
360.79
659.90
### Import new statements
* place csv file into import directory
* rename to `expenses.csv` for expenses or
* rename to `donations-member.csv` for donations of members
* rename to `donations-non-member.csv` for donations of non-members
* execute `hledger import -f finances.hledger import/`
### Quick start how to use hledger
Installing hledger with [nix](https://nixos.org/download), the package manager.
```
git clone gitea@git.pub.solar:pub-solar/finances.git finances && cd $_
nix develop
```
or with [direnv](https://github.com/nix-community/nix-direnv).
```
git clone gitea@git.pub.solar:pub-solar/finances.git finances && cd $_
direnv allow
```
Creating a report without negative numbers
```
hledger incomestatement --file ./finances.hledger --layout bare --pretty --drop 1
```
Creating a web report, viewable in a browser
```
hledger-web --file ./finances.hledger
```
Writing a HTML table to the README
```
hledger incomestatement --file ./finances.hledger --layout bare --pretty --drop 1 --output-format html --yearly --row-total | sed -i '8r /dev/stdin' README.md
sed -i '14,17d' README.md
```