Opciones de Fava

El comportamiento de Fava se puede personalizar mediante directivas custom "fava-option" en tus archivos de contabilidad Beancount. Estas directivas te permiten controlar ajustes de visualización, navegación, gestión de archivos y más, todo sin salir de tu flujo de trabajo de contabilidad en texto plano.

Sintaxis​

Cada opción de Fava se configura con una directiva custom de Beancount:

YYYY-MM-DD custom "fava-option" "nombre-opcion" "valor"

La fecha es requerida por la sintaxis de Beancount, pero Fava la ignora; puedes usar cualquier fecha válida. Por ejemplo:

2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"

Visualización e Internacionalización​

language​

Establece el idioma para la interfaz de Fava. Cuando no se define, Fava utiliza el idioma preferido del navegador.

• Valor predeterminado: null (detección automática desde el navegador)
• Valores: Cualquier código de configuración regional válido (ej., "en", "zh", "de", "fr", "es", "pt", "ru", "nl")

2000-01-01 custom "fava-option" "language" "en"

locale​

Establece la configuración regional utilizada para el formato de números (separadores de miles, puntos decimales). Cuando no se define, utiliza la configuración de idioma o la configuración regional del navegador.

• Valor predeterminado: null (usa la configuración de language o la configuración regional del navegador)
• Valores: Cualquier cadena de configuración regional válida (ej., "en_US", "de_DE", "zh_CN")

2000-01-01 custom "fava-option" "locale" "en_US"

Navegación y Diseño​

default-page​

La página que muestra Fava cuando navegas a un libro contable sin especificar una ruta.

• Valor predeterminado: "income_statement/"
• Valores: Cualquier ruta de página de Fava válida

2000-01-01 custom "fava-option" "default-page" "balance_sheet/"

Las rutas de página comunes incluyen: "income_statement/", "balance_sheet/", "trial_balance/", "journal/", "holdings/", "commodities/", "editor/".

fiscal-year-end​

Establece la fecha de fin de tu año fiscal. Esto afecta cómo Fava agrupa los datos por período fiscal en lugar de año calendario.

• Valor predeterminado: 12-31 (31 de diciembre, año calendario)
• Formato: "MM-DD"

2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"

Este ejemplo establece el año fiscal para que termine el 31 de marzo, común en empresas del Reino Unido, India y Japón.

indent​

El número de espacios utilizados para la sangría al formatear automáticamente las entradas.

• Valor predeterminado: 2
• Valores: Cualquier entero positivo

2000-01-01 custom "fava-option" "indent" "4"

currency-column​

La columna en la que se alinean los montos de las monedas en el editor.

• Valor predeterminado: 61
• Valores: Cualquier entero positivo

2000-01-01 custom "fava-option" "currency-column" "80"

Visibilidad del Contenido​

show-closed-accounts​

Si se muestran las cuentas que han sido cerradas con una directiva close.

• Valor predeterminado: false
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "show-closed-accounts" "true"

show-accounts-with-zero-transactions​

Si se muestran las cuentas que tienen cero transacciones.

• Valor predeterminado: true
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "false"

show-accounts-with-zero-balance​

Si se muestran las cuentas con saldo cero en los informes.

• Valor predeterminado: true
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"

collapse-pattern​

Una expresión regular para nombres de cuentas que deben contraerse por defecto en el árbol de cuentas. Puedes especificar esta opción varias veces para varios patrones.

• Valor predeterminado: [] (sin patrones, nada contraído)
• Valores: Una cadena de expresión regular

2000-01-01 custom "fava-option" "collapse-pattern" "Assets:Investments:.*"
2000-01-01 custom "fava-option" "collapse-pattern" "Expenses:Food:.*"

sidebar-show-queries​

El número de consultas guardadas para mostrar en la barra lateral. Establece en 0 para ocultar las consultas por completo.

• Valor predeterminado: 5
• Valores: Cualquier entero no negativo

2000-01-01 custom "fava-option" "sidebar-show-queries" "10"

Gestión de Archivos​

default-file​

El archivo en el que se insertan las nuevas entradas al usar el editor. Si no se establece, Fava utiliza el archivo de libro contable principal.

