گزینه‌های فاوا

فاوا را با دستورالعمل‌های تاریخ‌دار custom "fava-option" پیکربندی کنید. این تنظیمات جدا از گزینه‌های اصلی بیکانت هستند.

این مرجع با بیکانت 3.2.3، بین‌کوئری 0.2.0 و فاوا 1.30.16 اجرا شده است. ماتریس آن نسخه رسمی را توصیف می‌کند. Beancount.io یک داشبورد و بک‌اند جداگانه دارد؛ تنظیمات نمایش داده‌شده در آن ثابت نمی‌کند که هر ویژگی فاوا در آنجا موجود است.

نحو​

مقادیر رشته‌ای هستند، از جمله اعداد صحیح و مقادیر بولی. این مثال کامل در هر دو بیکانت و فاوا تجزیه می‌شود:

; 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"

تاریخ الزامی است. فاوا دستورالعمل‌های سفارشی بارگذاری‌شده را به ترتیب تاریخ پردازش می‌کند؛ یک تنظیم اسکالر بعدی، تنظیم قبلی را جایگزین می‌کند. تنظیمات تکراری 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 نحو و حساب‌داری بیکانت را بررسی می‌کند؛ فاوا علاوه بر آن، نام و مقادیر گزینه‌های خود را بررسی می‌کند. همچنین گزارش خطاهای فاوا را بررسی کنید.

مقادیر پیش‌فرض زیر از کلاس داده نصب‌شده FavaOptions خوانده شده و با تجزیه‌گر گزینه نسخه‌بندی‌شده مطابقت داده شده است. «نامشخص» به معنای None است؛ یک مجموعه خالی به معنای عدم وجود ورودی‌های پیکربندی شده است. ستون نوع مقدار، محتوای رشته نقل‌قول‌شده را توصیف می‌کند.

برای مقادیر بولی از "true" یا "false" استفاده کنید. مقایسه به حروف بزرگ و کوچک حساس نیست: "TRUE" نیز یک گزینه را فعال می‌کند. هر رشته‌ای غیر از نوع "true" به عنوان false در نظر گرفته می‌شود. تجزیه‌گر عدد صحیح، نحو اعداد صحیح را بررسی می‌کند، نه یک محدوده مثبت؛ از اندازه‌های چیدمان مثبت و شمارش‌های غیرمنفی استفاده کنید.

نمایش و بومی‌سازی​

language​

ترجمه رابط کاربری را تنظیم می‌کند، به عنوان مثال "en"، "de" یا "zh_CN". وقتی نامشخص باشد، فاوا با مرورگر مذاکره می‌کند. locale باید دارای ترجمه‌ای باشد که توسط فاوا ارائه شده باشد؛ یک کد زبان معتبر نحوی به تنهایی کافی نیست.

locale​

قالب‌بندی اعداد را مستقل از زبان رابط کاربری تنظیم می‌کند، به عنوان مثال "en_US" یا "de_DE". بدون این گزینه، فاوا از الگوی اعداد بومی‌سازی‌نشده خود استفاده می‌کند. گزینه اصلی option "render_commas" "TRUE" جایگزین en را فراهم می‌کند. locale از زبان مرورگر به ارث برده نمی‌شود.

ناوبری و چیدمان​

default-page​

مقصد درون دفتر کل را تنظیم می‌کند، مانند "balance_sheet/" یا "journal/?time=year". بخش بعد از اسلاگ دفتر کل را از یک URL کاری فاوا کپی کنید. مسیرهای گزارش را با / شروع نکنید: آنها نسبت به آن دفتر کل هستند.

fiscal-year-end​

مرزهای فیلتر زمانی مالی را تنظیم می‌کند. به عنوان مثال، "03-31" سال مالی را در ۳۱ مارس به پایان می‌رساند. از فیلترهای سال مالی و سه‌ماهه پشتیبانی می‌کند؛ تاریخ تراکنش‌ها را تغییر نمی‌دهد. فاوا همچنین مقادیر ماه بالای ۱۲ را می‌پذیرد تا سال مالی را برچسب‌گذاری کند که در سال تقویمی بعدی به پایان می‌رسد.

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​

