Možnosti Fava

Nakonfigurujte štandardnú Fava pomocou datovaných smerníc custom "fava-option". Tieto nastavenia sú oddelené od základných možností Beancount.

Táto referenčia bola vykonaná s Beancount 3.2.3, beanquery 0.2.0 a Fava 1.30.16. Matica popisuje toto štandardné vydanie. Beancount.io má samostatný dashboard a backend; jeho zobrazené nastavenia nedokazujú, že každá funkcia štandardnej Fava je tam dostupná.

Syntax​

Hodnoty sú reťazce v úvodzovkách, vrátane celých čísel a boolovských hodnôt. Tento kompletný príklad sa parsuje v Beancount aj Fava:

; Minimal Fava configuration
option "operating_currency" "USD"
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "show-closed-accounts" "false"

Dátum je povinný. Fava spracováva načítané vlastné smernice v poradí podľa dátumu; neskoršie skalárne nastavenie nahrádza skoršie. Opakované nastavenia collapse-pattern, import-dirs a insert-entry sa akumulujú. Pravidlá vkladania používajú svoje dátumy na výber cieľa, takže tieto dátumy sú zmysluplné.

Na reprodukciu príkladov lokálne nainštalujte uv, potom vytvorte dočasné prostredie:

uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'beancount==3.2.3' 'beanquery==0.2.0' 'fava==1.30.16'
source .venv-fava-docs/bin/activate
bean-check main.beancount
fava main.beancount

Najprv vytvorte main.beancount z konfiguračného bloku, alebo použite existujúcu účtovnú knihu. Príkazy shellu vyššie používajú cesty POSIX. bean-check kontroluje syntax a účtovníctvo Beancount; Fava navyše kontroluje vlastné názvy možností a hodnoty. Skontrolujte aj prehľad chýb Fava.

Predvolené hodnoty nižšie boli načítané z nainštalovanej dataclass FavaOptions a skontrolované proti verzovanému parseru možností. „Unset“ znamená None; prázdna kolekcia znamená žiadne nakonfigurované položky. Stĺpec typ hodnoty popisuje obsah reťazca v úvodzovkách.

Pre boolovské hodnoty použite "true" alebo "false". Porovnanie nerozlišuje veľké a malé písmená: "TRUE" tiež aktivuje možnosť. Akýkoľvek iný reťazec ako variant "true" sa považuje za false. Jeho parser celých čísel kontroluje syntax celého čísla, nie kladný rozsah; používajte kladné veľkosti rozloženia a nezáporné počty.

Zobrazenie a Lokalizácia​

language​

Nastavuje preklad rozhrania, napríklad "en", "de" alebo "zh_CN". Keď nie je nastavené, Fava vyjednáva s prehliadačom. Lokalita musí mať preklad dodávaný Fava; samotný syntakticky platný jazykový kód nestačí.

locale​

Nastavuje formátovanie čísel nezávisle od jazyka rozhrania, napríklad "en_US" alebo "de_DE". Bez tejto možnosti Fava používa svoj nelokalizovaný vzor čísel. Základné option "render_commas" "TRUE" poskytuje fallback en. Nededí jazyk prehliadača.

Navigácia a Rozloženie​

default-page​

Nastavuje cieľ v rámci účtovnej knihy, napríklad "balance_sheet/" alebo "journal/?time=year". Skopírujte časť za slug účtovnej knihy z fungujúcej adresy URL štandardnej Fava. Nepridávajte na začiatok /: cesty prehľadov sú relatívne k tejto účtovnej knihe.

fiscal-year-end​

Nastavuje hranice fiškálneho časového filtra. Napríklad "03-31" ukončí fiškálny rok 31. marca. Podporuje filtre fiškálneho roka a štvrťroka; nemení dátumy transakcií. Fava tiež akceptuje hodnoty mesiaca nad 12 na označenie fiškálneho roka končiaceho v nasledujúcom kalendárnom roku.

indent​

Nastavuje odsadenie položiek pre generované záznamy a formátovanie editora. Použite reťazec kladného celého čísla, napríklad "4".

currency-column​

Nastavuje stĺpec zarovnania meny pri ukladaní alebo zarovnávaní položiek. Tiež umiestňuje vertikálne vodidlo editora. Predvolené je "61".

Viditeľnosť Obsahu​

show-closed-accounts​

Zahŕňa uzavreté účty do stromov účtov prehľadov. Účty s nenulovými zostatkami zostávajú viditeľné bez ohľadu na toto nastavenie.

