Fava-optiesreferentie voor de Beancount-webinterface

Configureer stock Fava met gedateerde custom "fava-option" richtlijnen. Deze instellingen zijn apart van Beancount core options.

Deze referentie werd uitgevoerd met Beancount 3.2.3, beanquery 0.2.0 en Fava 1.30.16. De matrix beschrijft die stock release. Beancount.io heeft een apart dashboard en backend; de blootgestelde instellingen bewijzen niet dat elke stock Fava functie daar beschikbaar is.

Syntax​

Waarden zijn gequoteerde strings, inclusief gehele getallen en booleans. Dit volledige voorbeeld wordt geparseerd in zowel Beancount als 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"

De datum is verplicht. Fava verwerkt de geladen aangepaste richtlijnen in datumvolgorde; een latere scalare instelling vervangt een eerdere. Herhaalde collapse-pattern, import-dirs en insert-entry instellingen stapelen op. Invoegregels gebruiken hun data om een bestemming te kiezen, dus die data zijn betekenisvol.

Om de voorbeelden lokaal te reproduceren, installeer uv, maak dan een wegwerpomgeving aan:

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

Maak eerst main.beancount aan vanuit het configuratieblok, of gebruik een bestaand grootboek. De shell-commando's hierboven gebruiken POSIX-paden. bea check controleert Beancount syntax en accounting; Fava controleert daarnaast zijn eigen optie-namen en waarden. Bekijk ook Fava's Foutenrapport.

De onderstaande standaardwaarden zijn gelezen van de geïnstalleerde FavaOptions dataklasse en gecontroleerd met de geversioneerde optiepaser. “Niet ingesteld” betekent None; een lege collectie betekent geen geconfigureerde invoeren. De waarde-type kolom beschrijft de inhoud van de gequoteerde string.

Gebruik "true" of "false" voor booleans. De vergelijking is niet hoofdlettergevoelig: "TRUE" schakelt ook een optie in. Elke string anders dan een case-variant van "true" wordt als false behandeld. De integer parser controleert de integer syntaxis, niet een positief bereik; gebruik positieve layout afmetingen en niet-negatieve aantallen.

Weergave & Lokalisatie​

language​

Stelt de interfacevertaling in, bijvoorbeeld "en", "de" of "zh_CN". Wanneer niet ingesteld, onderhandelt Fava met de browser. De locale moet een vertaling bevatten die door Fava wordt meegeleverd; een syntactisch geldige taalcode alleen is onvoldoende.

locale​

Stelt de nummeropmaak onafhankelijk van de interface taal in, bijvoorbeeld "en_US" of "de_DE". Zonder deze optie gebruikt Fava zijn niet-gelokaliseerde nummerpatroon. Core option "render_commas" "TRUE" levert de en fallback. Het erft niet de browsertaal.

Navigatie & Layout​

default-page​

Stelt de bestemming binnen het grootboek in, zoals "balance_sheet/" of "journal/?time=year". Kopieer het deel na de grootboeksleutel van een werkende stock Fava-URL. Voeg / niet toe: rapportpaden zijn relatief ten opzichte van dat grootboek.

fiscal-year-end​

Stelt grenzen in voor fiscaal tijdsfilter. Bijvoorbeeld, "03-31" beëindigt een fiscaal jaar op 31 maart. Het ondersteunt filters voor fiscaal jaar en kwartaal; het verandert de transactiedata niet. Fava accepteert ook maandwaarden boven 12 om een fiscaal jaar te labelen dat eindigt in het volgende kalenderjaar.

indent​

Stelt de inspringing van posten in voor gegenereerde transacties en editoropmaak. Gebruik een positieve gehele getal-string, zoals "4".

currency-column​

Stelt de valutalijnkolom in bij het opslaan of uitlijnen van posten. Positioneert ook de verticale leidraad van de editor. De standaard is "61".

Inhoud Zichtbaarheid​

show-closed-accounts​

Neemt gesloten rekeningen op in rapportrekeningsbomen. Rekeningen met een niet-nul saldo blijven zichtbaar, ongeacht deze instelling.

show-accounts-with-zero-transactions​

Neemt rekeningen zonder transacties op in rekeningbomen. Het verbergt geen rekening die een niet-nul saldo heeft.

show-accounts-with-zero-balance​

Neemt rekeningen op waarvan het rapport-saldo nul is. Schakel dit uit met "false" voor een kortere boom.

collapse-pattern​

Komt overeen met rekeningnamen om samen te vouwen in rekeningbomen. Herhaal de directive voor meerdere patronen. Bijvoorbeeld, "^Assets:Investments" vouwt die rekening en de afstammelingen ervan samen.

sidebar-show-queries​

Beperkt het aantal opgeslagen zoekopdrachten gelinkt in de zijbalk. "0" verbergt die links. Zie aangepaste links en zoekopdrachten.

show-metadata-indicators​

Toont de kleine metadata-badges in dagboeken. Stel het in op "false" om de badges te verbergen zonder metadata uit het grootboek te verwijderen.

Bestandsbeheer​

default-file​

Kiest het bestand dat initieel door de editor wordt geopend en de fallback-bestemming voor nieuwe transacties. Een relatief pad wordt opgelost vanaf het bestand met de directive. Zonder waarde wordt het omvattende bestand geselecteerd. Zonder deze optie is het hoofd-grootboekbestand de fallback. Een bestaand bestand moet ook in het grootboek zijn opgenomen om een bewerkbare bron te zijn.

insert-entry​

