Параметры Fava

Поведение Fava можно настроить с помощью директив custom "fava-option" в ваших файлах главной книги Beancount. Эти директивы позволяют управлять настройками отображения, навигации, управления файлами и многим другим — не выходя из вашего рабочего процесса с текстовой бухгалтерией.

Синтаксис​

Каждый параметр Fava задается директивой Beancount custom:

ГГГГ-ММ-ДД custom "fava-option" "имя-параметра" "значение"

Дата обязательна для синтаксиса Beancount, но игнорируется Fava — вы можете использовать любую допустимую дату. Например:

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

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

language​

Устанавливает язык интерфейса Fava. Если не задано, Fava использует предпочитаемый язык браузера.

• По умолчанию: null (автоопределение из браузера)
• Значения: Любой допустимый код локали (например, "en", "zh", "de", "fr", "es", "pt", "ru", "nl")

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

locale​

Устанавливает локаль, используемую для форматирования чисел (разделители тысяч, десятичные точки). Если не задано, используется настройка language или локаль браузера.

• По умолчанию: null (используется настройка language или локаль браузера)
• Значения: Любая допустимая строка локали (например, "en_US", "de_DE", "zh_CN")

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

Навигация и Макет​

default-page​

Страница, которую Fava показывает при переходе к главной книге без указания пути.

• По умолчанию: "income_statement/"
• Значения: Любой допустимый путь страницы Fava

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

Распространенные пути страниц включают: "income_statement/", "balance_sheet/", "trial_balance/", "journal/", "holdings/", "commodities/", "editor/".

fiscal-year-end​

Устанавливает дату окончания вашего финансового года. Это влияет на то, как Fava группирует данные по финансовым периодам, а не по календарному году.

• По умолчанию: 12-31 (31 декабря, календарный год)
• Формат: "ММ-ДД"

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

Этот пример устанавливает окончание финансового года на 31 марта, что распространено для компаний в Великобритании, Индии и Японии.

indent​

Количество пробелов, используемых для отступа при автоформатировании записей.

• По умолчанию: 2
• Значения: Любое положительное целое число

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

currency-column​

Колонка, по которой выравниваются суммы валют в редакторе.

• По умолчанию: 61
• Значения: Любое положительное целое число

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

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

show-closed-accounts​

Отображать ли счета, которые были закрыты с помощью директивы close.

• По умолчанию: false
• Значения: "true" или "false"

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

show-accounts-with-zero-transactions​

Отображать ли счета с нулевым количеством транзакций.

• По умолчанию: true
• Значения: "true" или "false"

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

show-accounts-with-zero-balance​

Отображать ли счета с нулевым балансом в отчетах.

• По умолчанию: true
• Значения: "true" или "false"

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

collapse-pattern​

Шаблон регулярного выражения для имен счетов, которые должны быть свернуты по умолчанию в дереве счетов. Вы можете указать этот параметр несколько раз для нескольких шаблонов.

• По умолчанию: [] (без шаблонов, ничего не свернуто)
• Значения: Строка регулярного выражения

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

sidebar-show-queries​

Количество сохраненных запросов для отображения на боковой панели. Установите 0, чтобы полностью скрыть запросы.

• По умолчанию: 5
• Значения: Любое неотрицательное целое число

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

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

default-file​

Файл, в который вставляются новые записи при использовании редактора. Если не задано, Fava использует основной файл главной книги.

• По умолчанию: null (основной файл главной книги)
• Значения: Путь к файлу Beancount

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

insert-entry​

Регулярное выражение, которое управляет тем, куда вставляются новые записи в файл. Fava вставляет записи перед первой строкой, соответствующей этому шаблону.

• По умолчанию: null
• Значения: Строка регулярного выражения

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

auto-reload​

Автоматически ли Fava перезагружает главную книгу при обнаружении изменений на диске.

• По умолчанию: false
• Значения: "true" или "false"

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

use-external-editor​

Использовать ли внешний редактор вместо встроенного редактора Fava. При включении ссылки на исходные файлы открываются в редакторе системы по умолчанию.

• По умолчанию: false
• Значения: "true" или "false"

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

import-config​

Путь к файлу конфигурации импорта Beancount для функции импорта.

• По умолчанию: null
• Значения: Путь к файлу конфигурации импорта

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

import-dirs​

Каталоги для поиска файлов для импорта. Можно указать несколько раз.

• По умолчанию: []
• Значения: Путь к каталогу

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

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

unrealized​

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

• По умолчанию: "Unrealized"
• Значения: Любой допустимый компонент имени счета

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

При установке Fava использует счета, такие как Income:Unrealized и Expenses:Unrealized, для нереализованных прибылей/убытков.

invert-income-liabilities-equity​

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

• По умолчанию: false
• Значения: "true" или "false"

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

conversion-currencies​

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

• По умолчанию: [] (используются операционные валюты)
• Значения: Код валюты

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

account-journal-include-children​

Должны ли страницы журнала счета включать транзакции дочерних счетов.

• По умолчанию: true
• Значения: "true" или "false"

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

Мониторинг​

uptodate-indicator-grey-lookback-days​

Количество дней, на которое нужно оглядываться назад при определении актуальности счета. Счета без транзакций в течение этого периода будут отображаться серым индикатором.

• По умолчанию: 60
• Значения: Любое положительное целое число (количество дней)

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

upcoming-events​

Количество дней в будущем для отображения предстоящих событий.

• По умолчанию: 7
• Значения: Любое неотрицательное целое число (количество дней)

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

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

Для большинства пользователей следующие параметры Fava представляют собой хорошую отправную точку:

; Настройки отображения
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" "currency-column" "61"
 
; Видимость содержимого
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
 
; Финансовое отображение
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
 
; Мониторинг
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Просмотр текущих параметров​

Вы можете просмотреть свои текущие параметры Fava в Панели управления Beancount.io, перейдя на страницу Настройки вашей главной книги. Раздел "Параметры Fava" отображает все настроенные значения, включая значения по умолчанию для параметров, которые вы явно не задавали.

См. также​

• Конфигурация параметров — основные директивы option Beancount.
• Функции интерфейса — настройка интерфейса панели управления Beancount.io.