Опции Fava

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

Синтаксис

Каждая опция Fava устанавливается с помощью директивы Beancount custom:

YYYY-MM-DD custom "fava-option" "option-name" "value"

Дата обязательна согласно синтаксису 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

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

• По умолчанию: 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 декабря, календарный год)
• Формат: "MM-DD"

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`
- **Значения**: Путь к конфигурационному файлу импорта

```bean
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

Инвертировать ли знак счетов Доходов (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

Количество дней для анализа при определении актуальности счета («up to date»). Счета, на которых не было транзакций в течение этого периода, будут иметь серый индикатор.

• По умолчанию: 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, перейдя на страницу Settings (Настройки) вашего гроссбуха. В разделе «Fava Options» отображаются все настроенные значения, включая значения по умолчанию для любых опций, которые вы не установили явно.

Смотрите также

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