Опції 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", "uk", "de", "fr", "es", "pt", "ru", "nl")

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

locale

Встановіть локаль, що використовується для форматування чисел (розділювачі тисяч, десяткові крапки). Якщо не встановлено, використовується налаштування мови або локаль браузера.

• За замовчуванням: null (використовує налаштування language або локаль браузера)
• Значення: Будь-який дійсний рядок локалі (наприклад, "en_US", "de_DE", "uk_UA")

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

Чи інвертувати знак рахунків доходів, зобов'язань та власного капіталу. Якщо увімкнено, доходи відображаються як позитивні, а витрати як негативні, що відповідає загальноприйнятим очікуванням.

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

Дивіться також

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