diff --git a/src/index.md b/src/index.md index 16ef37e..3944d82 100644 --- a/src/index.md +++ b/src/index.md @@ -16,81 +16,65 @@ Welcome! This site collects the PTA community's tools, docs and practices. It is maintained by Simon Michael (hledger project leader, PTA fan) and contributors like you. -We invite you to join the [chat](#news-discussion), -or make edits to the [github repo](https://github.com/plaintextaccounting/plaintextaccounting). +We invite you to join the [chat](#news-discussion) +or improve the [content](https://github.com/plaintextaccounting/plaintextaccounting). - -Page contents: -\ -**[News & discussion](#news-discussion)** -- [Articles & blog posts](#articles-blog-posts) -- [Videos](#videos) -- [Slideshows](#slideshows) -\ +**Site map:**\ +**[[Newcomer FAQ]]**\ +**[News & discussion](#news-discussion)**\ +**[Blogs & articles](#blogs-articles)**\ +**[Videos](#videos)**\ +**[Slides](#slides)**\ **[Docs](#docs)** - [Accounting](#accounting) -- [PTA app docs](#pta-app-docs) -- [Comparisons](#comparisons) -- [Intros](#intros) -- [Cheatsheets](#cheatsheets) -- [Cookbooks](#cookbooks) +, [PTA app docs](#pta-app-docs) +, [comparisons](#comparisons) +, [intros](#intros) +, [cheatsheets](#cheatsheets) +, [cookbooks](#cookbooks) +\ +**[[Cookbook|PTA Cookbook]]** +- [[Cookbook#getting-started|Getting started]] +, [[Cookbook#general-usage|General usage]] +, [[Cookbook#accounting-situations|Accounting situations]] \ **[Software](#software)** - [PTA apps](#pta-apps) -- [Editor plugins](#editor-plugins) -- [Data import/conversion](#data-importconversion) -- [Price fetching](#price-fetching) -- [Data generation](#data-generation) -- [Formatting](#formatting) -- [Reporting](#reporting) -- [Time logging](#time-logging) -- [UI, console](#ui-console) -- [UI, curses](#ui-curses) -- [UI, GUI](#ui-gui) -- [UI, web](#ui-web) -- [UI, mobile](#ui-mobile) -- [Library](#library) -- [Utilities](#utilities) -- [API](#api) - -See also: -\ -**[[Newcomer FAQ]]** -- [[Newcomer FAQ#what-is-this|What is this]] -- [[Newcomer FAQ#objections-and-concerns|Objections and concerns]] -\ -**[[Cookbook]]** -- [[Cookbook#getting-started|Getting Started]] -- [[Cookbook#general-usage|General usage]] -- [[Cookbook#accounting-situations|Accounting situations]] -\ -**[[quickref/|Syntax quick reference]]** -- [[quickref/ledger|Ledger]] -- [[quickref/hledger|hledger]] -- [[quickref/beancount|Beancount]] - - +, [Editor plugins](#editor-plugins) +, [Data import/conversion](#data-importconversion) +, [Price fetching](#price-fetching) +, [Data generation](#data-generation) +, [Formatting](#formatting) +, [Reporting](#reporting) +, [Time logging](#time-logging) +, [UI, console](#ui-console) +, [UI, curses](#ui-curses) +, [UI, GUI](#ui-gui) +, [UI, web](#ui-web) +, [UI, mobile](#ui-mobile) +, [Library](#library) +, [Utilities](#utilities) +, [API](#api) ## News & discussion **Site news** -- *2023-11 wiki [merged](https://github.com/plaintextaccounting/plaintextaccounting/issues/129) into the website* - [commits](https://github.com/plaintextaccounting/plaintextaccounting/commits/master) - [contributors](https://github.com/plaintextaccounting/plaintextaccounting/graphs/contributors) - [issues](https://github.com/plaintextaccounting/plaintextaccounting/issues?q=is%3Aissue+) \ **Chat** -- [Matrix](https://matrix.to/#/#plaintextaccounting:matrix.org) (~100) -- [all matrix rooms](https://matrix.to/#/#plaintextaccounting-space:matrix.org) - [IRC](https://web.libera.chat/#plaintextaccounting) (~50) -- [PTA app chats](#pta-apps) +- [matrix](https://matrix.to/#/#plaintextaccounting:matrix.org) (~100) +- [matrix space (room list)](https://matrix.to/#/#plaintextaccounting-space:matrix.org) +- [app-specific chats](#pta-apps) \ **Mail lists** -- [PTA apps' mail lists](#pta-apps) +- [app-specific mail lists](#pta-apps) \ **Reddit** - [/r/plaintextaccounting](https://www.reddit.com/r/plaintextaccounting/new) @@ -123,11 +107,11 @@ See also: - [This Week In Hledger](https://hledger.org/news.html) -### Articles & blog posts +## Blogs & articles *A partial list, contributions welcome* -2023 +### 2023 - [Robert Nielsen: Fixing my mistake after accidentally adding pending transactions](https://hledgerfan.com/fixing-my-mistake-after-accidentally-adding-pending-transactions/) 2023-12-28 - [Robert Nielsen: A better desc(ription)](https://hledgerfan.com/a-better-description/) 2023-12-21 @@ -166,13 +150,13 @@ See also: - [Jonathan Dowland: date warping in HLedger](https://jmtd.net/log/date_warping/) - [Jonathan Dowland: HLedger, 1 year on](https://jmtd.net/log/hledger_1yr/) -2022 +### 2022 - [Jonathan Dowland: eventual consistency](https://jmtd.net/log/eventual_consistency/) - [Jonathan Dowland: dues (or blues)](https://jmtd.net/log/hledger/dues/) - [Jonathan Dowland: hledger](https://jmtd.net/log/hledger/) -2021 +### 2021 - [Jonathan Dowland: hledger footguns](https://jmtd.net/log/hledger_footguns/) - [Arsen Arsenović: Keeping track of finances from many places](https://www.aarsen.me/posts/2021-08-13-personal-finances-with-hledger.html) @@ -180,7 +164,7 @@ See also: - [Duarte O.Carmo: Hacking on my finances (Part 2: Beancount on Beanstalk)](https://duarteocarmo.com/blog/hacking-on-my-finances-part-2-beancount-on-beanstalk.html) -2020 +### 2020 - [Duarte O.Carmo: Hacking on my finances](https://duarteocarmo.com/blog/hacking-on-my-finances.html) - [Conversations in Code: Episode 3 / Introduction to Plain Text Accounting](https://www.reddit.com/r/plaintextaccounting/comments/ivrbdu/announcing_a_new_podcast_fossopensource_related/) [podcast] @@ -196,7 +180,7 @@ See also: - [Lee Yingtong Li: Incorrect accounting of unrealised gains in ledger-cli](https://yingtongli.me/blog/2020/03/31/ledger-gains.html) - [Christian Egli: Quick and dirty PDF reports for Plain Text Accounting](https://egli.dev/posts/quick-and-dirty-pdf-reports-for-plain-text-accounting/) -2019 +### 2019 - [Lee Yingtong Li: FIFO inventory with ledger-cli](https://yingtongli.me/blog/2019/12/11/ledger-fifo.html) - [Justin Kaipada: Managing Ledger for Humans](https://www.kaipada.com/post/managing-ledger-for-humans/) @@ -213,7 +197,7 @@ See also: -2018 +### 2018 - [Felix Crux: Tracking Accounts Jointly and Separately](https://felixcrux.com/blog/ledger-practices-tracking-accounts-jointly-and-separately) - [Pepijn Looije: Real World Ledger part 1: Weighing Eggs in Baskets](https://p.epij.nl/ledger-cli/accounting/2018/08/23/real-world-ledger-part-1/) @@ -224,7 +208,7 @@ See also: - [Michael Walker: Personal Finance](https://memo.barrucadu.co.uk/personal-finance.html) - [Siddhant Goel: Managing Personal Finances using Python](https://sgoel.dev/posts/managing-personal-finances-using-python/) -2017 +### 2017 - [Michael Walker: I Need A Budget](https://www.barrucadu.co.uk/posts/etc/2017-12-16-i-need-a-budget.html) - [Accounting for the simple minds with plain text accounting](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html) @@ -236,7 +220,7 @@ See also: - [Michael Walker: Visualise your finances with hledger, InfluxDB, and Grafana](https://www.barrucadu.co.uk/posts/etc/2017-05-18-visualise-your-finances-with-hledger-influxdb-grafana.html) - [Brady Trainor: Hledger web](https://bradyt.com/2017/04/28/Hledger-web/) -2016 +### 2016 - [Felix Crux: Accrual vs. Cash Basis Accounting](https://felixcrux.com/blog/ledger-practices-accrual-vs-cash-basis-accounting) - [bsilvereagle: Envelope Budgeting with ledger](https://frdmtoplay.com/envelope-budgeting-with-ledger) @@ -249,30 +233,30 @@ See also: - [Alex Johnstone: Managing my personal finances with beancount](https://alexjj.com/posts/2016/managing-my-personal-finances-with-beancount/) -2015 +### 2015 - [Pete Keen: Program Your Finances: Algorithmic Savings](https://www.petekeen.net/program-your-finances-algorithmic-savings) - [Pete Keen: Program Your Finances: Envelope Budgeting](https://www.petekeen.net/program-your-finances-envelope-budgeting) - [Stefano Rodighiero: hledger-dupes](https://stefanorodighiero.net/posts/2015-01-04-hledger-find-duplicate-accounts.html) -2014 +### 2014 - [Matthew Turland: Ledger basics and habits](http://matthewturland.com/2014/03/29/ledger-basics-and-habits/) -2013 +### 2013 - [Simon Michael: What is hledger?](http://joyful.com/blog/2013-10-20-what-is-hledger.html) - [Simon Michael: More on ledger](http://joyful.com/blog/2013-10-19-more-on-ledger.html) - [Simon Michael: Introducing hledger!](http://joyful.com/blog/2013-10-18-introducing-hledger.html) -2012 +### 2012 - [Joey Hess: hledger](http://joeyh.name/blog/entry/hledger) - [Gene Goykhman: An Alternative to QuickBooks](http://goykhman.ca/gene/blog/2012/2012-09-23-an-alternative-to-quickbooks.html) - [LWN: The accounting quest: Ledger](http://lwn.net/Articles/501681/) - [Pete Keen: A Robust Reporting System for Ledger](https://www.petekeen.net/a-robust-reporting-system-for-ledger) -2011 +### 2011 - [Pete Keen: Program your Finances: Automated Transactions](https://www.petekeen.net/program-your-finances-automated-transactions) - [Sascha Welter: Doing my own accounting](http://betabug.ch/blogs/ch-athens/1221) @@ -280,7 +264,7 @@ See also: - [Pete Keen: Program your Finances: Vacation Tracking](https://www.petekeen.net/program-your-finances-vacation-tracking) - [Pete Keen: Program your Finances: Reporting for Fun and Profit](https://www.petekeen.net/program-your-finances-reporting-for-fun-and-profit) -2010 +### 2010 - [Pete Keen: Program your Finances: Command-line Accounting](https://www.petekeen.net/keeping-finances-with-ledger) - [Christine Spang: [h]ledger rocks my world](http://blog.spang.cc/posts/hledger_rocks_my_world/) @@ -288,16 +272,16 @@ See also: -2009 +### 2009 - [советы: Ledger — бухучёт в командной строке](http://s.arboreus.com/2009/05/personal-accounting-in-command-line.html) ([english](http://translate.google.com/translate?hl=en&sl=ru&u=http://s.arboreus.com/2009/05/personal-accounting-in-command-line.html)) -2006 +### 2006 - [Joe Barr: Ledger, the bran muffin of accounting tools](https://www.linux.com/news/ledger-bran-muffin-accounting-tools) -### Videos +## Videos - [Glenn Ramsey: Plain text accounting for fun and profit](https://youtube.com/watch?v=lazZwTmAEHs) 2022 - [Simon Michael: Inside hledger: an architectural tour and how-to](https://www.youtube.com/watch?v=6PKmZSHxu0c) 2021 @@ -319,7 +303,7 @@ See also: - [Khan Academy: Accounting and financial statements](https://www.khanacademy.org/economics-finance-domain/core-finance/accounting-and-financial-stateme) - [David Mitchell: Personal Debts](https://www.youtube.com/watch?v=9zyp8RF-Fyw) -### Slideshows +## Slides - [Simon Michael: Inside hledger: an architectural tour and how-to](https://rawcdn.githack.com/simonmichael/hledger/4013a81af8dd2804c73ecac18fb3e7e4745a4275/doc/haskellerz/haskellerz.slidy.html) 2021 - [Michael Lynch](https://decks.mtlynch.io/plaintext-acccounting/) 2021 @@ -330,10 +314,18 @@ See also: ## Docs +**[Accounting](#accounting) +, [PTA app docs](#pta-app-docs) +, [Comparisons](#comparisons) +, [Intros](#intros) +, [Cheatsheets](#cheatsheets) +, [Cookbooks](#cookbooks) +** + ### Accounting -- [hledger: Accounting basics and further study](https://hledger.org/accounting.html) - [hledger: Accounting links](https://hledger.org/accounting.html#accounting-links) +- [hledger: Accounting basics](https://hledger.org/accounting.html) - [Beancount: The Double-Entry Counting Method](https://docs.google.com/document/d/100tGcA4blh6KSXPRGCZpUlyxaRUwFHEvnz_k9DyZFn4) - [Accounting for Computer Scientists](https://martin.kleppmann.com/2011/03/07/accounting-for-computer-scientists.html) - [Accounting for Dragons](https://podcastle.org/2009/10/09/pc-miniature-38-accounting-for-dragons) @@ -393,7 +385,23 @@ See also: ## Software -PTA apps and additional helper tools, by category: +**[PTA apps](#pta-apps) +, [Editor plugins](#editor-plugins) +, [Data import/conversion](#data-importconversion) +, [Price fetching](#price-fetching) +, [Data generation](#data-generation) +, [Formatting](#formatting) +, [Reporting](#reporting) +, [Time logging](#time-logging) +, [UI, console](#ui-console) +, [UI, curses](#ui-curses) +, [UI, GUI](#ui-gui) +, [UI, web](#ui-web) +, [UI, mobile](#ui-mobile) +, [Library](#library) +, [Utilities](#utilities) +, [API](#api) +**