Opciones de Fava para la interfaz web de Beancount

Configura Fava estándar con directivas fechadas custom "fava-option". Estos ajustes son independientes de las opciones principales de Beancount.

Esta referencia fue ejecutada con Beancount 3.2.3, beanquery 0.2.0 y Fava 1.30.16. La matriz describe esa versión estándar. Beancount.io tiene un panel y backend separados; sus opciones expuestas no demuestran que toda funcionalidad de Fava estándar esté disponible allí.

Sintaxis​

Los valores son cadenas entre comillas, incluidos enteros y booleanos. Este ejemplo completo se analiza correctamente tanto en Beancount como 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 fecha es obligatoria. Fava procesa las directivas personalizadas cargadas en orden de fecha; un ajuste escalar posterior reemplaza a uno anterior. Las opciones repetidas collapse-pattern, import-dirs e insert-entry se acumulan. Las reglas de inserción usan sus fechas para elegir un destino, por lo que esas fechas son significativas.

Para reproducir los ejemplos localmente, instala uv y luego crea un entorno desechable:

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 bloque de configuración primero, o usa un libro existente. Los comandos de shell anteriores usan rutas POSIX. bea check verifica la sintaxis y contabilidad de Beancount; Fava además verifica sus propios nombres y valores de opciones. Revisa también el informe de Errores de Fava.

Los valores predeterminados a continuación fueron leídos de la clase de datos FavaOptions instalada y verificados contra el analizador de opciones versionado. “Sin definir” significa None; una colección vacía significa que no hay entradas configuradas. La columna de tipo de valor describe el contenido de la cadena entre comillas.

Usa "true" o "false" para booleanos. La comparación no distingue mayúsculas: "TRUE" también habilita una opción. Cualquier cadena que no sea una variante de mayúsculas de "true" se trata como falsa. Su analizador de enteros verifica la sintaxis del entero, no un rango positivo; usa tamaños de diseño positivos y conteos no negativos.

Visualización y Localización​

language​

Establece la traducción de la interfaz, por ejemplo "en", "de" o "zh_CN". Cuando no está definida, Fava negocia con el navegador. El locale debe tener una traducción incluida en Fava; un código de idioma sintácticamente válido por sí solo no es suficiente.

locale​

Establece el formato de números independientemente del idioma de la interfaz, por ejemplo "en_US" o "de_DE". Sin esta opción, Fava usa su patrón de números sin localizar. La opción principal option "render_commas" "TRUE" proporciona el respaldo en. No hereda el idioma del navegador.

Navegación y Diseño​

default-page​

Establece el destino dentro del libro, como "balance_sheet/" o "journal/?time=year". Copia la parte después del slug del libro desde una URL de Fava estándar en funcionamiento. No antepongas /: las rutas de informe son relativas a ese libro.

fiscal-year-end​

Establece los límites del filtro de tiempo fiscal. Por ejemplo, "03-31" termina un año fiscal el 31 de marzo. Admite filtros de año y trimestre fiscal; no cambia las fechas de las transacciones. Fava también acepta valores de mes superiores a 12 para etiquetar un año fiscal que termina en el siguiente año calendario.

indent​

Establece la sangría de asientos para entradas generadas y formato del editor. Usa una cadena de entero positivo, como "4".

currency-column​

Establece la columna de alineación de moneda al guardar o alinear asientos. También posiciona la guía vertical del editor. El valor predeterminado es "61".

Visibilidad del Contenido​

show-closed-accounts​

Incluye cuentas cerradas en los árboles de cuentas de los informes. Las cuentas con saldos no nulos permanecen visibles independientemente de este ajuste.

show-accounts-with-zero-transactions​

Incluye cuentas sin transacciones en los árboles de cuentas. No suprime una cuenta que tiene un saldo no nulo.

show-accounts-with-zero-balance​

Incluye cuentas cuyo saldo de informe es cero. Desactívalo con "false" para un árbol más corto.

collapse-pattern​

Coincide con nombres de cuentas para plegar en los árboles de cuentas. Repite la directiva para múltiples patrones. Por ejemplo, "^Assets:Investments" pliega esa cuenta y sus descendientes.

sidebar-show-queries​

Limita el número de consultas guardadas enlazadas en la barra lateral. "0" oculta esos enlaces. Consulta enlaces y consultas personalizados.

show-metadata-indicators​

Muestra las pequeñas insignias de metadatos en los diarios. Establécelo en "false" para ocultar las insignias sin eliminar metadatos del libro.

Gestión de Archivos​

default-file​

Elige el archivo abierto inicialmente por el editor y el destino de respaldo para nuevas entradas. Una ruta relativa se resuelve desde el archivo que contiene la directiva. Sin valor, se selecciona el archivo contenedor. Sin esta opción, el archivo principal del libro es el respaldo. Un archivo existente también debe estar incluido en el libro para ser una fuente editable.

insert-entry​