• Valor predeterminado: null (archivo de libro contable principal)
• Valores: Ruta a un archivo Beancount

2000-01-01 custom "fava-option" "default-file" "/ruta/a/transacciones.beancount"

insert-entry​

Una expresión regular que controla dónde se insertan las nuevas entradas en un archivo. Fava insertará las entradas antes de la primera línea que coincida con este patrón.

• Valor predeterminado: null
• Valores: Una cadena de expresión regular

2000-01-01 custom "fava-option" "insert-entry" "^;; Fin de entradas"

auto-reload​

Si Fava recarga automáticamente el libro contable cuando se detectan cambios en el disco.

• Valor predeterminado: false
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "auto-reload" "true"

use-external-editor​

Si se utiliza un editor externo en lugar del editor incorporado de Fava. Cuando está habilitado, los enlaces de origen se abren en el editor predeterminado del sistema.

• Valor predeterminado: false
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "use-external-editor" "true"

import-config​

Ruta al archivo de configuración de importación de Beancount para la funcionalidad de importación.

• Valor predeterminado: null
• Valores: Ruta a un archivo de configuración de importación

2000-01-01 custom "fava-option" "import-config" "/ruta/a/config-importacion.py"

import-dirs​

Directorios a escanear para buscar archivos a importar. Se puede especificar varias veces.

• Valor predeterminado: []
• Valores: Ruta a un directorio

2000-01-01 custom "fava-option" "import-dirs" "/ruta/a/descargas-banco"

Visualización Financiera​

unrealized​

El subtipo de cuenta utilizado para informar ganancias y pérdidas no realizadas.

• Valor predeterminado: "Unrealized"
• Valores: Cualquier componente de nombre de cuenta válido

2000-01-01 custom "fava-option" "unrealized" "Unrealized"

Cuando se establece, Fava utiliza cuentas como Income:Unrealized y Expenses:Unrealized para ganancias/pérdidas no realizadas.

invert-income-liabilities-equity​

Si se invierte el signo de las cuentas de Ingresos, Pasivos y Patrimonio. Cuando está habilitado, los ingresos se muestran como positivos y los gastos como negativos, lo que coincide con la expectativa común.

• Valor predeterminado: false
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "true"

conversion-currencies​

Monedas para mostrar como opciones de conversión en los informes. Se puede especificar varias veces.

• Valor predeterminado: [] (utiliza las monedas operativas)
• Valores: Un código de moneda

2000-01-01 custom "fava-option" "conversion-currencies" "USD"
2000-01-01 custom "fava-option" "conversion-currencies" "EUR"

account-journal-include-children​

Si las páginas del diario de cuentas deben incluir transacciones de cuentas secundarias.

• Valor predeterminado: true
• Valores: "true" o "false"

2000-01-01 custom "fava-option" "account-journal-include-children" "false"

Monitoreo​

uptodate-indicator-grey-lookback-days​

El número de días hacia atrás para determinar si una cuenta está "al día". Las cuentas sin transacciones dentro de este período mostrarán un indicador gris.

• Valor predeterminado: 60
• Valores: Cualquier entero positivo (número de días)

2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "90"

upcoming-events​

El número de días hacia el futuro para mostrar los próximos eventos.

• Valor predeterminado: 7
• Valores: Cualquier entero no negativo (número de días)

2000-01-01 custom "fava-option" "upcoming-events" "14"

Configuración Recomendada​

Para la mayoría de los usuarios, las siguientes opciones de Fava proporcionan un buen punto de partida:

; Configuración de visualización
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
 
; Diseño
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"
 
; Visibilidad del contenido
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
 
; Visualización financiera
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
 
; Monitoreo
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Visualización de tus Opciones Actuales​

Puedes ver tus opciones actuales de Fava en el Panel de Beancount.io navegando a la página Configuración de tu libro contable. La sección "Opciones de Fava" muestra todos los valores configurados, incluidos los valores predeterminados para cualquier opción que no hayas establecido explícitamente.

Véase También​

• Configuración de Opciones — Directivas option principales de Beancount.
• Funcionalidades de la Interfaz — Personaliza la interfaz del panel de Beancount.io.