Fava の動作は、Beancount 台帳ファイル内の custom "fava-option" ディレクティブを使用してカスタマイズできます。これらのディレクティブにより、プレーンテキストの簿記ワークフローから離れることなく、表示設定、ナビゲーション、ファイル管理などを制御できます。
構文
各 Fava オプションは、Beancount の custom ディレクティブで設定します。
YYYY-MM-DD custom "fava-option" "オプション名" "値"日付は 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(12月31日、暦年) - 形式:
"MM-DD"
2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"この例では、英国、インド、日本で一般的な、会計年度を3月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 オプション」セクションには、明示的に設定していないオプションのデフォルトを含む、すべての設定値が表示されます。