show-accounts-with-zero-transactions​

Zahŕňa účty bez transakcií do stromov účtov. Nepotláča účet s nenulovým zostatkom.

show-accounts-with-zero-balance​

Zahŕňa účty, ktorých zostatok prehľadu je nula. Vypnite ju pomocou "false" pre kratší strom.

collapse-pattern​

Porovnáva názvy účtov na zbalenie v stromoch účtov. Opakujte smernicu pre viacero vzorov. Napríklad "^Assets:Investments" zbalí tento účet a jeho potomkov.

sidebar-show-queries​

Obmedzuje počet uložených dotazov prepojených v bočnom paneli. "0" skryje tieto odkazy. Pozri vlastné odkazy a dotazy.

show-metadata-indicators​

Zobrazuje malé odznaky metadát v denníkoch. Nastavte ju na "false" na skrytie odznakov bez odstránenia metadát z účtovnej knihy.

Správa Súborov​

default-file​

Vyberá súbor pôvodne otvorený editorom a fallback cieľ pre nové záznamy. Relatívna cesta sa rieši zo súboru obsahujúceho smernicu. Bez hodnoty sa vyberie obsahujúci súbor. Bez tejto možnosti je hlavný súbor účtovnej knihy fallback. Existujúci súbor musí byť tiež zahrnutý v účtovnej knihe, aby bol upraviteľným zdrojom.

insert-entry​

Umiestňuje nový záznam pred zodpovedajúcu vlastnú smernicu v súbore obsahujúcom túto smernicu. Jeho regulárny výraz porovnáva názov účtu od začiatku; nikdy nehľadá v surových riadkoch súboru. Fava zvažuje položky transakcie od poslednej po prvú. Pre prvý účet s oprávnenou zhodou vyberie najnovšie pravidlo datované striktne pred novým záznamom. Ak sa nič nezhoduje, pripojí do predvoleného súboru. Implementácia vkladania je autoritou pre tieto pravidlá.

Vytvorte tieto tri súbory v rovnakom adresári. main.beancount poskytuje účty a zahrnutia:

; main.beancount
option "title" "Insertion Demo"
option "operating_currency" "USD"
include "january.beancount"
include "february.beancount"
2000-01-01 open Assets:Checking USD
2000-01-01 open Assets:Cash USD
2000-01-01 open Assets:Wallet USD
2000-01-01 open Expenses:Food USD
2000-01-01 custom "fava-option" "default-file"
2024-01-01 custom "fava-option" "insert-entry" "^Expenses:Food$"

january.beancount obsahuje:

; january.beancount
2024-01-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

february.beancount obsahuje:

; february.beancount
2024-02-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

Spustite Fava s main.beancount. Pridajte tieto transakcie cez jej formulár transakcií; sú vstupom pre operáciu vkladania, nie extra súborom na zahrnutie vopred:

2024-01-15 * "January groceries"
  Expenses:Food       10.00 USD
  Assets:Checking    -10.00 USD
 
2024-02-01 * "Same-day boundary"
  Expenses:Food       20.00 USD
  Assets:Checking    -20.00 USD
 
2024-02-15 * "February groceries"
  Expenses:Food       30.00 USD
  Assets:Checking    -30.00 USD
 
2024-02-16 * "Cash groceries"
  Expenses:Food       40.00 USD
  Assets:Cash        -40.00 USD
 
2024-02-17 * "Unmatched cash transfer"
  Assets:Cash         50.00 USD
  Assets:Wallet      -50.00 USD

Prvé dva záznamy idú pred januárové pravidlo. Tretí ide pred februárové pravidlo. Štvrtý skúša Assets:Cash, nenájde zhodu, potom použije pravidlo Expenses:Food v hlavnom súbore. Piaty nemá zodpovedajúci účet a pripojí do main.beancount. Uloženie dávky aktualizuje čísla riadkov pravidiel, keď sa záznamy vkladajú.

auto-reload​

Automaticky znovu načíta stránku, keď Fava zistí zmenu externého zdroja. Keď je false, Fava ponúka oznámenie o znovu načítaní. Zmeny vykonané cez samotnú Fava už spúšťajú znovu načítanie.

use-external-editor​

Otviera odkazy zdrojov cez schému URL beancount://. Nainštalujte handler na počítači spúšťajúcom prehliadač a zabezpečte, aby mal prístup k súborom účtovnej knihy. Toto nie je automatické pripojenie k súborom na hostovanom serveri.

import-config​

