Параметри 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 та сумісність хостингу.