Opções do Fava

O comportamento do Fava pode ser personalizado usando diretivas custom "fava-option" em seus arquivos de razão Beancount. Essas diretivas permitem controlar configurações de exibição, navegação, gerenciamento de arquivos e muito mais — tudo sem sair do seu fluxo de trabalho de contabilidade em texto simples.

Sintaxe​

Cada opção do Fava é definida com uma diretiva custom do Beancount:

YYYY-MM-DD custom "fava-option" "nome-da-opcao" "valor"

A data é exigida pela sintaxe do Beancount, mas é ignorada pelo Fava — você pode usar qualquer data válida. Por exemplo:

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

Exibição e Localização​

language​

Define o idioma da interface do Fava. Quando não definido, o Fava usa o idioma preferido do navegador.

• Padrão: null (detecção automática do navegador)
• Valores: Qualquer código de localidade válido (ex.: "en", "zh", "de", "fr", "es", "pt", "ru", "nl")

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

locale​

Define a localidade usada para formatação de números (separadores de milhares, pontos decimais). Quando não definido, usa a configuração de idioma ou a localidade do navegador.

• Padrão: null (usa a configuração language ou a localidade do navegador)
• Valores: Qualquer string de localidade válida (ex.: "en_US", "de_DE", "zh_CN")

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

Navegação e Layout​

default-page​

A página que o Fava mostra ao navegar para um razão sem especificar um caminho.

• Padrão: "income_statement/"
• Valores: Qualquer caminho de página Fava válido

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

Caminhos de página comuns incluem: "income_statement/", "balance_sheet/", "trial_balance/", "journal/", "holdings/", "commodities/", "editor/".

fiscal-year-end​

Define a data de fim do seu ano fiscal. Isso afeta como o Fava agrupa dados por período fiscal em vez de ano calendário.

• Padrão: 12-31 (31 de dezembro, ano calendário)
• Formato: "MM-DD"

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

Este exemplo define o ano fiscal terminando em 31 de março, comum para empresas no Reino Unido, Índia e Japão.

indent​

O número de espaços usados para indentação ao formatar automaticamente as entradas.

• Padrão: 2
• Valores: Qualquer número inteiro positivo

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

currency-column​

A coluna na qual os valores em moeda são alinhados no editor.

• Padrão: 61
• Valores: Qualquer número inteiro positivo

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

Visibilidade de Conteúdo​

show-closed-accounts​

Se devem ser exibidas as contas que foram fechadas com uma diretiva close.

• Padrão: false
• Valores: "true" ou "false"

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

show-accounts-with-zero-transactions​

Se devem ser exibidas as contas que possuem zero transações.

• Padrão: true
• Valores: "true" ou "false"

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

show-accounts-with-zero-balance​

Se devem ser exibidas as contas com saldo zero nos relatórios.

• Padrão: true
• Valores: "true" ou "false"

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

collapse-pattern​

Uma expressão regular para nomes de contas que devem ser recolhidas por padrão na árvore de contas. Você pode especificar esta opção várias vezes para vários padrões.

• Padrão: [] (sem padrões, nada recolhido)
• Valores: Uma string de expressão regular

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

sidebar-show-queries​

O número de consultas salvas a serem exibidas na barra lateral. Defina como 0 para ocultar consultas completamente.

• Padrão: 5
• Valores: Qualquer número inteiro não negativo

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

Gerenciamento de Arquivos​

default-file​

O arquivo no qual novas entradas são inseridas ao usar o editor. Se não definido, o Fava usa o arquivo de razão principal.

• Padrão: null (arquivo de razão principal)
• Valores: Caminho para um arquivo Beancount

2000-01-01 custom "fava-option" "default-file" "/caminho/para/transacoes.beancount"

insert-entry​

Uma expressão regular que controla onde novas entradas são inseridas em um arquivo. O Fava inserirá entradas antes da primeira linha que corresponder a este padrão.

• Padrão: null
• Valores: Uma string de expressão regular

2000-01-01 custom "fava-option" "insert-entry" "^;; Fim das entradas"

auto-reload​

Se o Fava recarrega automaticamente o razão quando alterações são detectadas no disco.

• Padrão: false
• Valores: "true" ou "false"

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

use-external-editor​

Se deve usar um editor externo em vez do editor integrado do Fava. Quando ativado, os links de origem abrem no editor padrão do sistema.

• Padrão: false
• Valores: "true" ou "false"

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

import-config​

Caminho para o arquivo de configuração de importação do Beancount para a funcionalidade de importação.

• Padrão: null
• Valores: Caminho para um arquivo de configuração de importação

2000-01-01 custom "fava-option" "import-config" "/caminho/para/config-importacao.py"

import-dirs​

Diretórios para escanear em busca de arquivos a importar. Pode ser especificado várias vezes.

• Padrão: []
• Valores: Caminho para um diretório

2000-01-01 custom "fava-option" "import-dirs" "/caminho/para/downloads-banco"

Exibição Financeira​

unrealized​

O subtipo de conta usado para relatórios de ganhos e perdas não realizados.

• Padrão: "Unrealized"
• Valores: Qualquer componente de nome de conta válido

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

Quando definido, o Fava usa contas como Income:Unrealized e Expenses:Unrealized para ganhos/perdas não realizados.

invert-income-liabilities-equity​

Se deve inverter o sinal das contas de Receita, Passivo e Patrimônio Líquido. Quando ativado, a receita é mostrada como positiva e as despesas como negativas, o que corresponde à expectativa comum.

• Padrão: false
• Valores: "true" ou "false"

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

conversion-currencies​

Moedas a serem exibidas como opções de conversão nos relatórios. Pode ser especificado várias vezes.

• Padrão: [] (usa as moedas operacionais)
• Valores: Um código de moeda

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

account-journal-include-children​

Se as páginas de diário de conta devem incluir transações de contas filhas.

• Padrão: true
• Valores: "true" ou "false"

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

Monitoramento​

uptodate-indicator-grey-lookback-days​

O número de dias para olhar para trás ao determinar se uma conta está "atualizada". Contas sem transações dentro deste período mostrarão um indicador cinza.

• Padrão: 60
• Valores: Qualquer número inteiro positivo (número de dias)

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

upcoming-events​

O número de dias no futuro para mostrar eventos futuros.

• Padrão: 7
• Valores: Qualquer número inteiro não negativo (número de dias)

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

Configuração Recomendada​

Para a maioria dos usuários, as seguintes opções do Fava fornecem um bom ponto de partida:

; Configurações de exibição
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
 
; Layout
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"
 
; Visibilidade de conteúdo
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
 
; Exibição financeira
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
 
; Monitoramento
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Visualizando Suas Opções Atuais​

Você pode visualizar suas opções atuais do Fava no Painel do Beancount.io navegando para a página Configurações do seu razão. A seção "Opções do Fava" exibe todos os valores configurados, incluindo os padrões para quaisquer opções que você não definiu explicitamente.

Veja Também​

• Configuração de Opções — Diretivas option principais do Beancount.
• Recursos da Interface — Personalize a interface do painel do Beancount.io.