Opciones de Fava

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

Esta referencia se ejecutó 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 un backend separados; sus ajustes expuestos no demuestran que todas las funciones de Fava estándar estén disponibles allí.

Sintaxis​

Los valores son cadenas entre comillas, incluidos enteros y booleanos. Este ejemplo completo se analiza 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. Los ajustes repetidos de 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 'beancount==3.2.3' 'beanquery==0.2.0' 'fava==1.30.16'
source .venv-fava-docs/bin/activate
bean-check main.beancount
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. bean-check verifica la sintaxis y la 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 se leyeron de la dataclass FavaOptions instalada y se verificaron con 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 entre mayúsculas y minúsculas: "TRUE" también habilita una opción. Cualquier otra 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 recuentos 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. La configuración regional 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 no localizado. 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 identificador del libro de una URL de Fava estándar en funcionamiento. No antepongas /: las rutas de informes son relativas a ese libro.

fiscal-year-end​

Establece los límites del filtro de tiempo fiscal. Por ejemplo, "03-31" finaliza un año fiscal el 31 de marzo. Admite filtros de año fiscal y trimestre; 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 los asientos para las entradas generadas y el formato del editor. Usa una cadena de entero positiva, 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 predeterminado es "61".

Visibilidad del Contenido​

show-closed-accounts​

Incluye cuentas cerradas en los árboles de cuentas de los informes. Las cuentas con saldos distintos de cero permanecen visibles independientemente de esta configuración.

show-accounts-with-zero-transactions​

Incluye cuentas sin transacciones en los árboles de cuentas. No suprime una cuenta que tenga un saldo distinto de cero.

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 contraer en los árboles de cuentas. Repite la directiva para múltiples patrones. Por ejemplo, "^Assets:Investments" contrae 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. Configúralo en "false" para ocultar las insignias sin eliminar los 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 en bruto. Fava considera los asientos de la 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, agrega al final del 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 de Expenses:Food en el archivo principal. La quinta no tiene cuenta coincidente y se agrega al final de 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 de fuente externa. Cuando es falso, Fava ofrece una notificación de recarga. Los cambios realizados a través del propio Fava ya activan una recarga.

use-external-editor​

Abre enlaces de fuente 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 en busca de candidatos de importación. Repite la directiva para agregar directorios. Usa directorios reales y accesibles; configurar 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 el predeterminado "Unrealized", en su analizador de opciones del backend y en 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 una implementación 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 conservan sus signos. Las entradas de diario, los diarios de cuentas y los asientos almacenados no cambian.

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 además de los commodities que reconoce como monedas ISO 4217.

account-journal-include-children​

Incluye entradas de cuentas hijas en el diario de una cuenta de forma predeterminada. Configúralo en "false" para comenzar solo con esa cuenta.

invert-gains-losses-colors​

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

Monitoreo​

uptodate-indicator-grey-lookback-days​

Controla el período de retrospectiva del indicador gris de actualización. 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 recuento de notificaciones en la barra lateral para eventos próximos dentro del número especificado de días. "0" desactiva el recuento.

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 se verificó en la instantánea de fuente del producto, no a través de una sesión de producción autenticada. Un campo mostrado no implica que el panel alojado implemente el editor, las importaciones o las rutas de URL de Fava estándar.

Ver También​

• Configuración de Opciones — Las directivas option principales de Beancount.
• Funciones de Interfaz — Flujos de trabajo de Fava estándar y compatibilidad alojada.