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

보고서에서 잔액이 0인 계정을 표시할지 여부입니다.

• 기본값: 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
• 값: 0 이상의 정수

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

수익(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

계정 분개장(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
• 값: 0 이상의 정수 (일수)

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"

현재 옵션 확인하기

Beancount.io 대시보드의 장부 Settings 페이지에서 현재 Fava 옵션을 확인할 수 있습니다. "Fava Options" 섹션에는 명시적으로 설정하지 않은 옵션의 기본값을 포함하여 모든 구성된 값이 표시됩니다.

관련 항목

• 옵션 설정 — Beancount의 핵심 option 지시어
• UI 기능 — Beancount.io 대시보드 인터페이스 사용자 정의