Coloca una nueva entrada antes de una directiva personalizada coincidente, en el archivo que contiene esa directiva. Su expresión regular coincide con un nombre de cuenta desde el inicio; nunca busca líneas de archivo sin procesar. Fava considera los asientos de transacción de último a primero. Para la primera cuenta con una coincidencia elegible, elige la regla más reciente fechada estrictamente antes de la nueva entrada. Si ninguna coincide, la agrega al archivo predeterminado. La implementación de inserción es la autoridad para estas reglas.

Crea estos tres archivos en el mismo directorio. main.beancount proporciona las cuentas e incluye:

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

Inicia Fava con main.beancount. Agrega estas transacciones a través de su formulario de transacciones; son entrada para la operación de inserción, no un archivo adicional para incluir de antemano:

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

Las dos primeras entradas van antes de la regla de enero. La tercera va antes de la regla de febrero. La cuarta intenta Assets:Cash, no encuentra coincidencia y luego usa la regla Expenses:Food en el archivo principal. La quinta no tiene cuenta coincidente y se agrega a main.beancount. Guardar un lote actualiza los números de línea de las reglas a medida que se insertan las entradas.

auto-reload​

Recarga la página automáticamente cuando Fava detecta un cambio en una fuente externa. Cuando es falso, Fava ofrece una notificación de recarga. Los cambios realizados a través de Fava ya activan una recarga.

use-external-editor​

Abre enlaces de origen a través del esquema de URL beancount://. Instala un manejador en la computadora que ejecuta el navegador y asegúrate de que pueda acceder a los archivos del libro. Esto no es una conexión automática a archivos en un servidor alojado.

import-config​

Apunta a una configuración de importador de Python. Este es un ajuste de integración: crea la configuración e instala las dependencias de su importador antes de usar el informe de Importación. Los tres paquetes fijados anteriores no proporcionan una configuración de importador bancario.

import-dirs​

Agrega un directorio para escanear candidatos de importación. Repite la directiva para agregar directorios. Usa directorios reales y accesibles; establecer la opción no los crea.

Visualización Financiera​

unrealized​

No es una opción estándar de Fava 1.30.16. Fava informa Unknown option seguido del nombre entre comillas invertidas si lo agregas. No lo uses para configurar cuentas de ganancias no realizadas estándar.

La instantánea de fuente de Beancount.io revisada el 2026-09-07 sí expone un campo de cadena separado llamado unrealized, con valor predeterminado "Unrealized", en el analizador de opciones de su backend y la tabla de Ajustes del panel. Eso verifica que el campo existe allí. No establece que cambiarlo cree Income:Unrealized o Expenses:Unrealized, ni que un despliegue particular ejecute esta instantánea.

invert-income-liabilities-equity​

Invierte los signos mostrados de Ingresos, Pasivos y Patrimonio en el estado de resultados y el balance general. Los gastos mantienen sus signos. Las entradas de diario, diarios de cuenta y asientos almacenados permanecen sin cambios.

conversion-currencies​

Reemplaza las opciones del menú desplegable de conversión con una lista separada por espacios en una sola cadena:

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

Repetir esta opción reemplaza la lista anterior. Cuando no está definida, Fava ofrece monedas operativas más los bienes que reconoce como monedas ISO 4217.

account-journal-include-children​

Incluye entradas de cuentas hijas en el diario de una cuenta por defecto. Establécelo en "false" para comenzar solo con esa cuenta.

invert-gains-losses-colors​

Invierte los colores utilizados para ganancias y pérdidas no realizadas en las vistas de balance general a valor de mercado y balance de comprobación. Cambia colores, no montos ni nombres de cuentas.

Monitoreo​

uptodate-indicator-grey-lookback-days​

Controla el período de retroceso del indicador gris de frescura. Habilita los indicadores de cuenta con fava-uptodate-indication: TRUE en la directiva open de la cuenta; consulta el ejemplo de metadatos de interfaz.

upcoming-events​

Controla el conteo de notificaciones en la barra lateral para eventos próximos dentro del número especificado de días. "0" desactiva el conteo.

Configuración Recomendada​

Esta configuración completa es un punto de partida para el entorno estándar anterior. Cambia los ajustes de visualización sin cargar complementos ni requerir archivos adicionales:

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"

Ver Tus Opciones Actuales​

En Fava estándar, abre su página Ayuda → Opciones para la referencia de la versión instalada y revisa Errores después de cambiar una directiva. La ayuda oficial de opciones 1.30.16 explica los ajustes.

En el panel de Beancount.io, abre la página de Ajustes de un libro. Su tabla de Opciones de Fava muestra el subconjunto devuelto por el backend. Esta interfaz fue verificada en la instantánea de fuente del producto, no mediante una sesión de producción autenticada. Un campo mostrado no implica que el panel alojado implemente el editor, importaciones o rutas URL de Fava estándar.

Véase También​

• Configuración de Opciones — Directivas option principales de Beancount.
• Características de Interfaz — Flujos de trabajo de Fava estándar y compatibilidad alojada.