Справочник параметров Fava для веб-интерфейса Beancount

Настройте стандартный Fava с помощью директив с датами custom "fava-option". Эти настройки отделены от основных опций Beancount.

Этот справочник был выполнен с использованием Beancount 3.2.3, beanquery 0.2.0 и Fava 1.30.16. Матрица описывает эту стандартную версию. Beancount.io имеет отдельную панель и бекенд; отображаемые там настройки не гарантируют, что все функции стандартного Fava там доступны.

Синтаксис​

Значения — это заключённые в кавычки строки, включая целые числа и булевы значения. Этот полный пример парсится и в Beancount, и в 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"

Дата обязательна. Fava обрабатывает загруженные пользовательские директивы в порядке их дат; более позднее скалярное значение заменяет более раннее. Повторяющиеся настройки collapse-pattern, import-dirs и insert-entry накапливаются. Правила вставки используют их даты для выбора назначения, поэтому эти даты имеют значение.

Чтобы воспроизвести примеры локально, установите uv, затем создайте временную среду:

uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'fava==1.30.16'
uv tool install beancount-io
source .venv-fava-docs/bin/activate
bea --file main.beancount check
fava main.beancount

Сначала создайте main.beancount из блока конфигурации или используйте существующий ledger. Команды shell выше используют пути POSIX. bea check проверяет синтаксис и бухгалтерию Beancount; Fava дополнительно проверяет собственные имена и значения опций. Также просмотрите отчет об ошибках Fava.

Настройки по умолчанию ниже были считаны из установленного dataclass FavaOptions и проверены с помощью версированной парсинговой опции. «Не установлено» означает None; пустая коллекция означает отсутствие настроенных записей. Столбец типа значения описывает содержимое заключённой в кавычки строки.

Используйте "true" или "false" для логических значений (boolean). Сравнение нечувствительно к регистру: "TRUE" также включает опцию. Любая строка, кроме варианта регистра "true", считается ложной. Его парсер целых чисел проверяет синтаксис целого числа, а не положительный диапазон; используйте положительные размеры макета и неположительные счётчики.

Отображение и локализация​

language​

Устанавливает перевод интерфейса, например "en", "de" или "zh_CN". Если не установлен, Fava выбирает язык согласно настройкам браузера. Локаль должна иметь перевод, поставляемый Fava; только синтаксически корректный языковой код недостаточен.

locale​

Устанавливает форматирование чисел независимо от языка интерфейса, например "en_US" или "de_DE". Без этой опции Fava использует свой нелокализованный шаблон чисел. Core option "render_commas" "TRUE" обеспечивает резервный вариант en. Он не унаследует язык браузера.

Навигация и интерфейс​

default-page​

Устанавливает место назначения внутри книги учёта, например "balance_sheet/" или "journal/?time=year". Скопируйте часть после сегмента книги учёта из рабочего URL Fava. Не добавляйте в начало /: пути отчётов являются относительными к этой книге учёта.

fiscal-year-end​

Устанавливает границы фильтра по фискальному времени. Например, "03-31" завершает фискальный год 31 марта. Поддерживает фильтры по фискальному году и кварталу; не изменяет даты транзакций. Fava также принимает значения месяцев выше 12 для обозначения фискального года, заканчивающегося в следующем календарном году.

indent​

Устанавливает отступ записей для сгенерированных операций и форматирования редактора. Используйте строку с положительным целым числом, например "4".

currency-column​

Устанавливает колонку выравнивания валюты при сохранении или выравнивании записей. Также задаёт положение вертикальной направляющей редактора. Значение по умолчанию — "61".

Видимость содержимого​

show-closed-accounts​

Включает закрытые счета в дерево счетов отчёта. Счета с ненулевым балансом остаются видимыми независимо от этой настройки.

show-accounts-with-zero-transactions​

Включает счета без транзакций в деревья счетов. Не скрывает счёт с ненулевым балансом.

show-accounts-with-zero-balance​

Включает счета с нулевым балансом отчёта. Выключите с помощью "false" для более компактного дерева.

collapse-pattern​

Соответствует именам счетов, которые следует свернуть в деревьях счетов. Повторите директиву для нескольких шаблонов. Например, "^Assets:Investments" сворачивает этот счёт и его потомков.

sidebar-show-queries​

Ограничивает количество сохранённых запросов, связанных на боковой панели. "0" скрывает эти ссылки. См. пользовательские ссылки и запросы.

show-metadata-indicators​

Показывает маленькие значки метаданных в журналах. Установите в "false", чтобы скрыть значки без удаления метаданных из книги учёта.

Управление файлами​

default-file​

Выбирает файл, который изначально открывается редактором, и резервное место для новых записей. Относительный путь разрешается из файла, содержащего директиву. Если значение отсутствует, выбирается содержащий файл. Без этой опции резервным является основной файл книги учёта. Существующий файл должен также быть включён в книгу учёта, чтобы быть редактируемым источником.

insert-entry​

