Ir al contenido principal

Opciones de Fava

El comportamiento de Fava se puede personalizar mediante directivas custom "fava-option" en sus archivos de libro mayor de Beancount. Estas directivas le permiten controlar la configuración de visualización, la navegación, la gestión de archivos y más, todo sin salir de su flujo de trabajo de contabilidad en texto plano.

Sintaxis

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

YYYY-MM-DD custom "fava-option" "option-name" "value"

La fecha es requerida por la sintaxis de Beancount pero Fava la ignora; puede utilizar 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 y Localización

language

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

  • Predeterminado: null (autodetectar desde el navegador)
  • Valores: Cualquier código de idioma 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 (locale) utilizada para el formato de números (separadores de miles, puntos decimales). Si no se define, utiliza la configuración de idioma o la del navegador.

  • Predeterminado: null (utiliza la configuración de language o el locale del navegador)
  • Valores: Cualquier cadena de locale válida (ej. "en_US", "de_DE", "zh_CN")
2000-01-01 custom "fava-option" "locale" "en_US"

default-page

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

  • Predeterminado: "income_statement/"
  • Valores: Cualquier ruta de página válida de Fava
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 cierre de su año fiscal. Esto afecta la forma en que Fava agrupa los datos por período fiscal en lugar de por año natural.

  • Predeterminado: 12-31 (31 de diciembre, año natural)
  • Formato: "MM-DD"
2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"

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

indent

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

  • Predeterminado: 2
  • Valores: Cualquier número entero positivo
2000-01-01 custom "fava-option" "indent" "4"

currency-column

La columna en la que se alinean los importes de las divisas en el editor.

  • Predeterminado: 61
  • Valores: Cualquier número entero positivo
2000-01-01 custom "fava-option" "currency-column" "80"

Visibilidad del Contenido

show-closed-accounts

Indica si se deben mostrar las cuentas que han sido cerradas con una directiva close.

  • Predeterminado: false
  • Valores: "true" o "false"
2000-01-01 custom "fava-option" "show-closed-accounts" "true"

show-accounts-with-zero-transactions

Indica si se deben mostrar las cuentas que tienen cero transacciones.

  • Predeterminado: true
  • Valores: "true" o "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "false"

show-accounts-with-zero-balance

Indica si se deben mostrar las cuentas con saldo cero en los informes.

  • Predeterminado: true
  • Valores: "true" o "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"

collapse-pattern

Un patrón de expresión regular para los nombres de cuenta que deben colapsarse de forma predeterminada en el árbol de cuentas. Puede especificar esta opción varias veces para múltiples patrones.

  • Predeterminado: [] (sin patrones, nada colapsado)
  • 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:.*"

El número de consultas guardadas que se mostrarán en la barra lateral. Establézcalo en 0 para ocultar las consultas por completo.

  • Predeterminado: 5
  • Valores: Cualquier número 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 principal del libro mayor.

  • Predeterminado: null (archivo principal del libro mayor)
  • Valores: Ruta a un archivo de 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.

  • Predeterminado: null
  • Valores: Una cadena de expresión regular
2000-01-01 custom "fava-option" "insert-entry" "^;; Fin de las entradas"

auto-reload

Indica si Fava recarga automáticamente el libro mayor cuando se detectan cambios en el disco.

  • Predeterminado: false
  • Valores: "true" o "false"
2000-01-01 custom "fava-option" "auto-reload" "true"

use-external-editor

Indica si se debe utilizar un editor externo en lugar del editor integrado de Fava. Cuando está habilitado, los enlaces de origen se abren en el editor predeterminado del sistema.

  • 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.

- **Predeterminado**: `null`
- **Valores**: Ruta a un archivo de configuración de importación

```bean
2000-01-01 custom "fava-option" "import-config" "/path/to/import-config.py"

import-dirs

Directorios a escanear en busca de archivos para importar. Puede especificarse varias veces.

  • Predeterminado: []
  • Valores: Ruta a un directorio
2000-01-01 custom "fava-option" "import-dirs" "/path/to/bank-downloads"

Visualización Financiera

unrealized

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

  • Predeterminado: "Unrealized"
  • Valores: Cualquier componente de nombre de cuenta válido
2000-01-01 custom "fava-option" "unrealized" "Unrealized"

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

invert-income-liabilities-equity

Indica si se debe invertir 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.

  • Predeterminado: false
  • Valores: "true" o "false"
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "true"

conversion-currencies

Monedas a mostrar como opciones de conversión en los informes. Puede especificarse varias veces.

  • Predeterminado: [] (usa 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

Indica si las páginas del diario de cuenta deben incluir transacciones de las subcuentas.

  • 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 a revisar para determinar si una cuenta está "al día". Las cuentas sin transacciones dentro de este período mostrarán un indicador gris.

  • Predeterminado: 60
  • Valores: Cualquier número 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 en el futuro para mostrar eventos próximos.

  • Predeterminado: 7
  • Valores: Cualquier número 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:

; Ajustes de visualización
2000-01-01 custom "fava-option" "language" "es"
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 sus Opciones Actuales

Puede ver sus opciones actuales de Fava en el Panel de Beancount.io navegando a la página de Configuración de su libro mayor. La sección "Fava Options" muestra todos los valores configurados, incluidos los valores predeterminados para cualquier opción que no haya establecido explícitamente.

Ver También