Opcions de Fava

Configureu el Fava estàndard amb directives datades custom "fava-option". Aquests paràmetres són separats de les opcions principals de Beancount.

Aquesta referència es va executar amb Beancount 3.2.3, beanquery 0.2.0 i Fava 1.30.16. La matriu descriu aquesta versió estàndard. Beancount.io té un panell i un backend separats; els seus paràmetres exposats no demostren que totes les funcions del Fava estàndard hi estiguin disponibles.

Sintaxi​

Els valors són cadenes entre cometes, incloent enters i booleans. Aquest exemple complet s'analitza tant en Beancount com en 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 és obligatòria. Fava processa les directives personalitzades carregades en ordre de data; un paràmetre escalar posterior reemplaça un d'anterior. Els paràmetres repetits collapse-pattern, import-dirs i insert-entry s'acumulen. Les regles d'inserció utilitzen les seves dates per triar una destinació, per tant aquestes dates són significatives.

Per reproduir els exemples localment, instal·leu uv, després creeu un entorn temporal:

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
bea --file main.beancount check
fava main.beancount

Creeu main.beancount a partir del bloc de configuració primer, o utilitzeu un llibre major existent. Les ordres de shell anteriors utilitzen rutes POSIX. bea check comprova la sintaxi i la comptabilitat de Beancount; Fava a més comprova els seus propis noms i valors d'opció. Inspeccioneu també l'informe d'Errors de Fava.

Els valors per defecte següents es van llegir de la classe de dades FavaOptions instal·lada i es van verificar amb l'analitzador d'opcions amb versió. «Sense establir» significa None; una col·lecció buida significa que no hi ha entrades configurades. La columna de tipus de valor descriu el contingut de la cadena entre cometes.

Utilitzeu "true" o "false" per als booleans. La comparació no distingeix majúscules: "TRUE" també activa una opció. Qualsevol cadena que no sigui una variant de majúscules de "true" es tracta com a falsa. El seu analitzador d'enters comprova la sintaxi d'enter, no un rang positiu; utilitzeu mides de disseny positives i recomptes no negatius.

Visualització i Localització​

language​

Estableix la traducció de la interfície, per exemple "en", "de" o "zh_CN". Quan no està establert, Fava negocia amb el navegador. El locale ha de tenir una traducció inclosa a Fava; un codi d'idioma sintàcticament vàlid per si sol no és suficient.

locale​

Estableix el format de nombres independentment de l'idioma de la interfície, per exemple "en_US" o "de_DE". Sense aquesta opció, Fava utilitza el seu patró de nombres no localitzat. L'opció principal option "render_commas" "TRUE" proporciona el valor alternatiu en. No hereta l'idioma del navegador.

Navegació i Disseny​

default-page​

Estableix la destinació dins del llibre major, com ara "balance_sheet/" o "journal/?time=year". Copieu la part després de l'identificador del llibre major d'una URL de Fava estàndard que funcioni. No afegiu / al davant: les rutes dels informes són relatives a aquest llibre major.

fiscal-year-end​

Estableix els límits dels filtres de temps fiscals. Per exemple, "03-31" finalitza un any fiscal el 31 de març. Admet filtres d'any fiscal i trimestre; no canvia les dates de les transaccions. Fava també accepta valors de mes superiors a 12 per etiquetar un any fiscal que finalitza el següent any natural.

indent​

Estableix la sagnia dels assentaments per a les entrades generades i el format de l'editor. Utilitzeu una cadena d'enter positiu, com ara "4".

currency-column​

Estableix la columna d'alineació de moneda en desar o alinear assentaments. També posiciona la guia vertical de l'editor. El valor per defecte és "61".

Visibilitat del Contingut​

show-closed-accounts​

Inclou comptes tancats als arbres de comptes dels informes. Els comptes amb saldos no nuls romanen visibles independentment d'aquest paràmetre.

show-accounts-with-zero-transactions​

Inclou comptes sense transaccions als arbres de comptes. No suprimeix un compte que té un saldo no nul.

show-accounts-with-zero-balance​

Inclou comptes el saldo de l'informe dels quals és zero. Desactiveu-lo amb "false" per a un arbre més curt.

collapse-pattern​

Coincideix amb noms de compte per plegar als arbres de comptes. Repetiu la directiva per a múltiples patrons. Per exemple, "^Assets:Investments" plega aquest compte i els seus descendents.

sidebar-show-queries​

Limita el nombre de consultes desades enllaçades a la barra lateral. "0" amaga aquests enllaços. Vegeu enllaços personalitzats i consultes.

show-metadata-indicators​

Mostra les petites insígnies de metadades als diaris. Establiu-lo a "false" per amagar les insígnies sense eliminar les metadades del llibre major.

Gestió de Fitxers​

default-file​

Tria el fitxer obert inicialment per l'editor i la destinació alternativa per a noves entrades. Una ruta relativa es resol des del fitxer que conté la directiva. Sense valor, se selecciona el fitxer que la conté. Sense aquesta opció, el fitxer principal del llibre major és la destinació alternativa. Un fitxer existent també ha d'estar inclòs al llibre major per ser una font editable.

insert-entry​

