Opcions de Fava per a la interfície web de Beancount

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

Aquesta referència s'ha executat 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 tauler i un backend separats; els seus paràmetres exposats no proven que totes les funcionalitats de Fava estàndard hi estiguin disponibles.

Sintaxi​

Els valors són cadenes entre cometes, incloent enters i booleans. Aquest exemple complet s'analitza tant a Beancount com a 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·la uv, després crea un entorn temporal:

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 main.beancount a partir del bloc de configuració primer, o utilitza un llibre existent. Les ordres de shell anteriors utilitzen rutes POSIX. bea check comprova la sintaxi i la comptabilitat de Beancount; Fava addicionalment comprova els noms i valors de les seves pròpies opcions. Inspecciona també l'informe d'Errors de Fava.

Els valors per defecte següents s'han llegit de la classe de dades FavaOptions instal·lada i s'han comprovat amb el parser d'opcions versionat. “No definit” significa None; una col·lecció buida significa cap entrada configurada. La columna tipus de valor descriu el contingut de la cadena entre cometes.

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

Visualització i Localització​

language​

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

locale​

Defineix 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 per defecte en. No hereta l'idioma del navegador.

Navegació i Disseny​

default-page​

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

fiscal-year-end​

Defineix els límits del filtre temporal fiscal. 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 l'any natural següent.

indent​

Defineix la indentació dels apunts per a les entrades generades i el format de l'editor. Utilitza una cadena d'enter positiu, com ara "4".

currency-column​

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

Visibilitat del Contingut​

show-closed-accounts​

Inclou els 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 els comptes sense transaccions als arbres de comptes. No suprimeix un compte que té un saldo no nul.

show-accounts-with-zero-balance​

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

collapse-pattern​

Coincideix amb noms de comptes per col·lapsar en els arbres de comptes. Repeteix la directiva per a múltiples patrons. Per exemple, "^Assets:Investments" col·lapsa 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 i consultes personalitzats.

show-metadata-indicators​

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

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 és la destinació alternativa. Un fitxer existent també ha de ser inclòs al llibre per ser una font editable.

insert-entry​

Col·loca una nova entrada abans d'una directiva personalitzada coincident, al fitxer que conté aquesta directiva. La seva regex coincideix amb un nom de compte des del principi; mai cerca línies de fitxer en brut. Fava considera els apunts de la 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 fitxer per defecte. La implementació d'inserció és l'autoritat per a aquestes regles.

Crea 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$"

Inicia Fava amb main.beancount. Afegeix 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, després utilitza la regla Expenses:Food al fitxer principal. La cinquena no té cap compte coincident i s'afegeix a main.beancount. Desar un lot actualitza els números de línia de les regles a mesura que s'insereixen entrades.

auto-reload​

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

use-external-editor​

Obre els enllaços de font mitjançant l'esquema d'URL beancount://. Instal·la un gestor a l'ordinador que executa el navegador i assegura't que pot accedir als fitxers del llibre. 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ó: crea la configuració i instal·la les dependències del seu importador abans d'utilitzar l'informe d'Importació. Els tres paquets fixats anteriorment no proporcionen una configuració d'importador bancari.

import-dirs​

Afegeix un directori per escanejar candidats d'importació. Repeteix la directiva per afegir directoris. Utilitza directoris reals accessibles; definir 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 invertides si l'afegeixes. No l'utilitzis per configurar comptes de guanys no realitzats estàndard.

La instantània de la font de Beancount.io revisada el 2026-09-07 sí que exposa un camp de cadena separat anomenat unrealized, amb valor per defecte "Unrealized", al seu parser d'opcions del backend i a la taula de Paràmetres del tauler. Això verifica que el camp existeix allà. No estableix que canviar-lo creï Income:Unrealized o Expenses:Unrealized, ni que un desplegament concret 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 del diari, els diaris de comptes i els apunts emmagatzemats romanen sense canvis.

conversion-currencies​

Substitueix les opcions del menú desplegable de conversió amb una llista separada per espais en una sola cadena:

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

Repetir aquesta opció substitueix la llista anterior. Quan no està definit, Fava ofereix les monedes operatives més les mercaderies que reconeix com a monedes ISO 4217.

account-journal-include-children​

Inclou les entrades de comptes fills al diari d'un compte per defecte. Defineix-ho 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 de balanç de comprovació. Canvia colors, no imports ni noms de comptes.

Monitoratge​

uptodate-indicator-grey-lookback-days​

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

upcoming-events​

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

Configuració Recomanada​

Aquesta configuració completa és un punt de partida per a l'entorn estàndard anterior. Canvia els paràmetres 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"

Visualització de les Teves Opcions Actuals​

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

Al tauler de Beancount.io, obre la pàgina de Paràmetres d'un llibre. La seva taula d'Opcions de Fava mostra el subconjunt retornat pel backend. Aquesta interfície s'ha verificat a la instantània de la font del producte, no mitjançant una sessió de producció autenticada. Un camp mostrat no implica que el tauler allotjat implementi l'editor, les importacions o les rutes URL de Fava estàndard.

Vegeu També​

• Configuració d'Opcions — Les directives option principals de Beancount.
• Funcionalitats d'Interfície — Fluxos de treball de Fava estàndard i compatibilitat allotjada.