Konfigurácia možností v Beancount

Správanie Beancountu je možné prispôsobiť pomocou direktív option umiestnených v hornej časti vášho hlavného súboru knihy. Tieto páry kľúč-hodnota riadia všetko od názvov vašich koreňových účtov až po spôsob spracovania konverzií mien. Správna konfigurácia týchto možností je nevyhnutná na prispôsobenie Beancountu vašim špecifickým potrebám. ⚙️

Základné možnosti konfigurácie

Tieto možnosti riadia základné nastavenie vašej knihy.

Základné nastavenia

Toto sú niektoré z najbežnejších možností, ktoré nastavíte.

option "title" "Osobná kniha"
option "render_commas" "TRUE"
option "plugin_processing_mode" "raw"

• title: Nastavuje názov pre správy a webové rozhrania.
• render_commas: Ak je TRUE, čísla v správach budú formátované s oddeľovačmi tisícov (napr. 1,000,000.00).
• plugin_processing_mode: Riadi spôsob načítavania zásuvných modulov (pluginov). raw načíta iba zásuvné moduly, ktoré explicitne určíte, zatiaľ čo default obsahuje štandardnú sadu užitočných zásuvných modulov.

Prispôsobenie názvu účtu

Môžete premenovať päť základných typov účtov Beancountu. Je to čisto kozmetické a mení to, ako sa zobrazujú v správach.

option "name_assets" "Aktíva"
option "name_liabilities" "Pasíva"
option "name_equity" "Vlastné imanie"
option "name_income" "Príjmy"
option "name_expenses" "Výdavky"

Konfigurácia účtu vlastného imania

Beancount automaticky vytvára niekoľko špeciálnych účtov vlastného imania na spracovanie úvodných zostatkov a výpočtov príjmu. Môžete zadať vlastné názvy pre tieto účty.

option "account_previous_balances" "Úvodné-Zostatky"
option "account_previous_earnings" "Zisky:Predošlé"
option "account_current_earnings" "Zisky:Súčasné"
option "account_previous_conversions" "Konverzie:Predošlé"
option "account_current_conversions" "Konverzie:Súčasné"
option "account_rounding" "Zaokrúhľovanie"

• account_previous_balances: Účet použitý na vloženie úvodných zostatkov do vašej knihy.
• account_current_earnings: Účet, ktorý kumuluje všetky príjmy a výdavky za текуче obdobie, efektívne vypočítava váš čistý príjem.
• account_rounding: Účet, na ktorý sa zaúčtovávajú malé rozdiely z automatického zaokrúhľovania.

Nastavenia presnosti a tolerancie

Tieto možnosti riadia, ako Beancount spracováva zaokrúhľovanie a malé nerovnováhy v transakciách.

Predvolená konfigurácia tolerancie

Beancount môže automaticky odvodiť toleranciu pre transakcie s viacerými menami alebo nákladmi, čo umožňuje malé rozdiely v zaokrúhľovaní bez toho, aby spôsobili chyby.

option "inferred_tolerance_default" "USD:0.01"
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

• inferred_tolerance_default: Nastavuje predvolenú toleranciu pre danú menu. Môžete použiť *:0.5 na nastavenie predvolenej hodnoty pre všetky meny.
• inferred_tolerance_multiplier: Faktor, ktorý sa použije na toleranciu, aby sa zabezpečila o niečo väčšia tolerancia.
• infer_tolerance_from_cost: Ak je True, tolerancia sa odvodí z počtu číslic v nákladoch.

Metóda účtovania

Táto možnosť definuje, ako Beancount spracováva transakcie, kde je jedna strana odvodená.

option "booking_method" "SIMPLE"

• SIMPLE: Umožňuje automatické vyrovnanie iba jednej komodity na transakciu. Toto je odporúčaná a najbežnejšia metóda.
• FULL: Umožňuje vyrovnanie viacerých komodít, čo je zložitejšia a zriedkavo potrebná metóda.

Správa mien

Správna konfigurácia mien je nevyhnutná pre presné vykazovanie.

Prevádzková mena

