Riferimento alle opzioni Fava per l'interfaccia web di

Configura Fava standard con direttive datate custom "fava-option". Queste impostazioni sono separate dalle opzioni core di Beancount.

Questo riferimento è stato eseguito con Beancount 3.2.3, beanquery 0.2.0 e Fava 1.30.16. La matrice descrive quella versione standard. Beancount.io ha una dashboard e un backend separati; le sue impostazioni esposte non dimostrano che ogni funzionalità standard di Fava sia disponibile lì.

Sintassi​

I valori sono stringhe quotate, inclusi interi e booleani. Questo esempio completo viene analizzato sia in Beancount che in 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"

La data è obbligatoria. Fava elabora le direttive personalizzate caricate in ordine cronologico; un'impostazione scalare successiva sostituisce una precedente. Le impostazioni ripetute collapse-pattern, import-dirs e insert-entry si accumulano. Le regole di inserimento usano le loro date per scegliere una destinazione, quindi quelle date sono significative.

Per riprodurre gli esempi localmente, installa uv, poi crea un ambiente usa e getta:

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

Crea prima main.beancount dal blocco di configurazione, o usa un libro mastro esistente. I comandi shell sopra usano percorsi POSIX. bea check controlla la sintassi e la contabilità di Beancount; Fava controlla inoltre i propri nomi e valori delle opzioni. Ispeziona anche il rapporto Errori di Fava.

I valori predefiniti sottostanti sono stati letti dalla dataclass FavaOptions installata e verificati contro il parser versionato delle opzioni. “Non impostato” significa None; una collezione vuota significa nessuna voce configurata. La colonna tipo-valore descrive il contenuto della stringa quotata.

Usa "true" o "false" per i booleani. Il confronto non fa distinzione tra maiuscole e minuscole: "TRUE" abilita anche un'opzione. Qualsiasi stringa diversa da una variante di maiuscole/minuscole di "true" è trattata come falsa. Il suo parser intero verifica la sintassi intera, non un intervallo positivo; utilizza dimensioni layout positive e conteggi non negativi.

Visualizzazione e Localizzazione​

language​

Imposta la traduzione dell'interfaccia, ad esempio "en", "de" o "zh_CN". Quando non impostato, Fava negozia con il browser. Il locale deve avere una traduzione fornita da Fava; un codice lingua sintatticamente valido da solo non è sufficiente.

locale​

Imposta la formattazione dei numeri indipendentemente dalla lingua dell'interfaccia, ad esempio "en_US" o "de_DE". Senza questa opzione, Fava usa il suo pattern numerico non localizzato. Core option "render_commas" "TRUE" fornisce il fallback en. Non eredita la lingua del browser.

Navigazione e Layout​

default-page​

Imposta la destinazione all'interno del libro mastro, ad esempio "balance_sheet/" o "journal/?time=year". Copia la parte dopo lo slug del libro mastro da un URL Fava funzionante. Non anteporre /: i percorsi dei report sono relativi a quel libro mastro.

fiscal-year-end​

Imposta i confini del filtro temporale fiscale. Ad esempio, "03-31" termina un anno fiscale il 31 marzo. Supporta i filtri per anno fiscale e trimestre; non cambia le date delle transazioni. Fava accetta anche valori di mese superiori a 12 per indicare un anno fiscale che termina nell'anno solare seguente.

indent​

Imposta l'indentazione delle registrazioni per voci generate e la formattazione dell'editor. Usa una stringa di intero positivo, come "4".

currency-column​

Imposta la colonna di allineamento della valuta durante il salvataggio o l'allineamento delle registrazioni. Posiziona anche la guida verticale dell'editor. Il valore predefinito è "61".

Visibilità del Contenuto​

show-closed-accounts​

Include conti chiusi negli alberi dei conti nei report. I conti con saldi diversi da zero restano visibili indipendentemente da questa impostazione.

show-accounts-with-zero-transactions​

Include conti senza transazioni negli alberi dei conti. Non sopprime un conto che ha un saldo diverso da zero.

show-accounts-with-zero-balance​

Include conti il cui saldo nel report è pari a zero. Disattivalo con "false" per un albero più corto.

collapse-pattern​

Corrisponde ai nomi dei conti da chiudere negli alberi dei conti. Ripeti la direttiva per più pattern. Ad esempio, "^Assets:Investments" comprime quel conto e i suoi discendenti.

sidebar-show-queries​

Limita il numero di query salvate collegate nella barra laterale. "0" nasconde quei collegamenti. Vedi collegamenti e query personalizzate.

show-metadata-indicators​

Mostra i piccoli badge dei metadata nei registri. Impostalo su "false" per nascondere i badge senza rimuovere i metadata dal libro mastro.

Gestione dei File​

default-file​

Sceglie il file aperto inizialmente dall'editor e la destinazione di fallback per nuove voci. Un percorso relativo è risolto dal file contenente la direttiva. Senza valore, viene selezionato il file contenente la direttiva. Senza questa opzione, il file principale del libro mastro è il fallback. Un file esistente deve essere incluso anche nel libro mastro per essere una fonte modificabile.

insert-entry​