یک ورودی جدید را قبل از یک دستورالعمل سفارشی مطابق، در فایل حاوی آن دستورالعمل قرار می‌دهد. عبارت باقاعده آن یک نام حساب را از ابتدا مطابقت می‌دهد؛ هرگز خطوط فایل خام را جستجو نمی‌کند. فاوا نوشته‌های تراکنش را از آخر به اول در نظر می‌گیرد. برای اولین حسابی که با واجد شرایط مطابقت دارد، آخرین قانون تاریخ‌دار strictly before ورودی جدید را انتخاب می‌کند. اگر هیچ‌کدام مطابقت نداشت، به فایل پیش‌فرض اضافه می‌کند. پیاده‌سازی درج مرجع این قوانین است.

این سه فایل را در همان دایرکتوری ایجاد کنید. 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$"

فاوا را با 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​

هنگامی که فاوا تغییر منبع خارجی را تشخیص دهد، صفحه را به صورت خودکار بازنشانی می‌کند. وقتی false باشد، فاوا یک اعلان بازنشانی ارائه می‌دهد. تغییرات ایجاد شده از طریق خود فاوا از قبل باعث بازنشانی می‌شوند.

use-external-editor​

پیوندهای منبع را از طریق طرح URL beancount:// باز می‌کند. یک مدیریت‌کننده روی رایانه‌ای که مرورگر را اجرا می‌کند نصب کنید و اطمینان حاصل کنید که می‌تواند به فایل‌های دفتر کل دسترسی داشته باشد. این یک اتصال خودکار به فایل‌های یک سرور میزبان نیست.

import-config​

به یک پیکربندی ایمپورتر پایتون اشاره می‌کند. این یک تنظیم یکپارچه‌سازی است: پیکربندی را ایجاد کنید و وابستگی‌های ایمپورتر آن را قبل از استفاده از گزارش Import نصب کنید. سه بسته ثابت‌شده بالا یک پیکربندی ایمپورتر بانکی ارائه نمی‌دهند.

import-dirs​

یک دایرکتوری برای اسکن کاندیداهای import اضافه می‌کند. برای افزودن دایرکتوری‌ها، دستورالعمل را تکرار کنید. از دایرکتوری‌های واقعی و قابل دسترس استفاده کنید؛ تنظیم گزینه آن‌ها را ایجاد نمی‌کند.

نمایش مالی​

unrealized​

یک گزینه رسمی فاوا 1.30.16 نیست. اگر آن را اضافه کنید، فاوا Unknown option و به دنبال آن نام را در backticks گزارش می‌دهد. از آن برای پیکربندی حساب‌های سود/زیان تحقق‌نیافته رسمی استفاده نکنید.

اسناد منبع 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"

تکرار این گزینه، لیست قبلی را جایگزین می‌کند. وقتی نامشخص باشد، فاوا ارزهای عملیاتی را به علاوه کالاهایی که به عنوان ارزهای 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"

مشاهده گزینه‌های فعلی خود​

در فاوا رسمی، صفحه Help → Options آن را برای مرجع نسخه نصب‌شده باز کنید و پس از تغییر یک دستورالعمل، Errors را بررسی کنید. راهنمای گزینه رسمی 1.30.16 تنظیمات را توضیح می‌دهد.

در داشبورد Beancount.io، صفحه تنظیمات یک دفتر کل را باز کنید. جدول گزینه‌های فاوا آن، زیرمجموعه‌ای را که توسط بک‌اند بازگردانده شده نشان می‌دهد. این رابط کاربری در اسناد منبع محصول تأیید شده است، نه از طریق یک جلسه تولید احراز هویت‌شده. یک فیلد نمایش‌داده‌شده به این معنی نیست که داشبورد میزبان، ویرایشگر، importها یا مسیرهای URL فاوا رسمی را پیاده‌سازی می‌کند.

همچنین ببینید​

• پیکربندی گزینه‌ها — دستورالعمل‌های اصلی option بیکانت.
• ویژگی‌های UI — گردش‌های کاری فاوا رسمی و سازگاری میزبانی.