# 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
280.00
695.00
donations:non-member
€
87.00
50.00
137.00
total
€
502.00
330.00
832.00
Expenses
infra:domain
€
52.40
0
52.40
infra:file-storage
€
26.02
2.24
28.26
infra:server
€
124.47
88.06
212.53
total
€
202.89
90.30
293.19
Net:
€
299.11
239.70
538.81
### 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 >> README.md
```