Col·loca una nova entrada abans d'una directiva personalitzada que coincideixi, al fitxer que conté aquesta directiva. El seu regex coincideix amb un nom de compte des de l'inici; mai cerca línies de fitxer en brut. Fava considera els assentaments de transacció de l'últim al primer. Per al primer compte amb una coincidència elegible, tria la regla més recent datada estrictament abans de la nova entrada. Si cap coincideix, afegeix al final del fitxer per defecte. La implementació de la inserció és l'autoritat per a aquestes regles.

Creeu aquests tres fitxers al mateix directori. main.beancount proporciona els comptes i inclou:

; 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 conté:

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

february.beancount conté:

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

Inicieu Fava amb main.beancount. Afegiu aquestes transaccions mitjançant el seu formulari de transaccions; són entrada per a l'operació d'inserció, no un fitxer addicional per incloure prèviament:

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

Les dues primeres entrades van abans de la regla de gener. La tercera va abans de la regla de febrer. La quarta prova Assets:Cash, no troba cap coincidència, i després utilitza la regla Expenses:Food al fitxer principal. La cinquena no té cap compte coincident i s'afegeix al final de main.beancount. Desar un lot actualitza els números de línia de les regles a mesura que s'insereixen les entrades.

auto-reload​

Recarrega la pàgina automàticament quan Fava detecta un canvi de font extern. Quan és fals, Fava ofereix una notificació de recàrrega. Els canvis fets a través de Fava mateix ja desencadenen una recàrrega.

use-external-editor​

Obre enllaços de font mitjançant l'esquema d'URL beancount://. Instal·leu un gestor a l'ordinador que executa el navegador i assegureu-vos que pot accedir als fitxers del llibre major. Això no és una connexió automàtica a fitxers en un servidor allotjat.

import-config​

Apunta a una configuració d'importador Python. Aquest és un paràmetre d'integració: creeu la configuració i instal·leu les seves dependències d'importador abans d'utilitzar l'informe d'Importació. Els tres paquets fixats anteriors no proporcionen una configuració d'importador bancari.

import-dirs​

Afegeix un directori per escanejar candidats d'importació. Repetiu la directiva per afegir directoris. Utilitzeu directoris reals i accessibles; establir l'opció no els crea.

Visualització Financera​

unrealized​

No és una opció estàndard de Fava 1.30.16. Fava informa Unknown option seguit del nom entre cometes inverses si l'afegiu. No l'utilitzeu per configurar comptes de guanys no realitzats estàndards.

La instantània de codi font de Beancount.io revisada el 2026-09-07 exposa un camp de cadena separat anomenat unrealized, amb valor per defecte "Unrealized", al seu analitzador d'opcions del backend i taula de Paràmetres del panell. Això verifica que el camp existeix allà. No estableix que canviar-lo creï Income:Unrealized o Expenses:Unrealized, ni que un desplegament particular executi aquesta instantània.

invert-income-liabilities-equity​

Inverteix els signes mostrats d'Ingressos, Passius i Patrimoni net a l'estat de resultats i al balanç de situació. Les Despeses conserven els seus signes. Les entrades de diari, els diaris de comptes i els assentaments emmagatzemats romanen sense canvis.

conversion-currencies​

Reemplaça les opcions de conversió del menú desplegable amb una llista separada per espais en una cadena:

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

Repetir aquesta opció reemplaça la llista anterior. Quan no està establert, Fava ofereix monedes operatives més els actius que reconeix com a monedes ISO 4217.

account-journal-include-children​

Inclou entrades de comptes fills al diari d'un compte per defecte. Establiu-lo a "false" per començar només amb aquest compte.

invert-gains-losses-colors​

Inverteix els colors utilitzats per a guanys i pèrdues no realitzats a les vistes de balanç a valor de mercat i balanç de comprovació. Canvia colors, no imports ni noms de comptes.

Monitoratge​

uptodate-indicator-grey-lookback-days​

Controla el període de retrocés del indicador gris de frescor. Activeu els indicadors de compte amb fava-uptodate-indication: TRUE a la directiva open del compte; vegeu l'exemple de metadades d'UI.

upcoming-events​

Controla el recompte de notificacions de la barra lateral per a esdeveniments propers dins del nombre especificat de dies. "0" desactiva el recompte.

Configuració Recomanada​

Aquesta configuració completa és un punt de partida per a l'entorn estàndard anterior. Canvia la configuració de visualització sense carregar complements ni requerir fitxers addicionals:

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"

Veure les Vostres Opcions Actuals​

Al Fava estàndard, obriu la seva pàgina Ajuda → Opcions per a la referència de la versió instal·lada i comproveu Errors després de canviar una directiva. L'ajuda oficial d'opcions 1.30.16 explica els paràmetres.

Al panell de Beancount.io, obriu la pàgina de Paràmetres d'un llibre major. La seva taula d'Opcions de Fava mostra el subconjunt retornat pel backend. Aquesta UI es va verificar a la instantània del codi font del producte, no mitjançant una sessió de producció autenticada. Un camp mostrat no implica que el panell allotjat implementi l'editor, les importacions o les rutes d'URL del Fava estàndard.

Vegeu També​

• Configuració d'Opcions — Les directives option principals de Beancount.
• Funcions d'UI — Fluxos de treball del Fava estàndard i compatibilitat allotjada.