Ukazuje na konfiguráciu Python importéra. Toto je integračné nastavenie: vytvorte konfiguráciu a nainštalujte závislosti importéra pred použitím prehľadu Import. Tri vyššie pripnuté balíky neposkytujú konfiguráciu bankového importéra.

import-dirs​

Pridáva adresár na skenovanie kandidátov na import. Opakujte smernicu na pridanie adresárov. Používajte skutočné prístupné adresáre; nastavenie možnosti ich nevytvára.

Finančné Zobrazenie​

unrealized​

Nie je štandardná možnosť Fava 1.30.16. Fava hlási Unknown option nasledované názvom v spätných apostrofoch, ak ju pridáte. Nepoužívajte ju na konfiguráciu štandardných účtov nerealizovaných ziskov.

Snímka zdrojového kódu Beancount.io preskúmaná 2026-09-07 skutočne vystavuje samostatné reťazcové pole s názvom unrealized, s predvoleným "Unrealized", vo svojom backendovom parseri možností a tabuľke Nastavenia dashboardu. To overuje, že pole tam existuje. Nezakladá, že jeho zmena vytvára Income:Unrealized alebo Expenses:Unrealized, ani že konkrétne nasadenie spúšťa túto snímku.

invert-income-liabilities-equity​

Otočí zobrazené znamienka Výnosov, Záväzkov a Vlastného imania vo výkaze ziskov a strát a súvahe. Náklady si zachovávajú svoje znamienka. Záznamy denníka, denníky účtov a uložené položky zostávajú nezmenené.

conversion-currencies​

Nahrádza voľby rozbaľovacieho zoznamu konverzií zoznamom oddeleným medzerami v jednom reťazci:

; Conversion dropdown
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"

Opakovanie tejto možnosti nahrádza predchádzajúci zoznam. Keď nie je nastavené, Fava ponúka prevádzkové meny plus komodity, ktoré rozpoznáva ako meny ISO 4217.

account-journal-include-children​

Zahŕňa záznamy podúčtov do denníka účtu predvolene. Nastavte ju na "false", aby ste začali iba s týmto účtom.

invert-gains-losses-colors​

Obráti farby použité pre nerealizované zisky a straty v zobrazeniach súvahy v trhových hodnotách a skúšobnej súvahy. Mení farby, nie sumy alebo názvy účtov.

Monitorovanie​

uptodate-indicator-grey-lookback-days​

Riadi obdobie spätného pohľadu sivého indikátora aktuálnosti. Povoľte indikátory účtov pomocou fava-uptodate-indication: TRUE na smernici open účtu; pozri príklad metadát UI.

upcoming-events​

Riadi počet oznámení v bočnom paneli pre nadchádzajúce udalosti v rámci špecifikovaného počtu dní. "0" deaktivuje počet.

Odporúčaná Konfigurácia​

Táto kompletná konfigurácia je východiskovým bodom pre štandardné prostredie vyššie. Mení nastavenia zobrazenia bez načítania pluginov alebo vyžadovania extra súborov:

option "operating_currency" "USD"
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "locale" "en_US"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
2000-01-01 custom "fava-option" "fiscal-year-end" "12-31"
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "true"
2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"
2000-01-01 custom "fava-option" "show-metadata-indicators" "true"
2000-01-01 custom "fava-option" "collapse-pattern" "^Assets:Investments"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
2000-01-01 custom "fava-option" "auto-reload" "false"
2000-01-01 custom "fava-option" "use-external-editor" "false"
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
2000-01-01 custom "fava-option" "invert-gains-losses-colors" "false"
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"
2000-01-01 custom "fava-option" "account-journal-include-children" "true"
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Zobrazenie Vašich Aktuálnych Možností​

V štandardnej Fava otvorte jej stránku Pomoc → Možnosti pre referenčiu nainštalovaného vydania a skontrolujte Chyby po zmene smernice. Oficiálna pomoc k možnostiam 1.30.16 vysvetľuje nastavenia.

V dashboarde Beancount.io otvorte stránku Nastavenia účtovnej knihy. Jej tabuľka Možnosti Fava zobrazuje podmnožinu vrátenú backendom. Toto UI bolo overené v snímke zdrojového produktu, nie cez autentifikovanú produkčnú reláciu. Zobrazené pole neznamená, že hostovaný dashboard implementuje editor štandardnej Fava, importy alebo trasy URL.

Pozri Tiež​

• Konfigurácia možností — Základné smernice option Beancount.
• Funkcie UI — Pracovné postupy štandardnej Fava a hostovaná kompatibilita.