Môžete deklarovať jednu alebo viac "prevádzkových mien". Toto sú hlavné meny, v ktorých uskutočňujete transakcie a ktoré chcete vidieť v správach.

option "operating_currency" "USD"
option "operating_currency" "EUR"
option "conversion_currency" "NOTHING"

Deklarovanie prevádzkových mien hovorí Beancountu, aby vytvoril vyhradené stĺpce pre ne v správach, čo uľahčuje zobrazenie vašej finančnej pozície vo vašich najpoužívanejších menách. Nastavenie conversion_currency na NOTHING deaktivuje stĺpec automatickej konverzie, čo sa často uprednostňuje pre čistejšie správy.

Správa dokumentov

Beancount môže prepojiť transakcie s externými súbormi, ako sú potvrdenky alebo faktúry. Možnosť documents určuje koreňový priečinok (priečinky), kde sú tieto súbory uložené.

option "documents" "/path/to/documents/archive"

Požiadavky:

• Súbory musia byť pomenované vo formáte RRRR-MM-DD.popis.ext (napr. 2025-07-28.amazon-order.pdf).
• Môžete zadať viacero možností documents pre rôzne priečinky.
• Cesty môžu byť absolútne alebo relatívne k hlavnému súboru knihy.

Systém zásuvných modulov

Funkcionalitu Beancountu je možné rozšíriť pomocou zásuvných modulov (pluginov).

Konfigurácia zásuvných modulov

Zásuvný modul povolíte zadaním jeho cesty k modulu.

option "plugin" "beancount.plugins.module_name"

Ako už bolo spomenuté, možnosť plugin_processing_mode riadi, či Beancount načíta iba vaše zadané zásuvné moduly (raw) alebo aj predvolenú sadu (default).

Technické limity a obmedzenia

Tieto možnosti riadia technické aspekty analyzátora Beancountu.

Spracovanie reťazcov

Môžete nastaviť limit na počet riadkov povolených vo viacriadkovom reťazci, aby ste predišli chybám pri analýze.

option "long_string_maxlines" "64"

Experimentálne funkcie

Beancount niekedy obsahuje experimentálne funkcie, ktoré môžete povoliť pomocou možnosti. Napríklad, ak chcete povoliť explicitnú syntax tolerancie:

option "experiment_explicit_tolerances" "True"

To vám umožní zadať toleranciu priamo v zaúčtovaní transakcie, napríklad takto: 532.23 ~ 0.001 USD.

Kontroly správania systému

Tieto možnosti slúžia na zachovanie kompatibility alebo špecifických správaniach systému.

Podpora starších verzií

Táto možnosť umožňuje staré, pevné hodnoty tolerancie pre spätnú kompatibilitu so staršími knihami.

option "use_legacy_fixed_tolerances" "True"

Pevné staršie tolerancie boli:

• Direktívy Balance/Pad: 0.015 jednotiek
• Transakcie: 0.005 jednotiek

Odporúčaná konfigurácia ✅

Pre väčšinu používateľov nasledujúca konfigurácia poskytuje robustný a rozumný východiskový bod.

Základné nastavenie

option "title" "Osobná kniha"
option "operating_currency" "USD"  // Zmeňte na svoju primárnu menu
option "documents" "/home/user/Documents/beancount" // Zmeňte na cestu k vašim dokumentom
option "render_commas" "TRUE"

Kontrola presnosti

option "inferred_tolerance_default" "USD:0.01" // Zmeňte na svoju primárnu menu
option "inferred_tolerance_multiplier" "1.1"
option "infer_tolerance_from_cost" "True"

Štruktúra účtov

option "account_previous_balances" "Vlastné imanie:Úvodné-Zostatky"
option "account_current_earnings" "Vlastné imanie:Súčasné-Zisky"
option "account_rounding" "Výdavky:Zaokrúhľovanie"

Toto nastavenie poskytuje pevný základ pre novú knihu Beancount, čím zabezpečuje prehľadné vykazovanie, rozumnú kontrolu presnosti a logickú štruktúru účtu vlastného imania.