Параметры Fava

Настройте стандартную 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 'beancount==3.2.3' 'beanquery==0.2.0' 'fava==1.30.16'
source .venv-fava-docs/bin/activate
bean-check main.beancount
fava main.beancount

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

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

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

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

language​

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

locale​

Устанавливает форматирование чисел независимо от языка интерфейса, например "en_US" или "de_DE". Без этого параметра Fava использует свой нелокализованный шаблон чисел. Основной 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-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 счета; см. пример метаданных интерфейса.

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» показывает подмножество, возвращаемое серверной частью. Этот интерфейс был проверен в снимке исходного кода продукта, а не в аутентифицированном производственном сеансе. Отображаемое поле не означает, что размещаемая панель управления реализует редактор, импорт или маршруты URL стандартной Fava.

См. также​

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