Opções do Fava

O comportamento do Fava pode ser personalizado usando diretivas custom "fava-option" nos seus arquivos de livro-razão do 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" "option-name" "value"

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 preferencial do navegador.

Padrão: null (detecção automática pelo 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 milhar, pontos decimais). Quando não definido, usa a configuração de idioma ou a localidade do navegador.

Padrão: null (usa a configuração de 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 quando você navega para um livro-razão sem especificar um caminho.

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

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 término do seu ano fiscal. Isso afeta como o Fava agrupa os dados por período fiscal em vez de ano civil.

Padrão: 12-31 (31 de dezembro, ano civil)
Formato: "MM-DD"

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

Este exemplo define o término do ano fiscal para 31 de março, o que é comum para empresas no Reino Unido, Índia e Japão.

`indent`

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

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 de 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 deve exibir contas que foram encerradas 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 deve exibir 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 deve exibir 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`

Um padrão de expressão regular para nomes de contas que devem ser recolhidos por padrão na árvore de contas. Você pode especificar esta opção várias vezes para múltiplos padrões.

Padrão: [] (nenhum padrão, 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 as 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 principal do livro-razão.

Padrão: null (arquivo principal do livro-razão)
Valores: Caminho para um arquivo Beancount

2000-01-01 custom "fava-option" "default-file" "/path/to/transactions.beancount"

`insert-entry`

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

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

2000-01-01 custom "fava-option" "insert-entry" "^;; End of entries"

`auto-reload`

Se o Fava recarrega automaticamente o livro-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

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

`import-dirs`

Diretórios para escanear arquivos para importar. Pode ser especificado várias vezes.

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

2000-01-01 custom "fava-option" "import-dirs" "/path/to/bank-downloads"

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 configurado, o Fava utiliza 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 é exibida 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 para exibir como opções de conversão em relatórios. Pode ser especificado várias vezes.

Padrão: [] (utiliza 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 a retroceder ao determinar se uma conta está "atualizada". Contas sem transações dentro deste período exibirã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 exibir eventos próximos.

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 Beancount.io Dashboard navegando até a página de Configurações (Settings) do seu livro-razão. A seção "Fava Options" exibe todos os valores configurados, incluindo os padrões para quaisquer opções que você não tenha definido explicitamente.

Veja Também

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

Share on Twitter Follow @beancount_io

Opções do Fava

Sintaxe

Exibição e Localização

`language`

`locale`

Navegação e Layout

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

Visibilidade de Conteúdo

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

Gerenciamento de Arquivos

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

Exibição Financeira

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

Monitoramento

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

Configuração Recomendada

Visualizando Suas Opções Atuais

Veja Também

Comece a usar o Beancount.io

Primeiros Passos

Recursos

Comunidade

Jurídico

Sintaxe​

Exibição e Localização​

language​

locale​

Navegação e Layout​

default-page​

fiscal-year-end​

indent​

currency-column​

Visibilidade de Conteúdo​

show-closed-accounts​

show-accounts-with-zero-transactions​

show-accounts-with-zero-balance​

collapse-pattern​

sidebar-show-queries​

Gerenciamento de Arquivos​

default-file​

insert-entry​

auto-reload​

use-external-editor​

import-dirs​

Exibição Financeira​

unrealized​

invert-income-liabilities-equity​

conversion-currencies​

account-journal-include-children​

Monitoramento​

uptodate-indicator-grey-lookback-days​

upcoming-events​

Configuração Recomendada​

Visualizando Suas Opções Atuais​

Veja Também​

Comece a usar o Beancount.io

Primeiros Passos

Recursos

Comunidade

Jurídico

Sintaxe

Exibição e Localização

`language`

`locale`

Navegação e Layout

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

Visibilidade de Conteúdo

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

Gerenciamento de Arquivos

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

Exibição Financeira

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

Monitoramento

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

Configuração Recomendada

Visualizando Suas Opções Atuais

Veja Também