Размещает новую запись перед совпадающей пользовательской директивой в файле, содержащем эту директиву. Его регулярное выражение совпадает с именем счета с начала; оно никогда не ищет по необработанным строкам файла. Fava рассматривает проводки транзакций с конца к началу. Для первого счета с подходящим совпадением выбирается последнее правило, датированное строго до новой записи. Если совпадений нет, запись добавляется в файл по умолчанию. Реализация вставки является авторитетом для этих правил.

Создайте эти три файла в одном каталоге. main.beancount поставляет счета и включает:

; 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 содержит:

; january.beancount
2024-01-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

february.beancount содержит:

; february.beancount
2024-02-01 custom "fava-option" "insert-entry" "^Assets:Checking$"

Запустите Fava с main.beancount. Добавляйте эти транзакции через форму транзакций; они являются входными данными для операции вставки, а не дополнительным файлом для предварительного включения:

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

Первые две записи размещаются перед правилом января. Третья — перед правилом февраля. Четвертая пробует Assets:Cash, не находит совпадения, затем использует правило Expenses:Food в основном файле. Пятая не имеет совпадающего счета и добавляется в main.beancount. Сохранение пакета обновляет номера строк правил по мере вставки записей.

auto-reload​

Автоматически перезагружает страницу, когда Fava обнаруживает изменение во внешнем источнике. При значении false Fava предлагает уведомление о перезагрузке. Изменения, сделанные через сам Fava, уже вызывают перезагрузку.

use-external-editor​

Открывает ссылки на исходники через URL-схему beancount://. Установите обработчик на компьютере с браузером и убедитесь, что он имеет доступ к файлам бухгалтерской книги. Это не автоматическое подключение к файлам, размещенным на сервере.

import-config​

Указывает конфигурацию импортера Python. Это настройка интеграции: создайте конфигурацию и установите ее зависимости импортера перед использованием отчета Import. Три закрепленных выше пакета не предоставляют конфигурацию импортера банка.

import-dirs​

Добавляет каталог для сканирования на наличие кандидатов для импорта. Повторяйте директиву, чтобы добавить каталоги. Используйте реальные доступные каталоги; установка опции не создает их.

Финансовое отображение​

unrealized​

Не является стандартной опцией Fava 1.30.16. Fava выводит Unknown option с последующим именем в обратных кавычках, если вы добавите ее. Не используйте для настройки стандартных счетов нереализованной прибыли.

Обзор исходного снимка Beancount.io от 2026-09-07 действительно выявляет отдельное строковое поле с именем unrealized, с значением по умолчанию "Unrealized", в парсере опций бэкенда и таблице настроек панели управления. Это подтверждает существование поля там. Это не доказывает, что изменение этого поля создает Income:Unrealized или Expenses:Unrealized, или что конкретное развертывание запускает этот снимок.

invert-income-liabilities-equity​

Инвертирует отображаемые знаки Доходов, Обязательств и Капитала в отчёте о доходах и балансовом отчёте. Расходы сохраняют свои знаки. Журнальные записи, журналы счетов и сохранённые проводки остаются без изменений.

conversion-currencies​

Заменяет варианты выбора конверсии выпадающего списка на список, разделённый пробелами в одной строке:

; Conversion dropdown
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"

Повторное использование этой опции заменяет предыдущий список. Если не задано, Fava предлагает операционные валюты плюс товары, распознаваемые как валюты ISO 4217.

account-journal-include-children​

По умолчанию включает записи дочерних счетов в журнал счёта. Установите значение "false", чтобы начинать только с этого счёта.

invert-gains-losses-colors​

Инвертирует цвета, используемые для нереализованных прибылей и убытков в представлениях баланса по рыночной стоимости и пробного баланса. Меняются цвета, а не суммы или имена счетов.

Мониторинг​

uptodate-indicator-grey-lookback-days​

Контролирует период просмотра серого индикатора свежести. Активируйте индикаторы счёта с помощью fava-uptodate-indication: TRUE в директиве open счёта; см. пример метаданных UI.

upcoming-events​

Контролирует количество уведомлений в боковой панели о предстоящих событиях за указанное число дней. "0" отключает подсчет.

Рекомендуемая конфигурация​

Эта полная конфигурация является стартовой точкой для стандартной среды выше. Она меняет настройки отображения без загрузки плагинов или необходимости дополнительных файлов:

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"

Просмотр текущих опций​

В стандартной версии Fava откройте страницу Помощь → Опции для справки по установленной версии и проверьте Ошибки после изменения директивы. Официальная помощь по опциям для версии 1.30.16 объясняет настройки.

В панели Beancount.io откройте страницу Настроек бухгалтерской книги. Таблица Опций Fava показывает подмножество, возвращаемое бэкендом. Этот UI был проверен в исходном снимке продукта, а не через аутентифицированную продакшн-сессию. Наличие поля на экране не означает, что размещённая панель реализует редактор стандартного Fava, импорты или URL-маршруты.

См. также​

• Конфигурация опций — Основные директивы option Beancount.
• Функции интерфейса — Стандартные рабочие процессы Fava и совместимость с хостингом.