Plaatst een nieuwe invoer voor een overeenkomende aangepaste instructie, in het bestand dat die instructie bevat. De regex komt overeen met een rekeningnaam vanaf het begin; het zoekt nooit in ruwe bestandsregels. Fava beschouwt transactieposten van laatst naar eerst. Voor de eerste rekening met een geschikte overeenkomst kiest het de nieuwste regel gedateerd strikt vóór de nieuwe invoer. Als er geen overeenkomt, wordt het toegevoegd aan het standaardbestand. De implementatie van invoeging is gezaghebbend voor deze regels.

Maak deze drie bestanden aan in dezelfde map. main.beancount levert de rekeningen en bevat:

; 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 bevat:

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

february.beancount bevat:

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

Start Fava met main.beancount. Voeg deze transacties toe via het transactievormulier; ze zijn invoer voor de invoeging operatie, niet een extra bestand om vooraf in te sluiten:

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

De eerste twee invoeren gaan voor de januari-regel. De derde gaat voor de februari-regel. De vierde probeert Assets:Cash, vindt geen overeenkomst, gebruikt dan de Expenses:Food-regel in het hoofd bestand. De vijfde heeft geen overeenkomende rekening en voegt toe aan main.beancount. Het opslaan van een batch werkt de regels met regel nummers bij naarmate invoeren worden toegevoegd.

auto-reload​

Laadt de pagina automatisch opnieuw wanneer Fava een verandering van een externe bron detecteert. Bij false toont Fava een herlaadmelding. Wijzigingen via Fava zelf veroorzaken al een herlading.

use-external-editor​

Opent bronlinks via het beancount:// URL-schema. Installeer een handler op de computer met de browser en zorg dat deze toegang heeft tot de grootboekbestanden. Dit is geen automatische verbinding met bestanden op een gehoste server.

import-config​

Wijst naar een Python-importerconfiguratie. Dit is een integratie-instelling: maak de configuratie en installeer de importer afhankelijkheden voordat u het Importrapport gebruikt. De drie vastgezette pakketten hierboven bieden geen bankimporterconfiguratie.

import-dirs​

Voegt een map toe om te scannen op importkandidaten. Herhaal de instructie om meer mappen toe te voegen. Gebruik echte toegankelijke mappen; het instellen van deze optie maakt ze niet aan.

Financiële Weergave​

unrealized​

Geen standaardoptie van Fava 1.30.16. Fava meldt Unknown option gevolgd door de naam tussen backticks als u het toevoegt. Gebruik het niet om standaard niet-gerealiseerde-winst-rekeningen te configureren.

De Beancount.io broncode momentopname die op 2026-09-07 is beoordeeld, bevat een afzonderlijk tekenreeksveld genaamd unrealized, met standaardwaarde "Unrealized", in de backend-optieparser en het dashboard-instellingentabel. Dit bevestigt dat het veld daar bestaat. Het bewijst niet dat het wijzigen ervan Income:Unrealized of Expenses:Unrealized creëert, of dat een specifieke implementatie deze momentopname uitvoert.

invert-income-liabilities-equity​

Draait de weergegeven tekens van Inkomsten, Schulden en Eigen Vermogen om in de winst- en verliesrekening en de balans. Uitgaven behouden hun tekens. Journaalposten, rekeningsjournaals en opgeslagen boekingen blijven ongewijzigd.

conversion-currencies​

Vervangt de keuzelijst voor conversie door een met spaties gescheiden lijst in één tekenreeks:

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

Het herhalen van deze optie vervangt de vorige lijst. Wanneer niet ingesteld, biedt Fava bedrijfsmuntsoorten plus goederen die het herkent als ISO 4217-valuta's.

account-journal-include-children​

Neemt standaard boekingen van subrekeningen op in het journaal van een rekening. Stel deze in op "false" om te beginnen met alleen die rekening.

invert-gains-losses-colors​

Keert de kleuren om die worden gebruikt voor niet-gerealiseerde winst en verlies in marktwaarde-balans- en proefbalansweergaven. Het verandert kleuren, niet bedragen of rekeningenamen.

Monitoring​

uptodate-indicator-grey-lookback-days​

Beheert de blikperiode van de grijze versheidsindicator. Schakel rekeningindicatoren in met fava-uptodate-indication: TRUE op de open-richtlijn van de rekening; zie het UI metadata voorbeeld.

upcoming-events​

Beheert het aantal meldingen in de zijbalk voor komende gebeurtenissen binnen het opgegeven aantal dagen. "0" schakelt het aantal uit.

Aanbevolen configuratie​

Deze volledige configuratie is een startpunt voor de bovengenoemde standaardomgeving. Het verandert weergave-instellingen zonder plugins te laden of extra bestanden te vereisen:

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"

Uw huidige opties bekijken​

Open in standaard Fava de Help → Opties-pagina voor de referentie van de geïnstalleerde uitgave en controleer op Fouten na het wijzigen van een richtlijn. De officiële 1.30.16 optie-hulp legt de instellingen uit.

Open in het Beancount.io dashboard de Instellingen-pagina van een grootboek. De Fava Opties-tabel toont de subset die door de backend wordt teruggegeven. Deze UI is geverifieerd in de product-broncode momentopname, niet via een geauthenticeerde productiesessie. Een weergegeven veld impliceert niet dat het gehoste dashboard de standaard Fava-editor, imports of URL-routes implementeert.

Zie ook​

• Opties Configuratie — Beancount's kern option opdrachten.
• UI Functies — Standaard Fava workflows en gehoste compatibiliteit.