تنظیمات فاوا (Fava Options)

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

نحو (Syntax)

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

YYYY-MM-DD custom "fava-option" "option-name" "value"

تاریخ طبق نحو Beancount الزامی است اما توسط فاوا نادیده گرفته می‌شود — می‌توانید از هر تاریخ معتبری استفاده کنید. برای مثال:

2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"

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

`language`

زبان رابط کاربری فاوا را تنظیم می‌کند. در صورت عدم تنظیم، فاوا از زبان ترجیحی مرورگر استفاده می‌کند.

پیش‌فرض: null (تشخیص خودکار از مرورگر)
مقادیر: هر کد محلی (locale) معتبر (مانند "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`

صفحه‌ای که فاوا هنگام ناوبری به یک دفتر کل بدون مشخص کردن مسیر نشان می‌دهد.

پیش‌فرض: "income_statement/"
مقادیر: هر مسیر معتبر از صفحات فاوا

2000-01-01 custom "fava-option" "default-page" "balance_sheet/"

مسیرهای رایج صفحات عبارتند از: "income_statement/" (صورت سود و زیان)، "balance_sheet/" (ترازنامه)، "trial_balance/" (تراز آزمایشی)، "journal/" (دفتر روزنامه)، "holdings/" (دارایی‌ها)، "commodities/" (کالاها/ارزها)، "editor/" (ویرایشگر).

`fiscal-year-end`

تاریخ پایان سال مالی خود را تنظیم کنید. این گزینه بر نحوه گروه‌بندی داده‌ها توسط فاوا بر اساس دوره مالی به جای سال تقویمی تأثیر می‌گذارد.

پیش‌فرض: 12-31 (۳۱ دسامبر، سال تقویمی)
قالب: "MM-DD"

2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"

این مثال سال مالی را برای پایان در ۳۱ مارس تنظیم می‌کند که در کسب‌وکارهای بریتانیا، هند و ژاپن رایج است.

`indent`

تعداد فضاهای خالی (spaces) مورد استفاده برای تورفتگی هنگام قالب‌بندی خودکار ورودی‌ها.

پیش‌فرض: 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`

یک الگوی عبارت منظم (regular expression) برای نام حساب‌هایی که باید به طور پیش‌فرض در درخت حساب‌ها جمع (collapse) شوند. می‌توانید این گزینه را چندین بار برای الگوهای مختلف مشخص کنید.

پیش‌فرض: [] (بدون الگو، چیزی جمع نمی‌شود)
مقادیر: یک رشته عبارت منظم

2000-01-01 custom "fava-option" "collapse-pattern" "Assets:Investments:.*"
2000-01-01 custom "fava-option" "collapse-pattern" "Expenses:Food:.*"

`sidebar-show-queries`

تعداد پرس‌وجوهای (queries) ذخیره شده برای نمایش در نوار کناری. برای مخفی کردن کامل پرس‌وجوها، مقدار را روی 0 قرار دهید.

پیش‌فرض: 5
مقادیر: هر عدد صحیح غیر منفی

2000-01-01 custom "fava-option" "sidebar-show-queries" "10"

مدیریت فایل

`default-file`

فایلی که ورودی‌های جدید هنگام استفاده از ویرایشگر در آن درج می‌شوند. اگر تنظیم نشود، فاوا از فایل اصلی دفتر کل استفاده می‌کند.

پیش‌فرض: null (فایل اصلی دفتر کل)
مقادیر: مسیر یک فایل Beancount

2000-01-01 custom "fava-option" "default-file" "/path/to/transactions.beancount"

`insert-entry`

یک عبارت منظم که کنترل می‌کند ورودی‌های جدید در کجای فایل درج شوند. فاوا ورودی‌ها را قبل از اولین خطی که با این الگو مطابقت داشته باشد درج می‌کند.

پیش‌فرض: null
مقادیر: یک رشته عبارت منظم

2000-01-01 custom "fava-option" "insert-entry" "^;; End of entries"

`auto-reload`

آیا فاوا هنگام تشخیص تغییرات در دیسک، به طور خودکار دفتر کل را بارگذاری مجدد کند یا خیر.

پیش‌فرض: false
مقادیر: "true" یا "false"

2000-01-01 custom "fava-option" "auto-reload" "true"

`use-external-editor`

آیا به جای ویرایشگر داخلی فاوا از یک ویرایشگر خارجی استفاده شود. در صورت فعال بودن، لینک‌های منبع در ویرایشگر پیش‌فرض سیستم باز می‌شوند.

پیش‌فرض: 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`

آیا علامت حساب‌های درآمد (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`

آیا صفحات دفتر روزنامه حساب (Account Journal) باید شامل تراکنش‌های حساب‌های زیرمجموعه نیز باشند یا خیر.

پیش‌فرض: 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

Share on Twitter Follow @beancount_io

تنظیمات فاوا (Fava Options)

نحو (Syntax)

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

`language`

`locale`

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

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

رویت‌پذیری محتوا

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

مدیریت فایل

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

نمایش مالی

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

نظارت

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

پیکربندی پیشنهادی

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

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

شروع کار با Beancount.io

شروع کار

ویژگی‌ها

جامعه کاربری

حقوقی

نحو (Syntax)​

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

language​

locale​

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

default-page​

fiscal-year-end​

indent​

currency-column​

رویت‌پذیری محتوا​

show-closed-accounts​

show-accounts-with-zero-transactions​

show-accounts-with-zero-balance​

collapse-pattern​

sidebar-show-queries​

مدیریت فایل​

default-file​

insert-entry​

auto-reload​

use-external-editor​

import-dirs​

نمایش مالی​

unrealized​

invert-income-liabilities-equity​

conversion-currencies​

account-journal-include-children​

نظارت​

uptodate-indicator-grey-lookback-days​

upcoming-events​

پیکربندی پیشنهادی​

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

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

شروع کار با Beancount.io

شروع کار

ویژگی‌ها

جامعه کاربری

حقوقی

نحو (Syntax)

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

`language`

`locale`

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

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

رویت‌پذیری محتوا

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

مدیریت فایل

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

نمایش مالی

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

نظارت

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

پیکربندی پیشنهادی

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

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