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	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/<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 | sed -i '8r /dev/stdin' README.md
sed -i '14,17d' README.md