Posiziona una nuova voce prima di una direttiva personalizzata corrispondente, nel file che contiene quella direttiva. La sua regex corrisponde a un nome di conto dall'inizio; non ricerca mai nelle righe grezze del file. Fava considera le registrazioni delle transazioni dall'ultima alla prima. Per il primo conto con una corrispondenza idonea, sceglie la regola più recente datata strettamente prima della nuova voce. Se nessuna corrisponde, la aggiunge al file predefinito. L'implementazione dell'inserimento è l'autorità per queste regole.

Crea questi tre file nella stessa directory. main.beancount fornisce i conti e include:

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

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

february.beancount contiene:

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

Avvia Fava con main.beancount. Aggiungi queste transazioni tramite il suo modulo di transazione; sono input per l'operazione di inserimento, non un file extra da includere prima:

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

Le prime due voci vanno prima della regola di gennaio. La terza va prima della regola di febbraio. La quarta prova Assets:Cash, non trova corrispondenze, quindi usa la regola Expenses:Food nel file principale. La quinta non ha il conto corrispondente e si aggiunge a main.beancount. Salvare un lotto aggiorna i numeri di riga delle regole man mano che le voci vengono inserite.

auto-reload​

Ricarica automaticamente la pagina quando Fava rileva una modifica esterna alla fonte. Se falso, Fava offre una notifica di ricarica. Le modifiche effettuate tramite Fava stesso già attivano una ricarica.

use-external-editor​

Apre i link di origine tramite lo schema URL beancount://. Installa un gestore sul computer che esegue il browser e assicurati che possa accedere ai file del registro. Questa non è una connessione automatica ai file su un server ospitato.

import-config​

Indica una configurazione importatore Python. Questa è un'impostazione di integrazione: crea la configurazione e installa le sue dipendenze prima di utilizzare il rapporto Import. I tre pacchetti fissati sopra non forniscono una configurazione importatore bancaria.

import-dirs​

Aggiunge una directory da scansionare per candidati all'importazione. Ripeti la direttiva per aggiungere directory. Usa directory reali e accessibili; impostare l'opzione non le crea.

Visualizzazione Finanziaria​

unrealized​

Opzione non standard di Fava 1.30.16. Fava riporta Unknown option seguito dal nome tra backtick se la aggiungi. Non usarla per configurare i conti di guadagno non realizzato standard.

Lo snapshot della sorgente Beancount.io esaminato il 2026-09-07 espone un campo stringa separato chiamato unrealized, con default "Unrealized", nel suo parser di opzioni backend e nella tabella delle Impostazioni della dashboard. Questo verifica che il campo esista lì. Non stabilisce che modificarlo crei Income:Unrealized o Expenses:Unrealized, né che una particolare implementazione esegua questo snapshot.

invert-income-liabilities-equity​

Inverte i segni visualizzati di Redditi, Passività e Patrimonio netto nel conto economico e nello stato patrimoniale. Le spese mantengono i loro segni. Le scritture contabili, i registri di conto e le registrazioni memorizzate rimangono invariati.

conversion-currencies​

Sostituisce le scelte del menu a discesa per la conversione con un elenco separato da spazi in un'unica stringa:

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

Ripetere questa opzione sostituisce l'elenco precedente. Quando non impostata, Fava offre valute operative più le commodity riconosciute come valute ISO 4217.

account-journal-include-children​

Include per impostazione predefinita le registrazioni dei conti figli nel registro di un conto. Impostalo su "false" per partire solo da quel conto.

invert-gains-losses-colors​

Invertisce i colori usati per utili e perdite non realizzati nelle viste di stato patrimoniale al valore di mercato e nel bilancio di verifica. Cambia i colori, non importi o nomi dei conti.

Monitoraggio​

uptodate-indicator-grey-lookback-days​

Controlla il periodo di lookback dell'indicatore di freschezza grigio. Abilita gli indicatori di conto con fava-uptodate-indication: TRUE sulla direttiva open del conto; vedi l'esempio di metadata UI.

upcoming-events​

Controlla il conteggio delle notifiche nella barra laterale per eventi imminenti entro il numero specificato di giorni. "0" disabilita il conteggio.

Configurazione Consigliata​

Questa configurazione completa è un punto di partenza per l'ambiente standard sopra. Modifica le impostazioni di visualizzazione senza caricare plugin o richiedere file aggiuntivi:

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"

Visualizzare le Opzioni Correnti​

In Fava stock, apri la pagina Aiuto → Opzioni per la documentazione della release installata e controlla Errori dopo aver modificato una direttiva. L'aiuto ufficiale per l'opzione 1.30.16 spiega le impostazioni.

Nel dashboard Beancount.io, apri la pagina Impostazioni di un libro mastro. La sua tabella Opzioni Fava mostra il sottoinsieme restituito dal backend. Questa UI è stata verificata nello snapshot sorgente del prodotto, non tramite una sessione di produzione autenticata. Un campo visualizzato non implica che la dashboard ospitata implementi l'editor di Fava stock, gli import o le rotte URL.

Vedi anche​

• Configurazione Opzioni — Le direttive core option di Beancount.
• Funzionalità UI — Workflow standard di Fava e compatibilità ospitata.