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	422.87	837.87
donations:non-member	€	87.00	119.43	206.43
total	€	502.00	542.30	1044.30
Expenses
infra:domain	€	52.40	0	52.40
infra:file-storage	€	26.02	23.44	49.46
infra:server	€	124.47	162.20	286.67
total	€	202.89	185.64	388.53
Net:	€	299.11	356.66	655.77

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 's|</table>|</table>\n|' \
  | sed -i '/^<style>/,/^<\/style>/{
      r /dev/stdin
      d
    }' README.md