گزینه‌های Fava

رفتار Fava را می‌توان با استفاده از دستورالعمل‌های custom "fava-option" در فایل‌های دفتر کل Beancount خود سفارشی‌سازی کرد. این دستورالعمل‌ها به شما امکان می‌دهند تنظیمات نمایش، ناوبری، مدیریت فایل و موارد دیگر را کنترل کنید - همه بدون ترک جریان کار حسابداری متن‌محور خود.

نحو​

هر گزینه Fava با یک دستورالعمل custom Beancount تنظیم می‌شود:

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 (۳۱ دسامبر، سال تقویمی)
• قالب: "MM-DD"

2000-01-01 custom "fava-option" "fiscal-year-end" "03-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
• مقادیر: مسیر یک فایل پیکربندی واردات

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

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

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