Verified Commit 07e09249 authored by 35V LG84's avatar 35V LG84

site: sync with 'site'

[skip-ci]
Signed-off-by: 35V LG84's avatar35V LG84 <[email protected]>
parents 00000250 e2b59835
Pipeline #58801581 skipped
= Accounts.conf
:page-date: 2019-03-29 00:00:00 Z
:page-last_modified_at: 2019-03-29 00:00:00 Z
:page-last_modified_at: 2019-04-24 00:00:00 Z
accounts.conf contains Chart of Accounts (CoA) for Tackler,
and other accounts and commodities related settings.
......@@ -58,6 +58,8 @@ accounts {
# Characters can be a wide range of
# international UTF-8 characters.
#
# See https://tackler.e257.fi/docs/journal/charsets/ for full list.
#
# Or in other words:
#
# account
......@@ -70,7 +72,12 @@ accounts {
# = (NameStartChar | '0'..'9') (NameChar)*
#
# NameStartChar
# = 'A'..'Z' | 'a'..'z'
# = '$' | '¢' | '£' | '¤' | '¥' // not in block 20A0-20CF
# | '\u00B5' // Micro Sign
# | '\u00B9' | '\u00B2' | '\u00B3' // not in block 2070-209F
# | '\u00B0' // Degree Sign
# | '\u00BC' | '\u00BD' | '\u00BE' // not in block 2150-218F
# | 'A'..'Z' | 'a'..'z'
# | '\u00C0'..'\u00D6'
# | '\u00D8'..'\u00F6'
# | '\u00F8'..'\u02FF'
......@@ -123,6 +130,8 @@ accounts {
# Characters can be a wide range of
# international UTF-8 characters.
#
# See https://tackler.e257.fi/docs/journal/charsets/ for full list.
#
# Or in other words:
#
# commodity
......@@ -136,6 +145,9 @@ accounts {
#
# Example list of commodities:
commodities = [
"€",
"$",
"¥",
"EUR",
"USD",
"He·bar",
......
= Commodities
:page-date: 2019-03-29 00:00:00 Z
:page-last_modified_at: 2019-03-29 00:00:00 Z
:page-last_modified_at: 2019-04-24 00:00:00 Z
Commodity is something which doesn't have value without unit of measurement.
......@@ -12,46 +12,64 @@ Typically it is possible to transform commodity transactions between same commod
but with different unit of measurement as long as there is well defined,
constant conversion between those units.
For example: `42 oz Au` -> `1306.3460256 g Au` -> `1.3063460256 kg Au`.
For example: `42 Au oz` -> `1306.3460256 Au g` -> `1.3063460256 Au kg`.
However, at the moment automatic commodity unit conversions are not supported with Tackler,
but this is something which will be implemented in the future.
Commodity name (and combined unit) has to be a valid `ID` element (same rules applies as with account names).
For example, tracking Helium and Oxygen, you could use units `bar·He` and `bar·O2`:
For example, tracking Helium and Oxygen, you could use units `He·bar` and `O2·bar`:
....
Gas:Tank·102 298 bar·He
Gas:Tank·208 195 bar·O2
Gas:Tank·102 298 He·bar
Gas:Tank·208 195 O2·bar
....
if your tank sizes are known and fixed.
== Transactions with mixed commodities
Transactions with mixed commodities without value positions are not allowed.
Example of mixed commodity transaction without value positions:
Example of invalid mixed commodity transaction without value positions:
....
2017-05-01 'this is not valid
Vault:Bullion 1 g·Au
Vault:Bullion 4 g·Ag
2017-05-01 'This is invalid
Vault:Bullion 1 Au·g
Vault:Bullion 4 Ag·g
Assets:Cash
....
Mixed commodities must be converted to common commodity with value positions:
....
2017-05-01 'this is valid
Vault:Bullion 1 g·Au @ 37.00 EUR
Vault:Bullion 1 g·Ag @ 0.495 EUR
2017-05-01 'This is valid
Vault:Bullion 1 Au·g @ 37.00 EUR
Vault:Bullion 1 Ag·g @ 0.495 EUR
Assets:Cash
....
=== About He·bar and O2·bar
Strictly speaking it doesn't make sense to track gas pressures,
because you have to also know tank size to figure out actual amount of gas.
So original example of He and O2 tanks could be written in following way:
....
2019-04-01 'Gas amount in liters
Gas:Tank·102 298 He·bar @ 50 He·l
Gas:Tank·208 195 O2·bar @ 50 O2·l
....
assuming that 50 liter storage tanks are used.
== Example
For example see an accounting example for scuba diving
xref:./examples/trimix-filling-station.adoc[Trimix Filling and Mixing Station]. It demonstrates how to track different
commodities and how to convert those commodities to monetary values.
xref:./examples/trimix-filling-station.adoc[Trimix Filling and Mixing Station].
It demonstrates how to track different commodities
and how to convert those commodities to monetary values.
......@@ -8,7 +8,8 @@ Examples of currencies and shares are: EUR, USD, NOKIA, etc. Currencies
and shares could be used as plain values without quantity unit.
Currency and share name has to be a valid `ID` element (same rules applies as with account names).
Examples of valid names are `ACME·INC`, `EUR`, etc.
Examples of valid names are `€`, `$`, `¥`, `ACME·INC`, `EUR`, etc. See
xref:./journal/charsets.adoc[Character Sets] for full list of all supported signs, scripts and languages.
== Transactions with mixed currencies or shares
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment