Fava オプション

Favaの動作は、Beancount元帳ファイル内の custom "fava-option" ディレクティブを使用してカスタマイズできます。これらのディレクティブにより、表示設定、ナビゲーション、ファイル管理などを、プレーンテキスト会計のワークフローを離れることなく制御できます。

構文

各Favaオプションは、Beancountの custom ディレクティブで設定されます：

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 (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`
- **値**: インポート設定ファイルへのパス

```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`

収益、負債、および資本勘定の符号を反転させるかどうか。有効にすると、収益が正、費用が負として表示され、一般的な期待に一致します。

デフォルト: 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 ダッシュボードの元帳の Settings（設定） ページで確認できます。「Fava Options」セクションには、明示的に設定していないオプションのデフォルト値を含め、すべての構成済みの値が表示されます。

Fava オプション

構文

表示とローカライズ

`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を始める

はじめに

機能

コミュニティ

法務

構文​

表示とローカライズ​

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を始める

はじめに

機能

コミュニティ

法務

構文

表示とローカライズ

`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`

推奨設定

現在の設定を確認する

関連項目