Referencia možností Fava pre webové rozhranie Beancount

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

Táto referencia bola vykonaná s Beancount 3.2.3, beanquery 0.2.0 a Fava 1.30.16. Matica popisuje túto verziu štandardu. Beancount.io má samostatný dashboard a backend; jeho vystavené nastavenia nedokazujú, že každá funkcia štandardnej Fava je tam dostupná.

Syntax​

Hodnoty sú v úvodzovkách, vrátane celých čísel a booleovských hodnôt. Tento kompletný príklad je možné analyzovať 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 spracúva načítané vlastné direktívy v poradí podľa dátumu; neskoršie skalárne nastavenie nahradí skoršie. Opakované nastavenia collapse-pattern, import-dirs a insert-entry sa kumulujú. Pravidlá vkladania používajú ich dátumy na výber cieľa, takže tieto dátumy majú význam.

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

uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'fava==1.30.16'
uv tool install beancount-io
source .venv-fava-docs/bin/activate
bea --file main.beancount check
fava main.beancount

Najprv vytvorte main.beancount z konfiguračného bloku alebo použite existujúci ledger. Shell príkazy vyššie používajú POSIX cesty. bea check kontroluje syntaktiku Beancount a účtovníctvo; Fava navyše kontroluje svoje vlastné názvy a hodnoty možností. Skontrolujte aj Fava hlásenie Chýb.

Nasledujúce predvolené hodnoty boli načítané z inštalovanej FavaOptions dátovej triedy a overené voči verziovanému parseru možností. „Nenastavené“ znamená None; prázdna kolekcia znamená žiadne nakonfigurované položky. Stĺpec typu hodnoty popisuje obsah úvodzovkového reťazca.

Použite "true" alebo "false" pre boolean hodnoty. Porovnanie nerozlišuje veľkosť písmen: "TRUE" tiež povolí možnosť. Každý reťazec okrem variantu veľkosti písmen "true" sa považuje za false. Jeho parser celých čísel kontroluje syntax celých čísel, 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". Ak nie je nastavené, Fava vyjednáva s prehliadačom. Locale musí mať preklad dodaný 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 používa Fava svoj lokalizovaný vzor čísla. Core option "render_commas" "TRUE" poskytuje záložný en. Nezdedí jazyk prehliadača.

Navigácia a rozloženie​

default-page​

Nastavuje cieľ v rámci hlavnej knihy, napríklad "balance_sheet/" alebo "journal/?time=year". Skopírujte časť za identifikátorom hlavnej knihy zo fungujúcej URL adresy Fava. Nepredlžujte /: cesty k reportom sú relatívne k danej hlavnej knihe.

fiscal-year-end​

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

indent​

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

currency-column​

Nastavuje stĺpec zarovnania meny pri ukladaní alebo zarovnávaní zápisov. Tiež určuje pozíciu vertikálnej vodítka editora. Predvolená hodnota je "61".

Viditeľnosť obsahu​

show-closed-accounts​

Zahŕňa uzavreté účty v stromoch účtov správ. Úč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í v stromoch účtov. Nevylučuje účet, ktorý má nenulový zostatok.

show-accounts-with-zero-balance​

Zahŕňa účty, ktorých zostatok v reporte je nula. Vypnite to pomocou "false" pre kratší strom.

collapse-pattern​

Zodpovedá názvom účtov, ktoré sa majú zbalit v stromoch účtov. Opakujte tento direktív pre viacero vzorov. Napríklad "^Assets:Investments" zbali daný účet aj jeho potomkov.

sidebar-show-queries​

Obmedzuje počet uložených dotazov zobrazený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 na "false" pre skrytie odznakov bez odstránenia metadát z hlavnej knihy.

Správa súborov​

default-file​

Vyberá súbor, ktorý je spočiatku otvorený v editore a záložnú cieľovú destináciu pre nové záznamy. Relatívna cesta sa vyrieši vzhľadom na súbor obsahujúci direktívu. Ak nie je hodnota nastavená, vyberie sa obsahujúci súbor. Bez tejto voľby je záložný súbor hlavná kniha. Existujúci súbor musí byť tiež zahrnutý v hlavnej knihe, aby bol editačným zdrojom.

insert-entry​

Vkladá nový záznam pred zodpovedajúcim vlastným direktívom, v súbore obsahujúcom túto direktívu. Jeho regex zodpovedá názvu účtu od začiatku; nikdy neprehľadáva surové riadky súboru. Fava považuje záznamy transakcií od posledného po prvý. Pre prvý účet s oprávnenou zhode vyberie najnovšie pravidlo datované prísne pred novým záznamom. Ak žiadne pravidlo nezodpovedá, pripojí sa 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 obsahuje:

