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-10-28
	Commodity	2023	2024	Total
Revenues
bank:interest	€	0	1.20	1.20
donations:member	€	415.00	1097.87	1512.87
donations:non-member	€	87.00	313.43	400.43
total	€	502.00	1412.50	1914.50
Expenses
infra:domain	€	52.40	0	52.40
infra:file-storage	€	26.02	48.24	74.26
infra:server	€	124.47	460.54	585.01
total	€	202.89	508.78	711.67
Net:	€	299.11	903.72	1202.83

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