finances/README.md

pub.solar finances

This repository is used to track the finances of pub.solar transparently. We use hledger 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/<csv-file>

Quick start how to use hledger

Installing hledger with nix, the package manager.

git clone gitea@git.pub.solar:pub-solar/finances.git finances && cd $_
nix develop

or with 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