; 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 jeho formulár transakcií; sú to vstupy do operácie vkladania, nie dodatočný súbor na predchádzajúce zahrnutie:

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. Piati nemajú zodpovedajúci účet a pripojí sa do main.beancount. Uloženie batchu aktualizuje čísla riadkov pravidiel počas vkladania záznamov.

auto-reload​

Automaticky obnovuje stránku, keď Fava zistí zmenu z externého zdroja. Ak je nastavené na false, Fava ponúkne notifikáciu o obnovení. Zmeny vykonané samotným Fava už spúšťajú obnovenie.

use-external-editor​

Otvára zdrojové odkazy cez URL schému beancount://. Na počítači, ktorý spúšťa prehliadač, nainštalujte handler a zabezpečte, aby mal prístup k súborom účtovnej knihy. Toto nie je automatické prepojenie na súbory na hostovanom serveri.

import-config​

Ukazuje na konfiguráciu importéra v Pythone. Toto je nastavenie integrácie: vytvorte konfiguráciu a nainštalujte jej závislosti importéra pred použitím správy Import. Tri pripnuté balíky vyššie neposkytujú konfiguráciu bankového importéra.

import-dirs​

Pridáva adresár na prehľadávanie kandidátov na import. Direktívu opakujte pre pridanie viacerých adresárov. Používajte reálne prístupné adresáre; nastavenie tejto možnosti ich nevytvára.

Finančné zobrazenie​

unrealized​

Nie je to štandardná možnosť Fava 1.30.16. Fava nahlási Unknown option nasledované menom v spätných úvodzovkách, ak ju pridáte. Nepoužívajte ju na konfiguráciu štandardných účtov nerealizovaného zisku.

Zdrojová snímka Beancount.io, prehliadnutá dňa 2026-09-07, skutočne odhaľuje samostatné reťazcové pole s názvom unrealized s predvolenou hodnotou "Unrealized" vo svojom backendovom parseri možností a tabuľke nastavení na dashboarde. To potvrdzuje, že pole tam existuje. Nezaručuje však, ž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 príjmov, záväzkov a vlastného imania vo výkaze ziskov a strát a súvahe. Náklady si zachovávajú svoje znamienka. Účtovné zápisy, denníky účtov a uložené zápisy zostávajú nezmenené.

conversion-currencies​

Nahradí možnosti rozbaľovacieho zoznamu konverzie medzerou oddeleným zoznamom v jednom reťazci:

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

Opakované zadanie tejto možnosti nahradí predchádzajúci zoznam. Ak nie je nastavená, Fava ponúka prevádzkové meny plus komodity, ktoré rozpoznáva ako meny ISO 4217.

account-journal-include-children​

Vo výpise denníka účtu zahrňuje predvolene aj záznamy detských účtov. Nastavte to na "false", aby sa začalo len s týmto účtom.

invert-gains-losses-colors​

Otočí farby použité pre nerealizované zisky a straty v pohľadoch trhovej hodnoty súvahy a skúšobnej bilancie. Mení farby, nie sumy alebo názvy účtov.

Monitorovanie​

uptodate-indicator-grey-lookback-days​

Riadi dobu spätnej kontroly šedej indikácie čerstvosti. Povolenie indikátorov účtov vykonajte cez fava-uptodate-indication: TRUE v direktíve open účtu; pozrite si príklad metadát UI.

upcoming-events​

Riadi počet notifikácií na bočnom paneli pre nadchádzajúce udalosti v rámci zvoleného počtu dní. "0" deaktivuje počítanie.

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 zásuvných modulov alebo vyžadovania doplnkových 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"

Prezeranie vašich aktuálnych možností​

Vo štandardnej Fave otvorte jej stránku Pomoc → Možnosti pre referenciu inštalovanej verzie a skontrolujte chyby po zmene direktívy. Oficiálna pomoc pre možnosť 1.30.16 vysvetľuje nastavenia.

V dashboarde Beancount.io otvorte stránku Nastavenia knihy. Jej tabuľka Fava Options zobrazuje podmnožinu vrátenú backendom. Toto užívateľské rozhranie bolo overené na zdrojovej snímke produktu, nie cez autentifikovanú produkčnú reláciu. Zobrazované pole neznamená, že hostovaný dashboard implementuje editor štandardnej Favy, importy alebo URL cesty.

Pozri tiež​

• Konfigurácia možností — Základné option smernice Beancountu.
• Funkcie UI — Prednastavené pracovné toky Fava a hostovaná kompatibilita.