Skip to content

Commit

Permalink
Re-generate docs
Browse files Browse the repository at this point in the history
  • Loading branch information
xuhcc committed Jun 20, 2021
1 parent f45d8ae commit 735d20f
Show file tree
Hide file tree
Showing 10 changed files with 11 additions and 5 deletions.
8 changes: 7 additions & 1 deletion docs/external_contributions.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Plugins<a id="plugins"></a>

[<span class="underline">beancount-plugins</span>](https://github.com/davidastephens/beancount-plugins): Dave Stephens created a repository to share various of his plugins related to depreciation.

[<span class="underline">beancount-plugins-zack</span>](https://github.com/zacchiro/beancount-plugins-zack): Stefano Zacchiroli created this repository to share his plugins.
[<span class="underline">beancount-plugins-zack</span>](https://github.com/zacchiro/beancount-plugins-zack): Stefano Zacchiroli created this repository to share his plugins. Contains sorting of directives and more.

<span class="underline">b[eancount-oneliner](https://github.com/Akuukis/beancount-oneliner)</span>: Akuukis created a plugin to write an entry in one line ([<span class="underline">PyPi</span>](https://pypi.python.org/pypi/beancount-oneliner/1.0.0)).

Expand All @@ -46,6 +46,8 @@ Plugins<a id="plugins"></a>

[<span class="underline">autobean.narration</span>](https://git.io/autobean.narration) (Archimedes Smith): Allows to annotate each posting in a concise way by populating per-posting narration metadata from inline comments.

[<span class="underline">autobean.sorted</span>](https://github.com/SEIAROTg/autobean/): Checks that transactions are in non-descending order in each file. Helps identifying misplaced or misdated directives, by warning on those directives not following a non-descending order by date in the file.

Tools<a id="tools"></a>
-----------------------

Expand Down Expand Up @@ -90,6 +92,10 @@ Importers<a id="importers"></a>

[<span class="underline">Beanborg</span>](https://github.com/luciano-fiandesio/beanborg) (Luciano Fiandesio): Beanborg automatically imports financial transactions from external CSV files into the Beancount bookkeeping system.

[<span class="underline">szabootibor/beancount-degiro</span>](https://gitlab.com/szabootibor/beancount-degiro) ([<span class="underline">PyPI</span>](https://pypi.org/project/beancount-degiro)): Importer for the trading accounts of the Dutch broker Degiro.

[<span class="underline">https://github.com/siddhantgoel/beancount-ing-diba</span>](https://github.com/siddhantgoel/beancount-ing-diba) ([<span class="underline">PyPI</span>](https://pypi.org/project/beancount-ing-diba/)): ING account importer (NL).

Converters<a id="converters"></a>
---------------------------------

Expand Down
8 changes: 4 additions & 4 deletions docs/sharing_expenses_with_beancount.md
Original file line number Diff line number Diff line change
Expand Up @@ -267,7 +267,7 @@ During this trip I did not carry a laptop—this was vacation after all. I like

These notes look like this:

<img src="sharing_expenses_with_beancount/media/1a614f1e796245370dd17906a9115eca79d78756.png" alt="sharing-example-note-taking.png" style="width:6.5in;height:3.68056in" />
<img src="sharing_expenses_with_beancount/media/6eccd752444847a6f97ae99b34a046074a39ddd8.png" alt="sharing-example-note-taking.png" style="width:6.5in;height:3.68056in" />

I made a paper spreadsheet where each line had

Expand All @@ -292,23 +292,23 @@ You can view the balances in the “All Transactions” view (click on “All Tr

The Balance Sheet should show empty balances for Assets accounts:

<img src="sharing_expenses_with_beancount/media/2a9a41808ed0e2b5fec809a5fde47f4e205646b5.png" alt="balsheet.png" style="width:6.28646in;height:2.57906in" />
<img src="sharing_expenses_with_beancount/media/2b7f16e905c9fe8c22ed0ee11d3fd9199dbf139a.png" alt="balsheet.png" style="width:6.28646in;height:2.57906in" />

The balances of the equity accounts should reflect the total amount of currency conversions made during the trip. You can verify this by calculating the amount-weight average rate like this: 7539.00 / 559.88 ~= 13.465 USD/MXN (which is about right).

### Reviewing Contributions<a id="reviewing-contributions"></a>

The Income Statement should show a summary of all expenses and contributions to the project:

<img src="sharing_expenses_with_beancount/media/a8d4c5e20494c749682470c47ba891cc1e32d47f.png" alt="income.png" style="width:6.41468in;height:4.30729in" />
<img src="sharing_expenses_with_beancount/media/725237ab95f02c9bfbb8700f307d591c2ab82f95.png" alt="income.png" style="width:6.41468in;height:4.30729in" />

The Income account balances show the total amounts of contributions for each person. Note that in creating the Income accounts, I went through the extra step of creating some specific accounts for each source of payment, like “Caroline’s Credit Card”, etc.

From this view, we can see that we contributed a total of 4254.28 USD (and were left with 65 MXN in hand) for this trip. The expenses side should match, considering the currency exchanges: 3694.40 + 7474 / 13.465 ~= 4249 USD which is approximately right (the small difference can be explained by the varying currency conversions).

If you want to view the list of contribution payments and the final balance, click on a particular traveler’s root account, e.g., “Income:Caroline” (click on “Caroline”) which should take you to the Journal for that root account:

<img src="sharing_expenses_with_beancount/media/9954279c84e3e4f951c125bffc0550f09bb82bc0.png" alt="caroline.png" style="width:6.5in;height:4.63889in" />
<img src="sharing_expenses_with_beancount/media/064623b8b809747c335fdc4eb4a0bc9efc7dbc15.png" alt="caroline.png" style="width:6.5in;height:4.63889in" />

This journal includes all the transactions in its sub-accounts. The final value at the bottom should show the total balance of those accounts, and thus, the amount of money Caroline contributed to this trip: 415 USD, and kept 5 MXN (in coin). We can do the same for Martin and find the final balance of 3839.28 USD and kept 60 MXN (in bills).

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.

0 comments on commit 735d20f

Please sign in to comment.