Справочник за опциите на Fava за уеб интерфейса на Beancount

Конфигурирайте стандартния 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 'fava==1.30.16'
uv tool install beancount-io
source .venv-fava-docs/bin/activate
bea --file main.beancount check
fava main.beancount

Създайте main.beancount от конфигурационния блок първо или използвайте съществуващ счетоводен регистър. Командите в шел по-горе използват POSIX пътища. bea check проверява синтаксиса и счетоводството на Beancount; Fava допълнително проверява собствените си имена и стойности на опции. Разгледайте и отчета за грешки на Fava.

Дефолтните стойности по-долу са прочетени от инсталирания FavaOptions dataclass и проверени спрямо парсера за опции с контрол на версиите. „Unset“ означава None; празна колекция означава няма конфигурирани записи. Колоната за тип на стойността описва съдържанието на цитирания низ.

Използвайте "true" или "false" за булеви стойности. Сравнението е нечувствително към главни/малки букви: "TRUE" също активира опция. Всеки низ, различен от вариант на писане на "true", се третира като false. Парсърът му за цели числа проверява синтаксиса на числото, а не положителен диапазон; използвайте положителни размери на оформлението и ненегативни броя.

Изглед и локализация​

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". Копирайте частта след идентификатора на главната книга от работещ Fava URL адрес на запас. Не добавяйте / отпред: пътищата на отчетите са спрямо тази главна книга.

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​

Ограничaва броя на запазените заявки, свързани в страничната лента. "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; вижте пример за UI метаданни.

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 показва подмножеството, върнато от бекенда. Този UI беше проверен в изходния код на продукта, а не през удостоверена производствена сесия. Показвано поле не означава, че хостваното табло поддържа редактора, импорти или URL пътищата на стандартния Fava.

Вижте също​

• Конфигурация на опциите — Основните option директиви на Beancount.
• UI функции — Стандартни работни потоци на Fava и съвместимост при хостинг.