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
숫자 서식(천 단위 구분 기호, 소수점)에 사용되는 로케일을 설정합니다. 설정하지 않으면 language 설정 또는 브라우저 로케일을 사용합니다.
- 기본값:
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
거래 건수가 0인 계정을 표시할지 여부입니다.
- 기본값:
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 - 값: 음수가 아닌 정수
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"현재 옵션 보기
Beancount.io 대시보드에서 원장의 설정 페이지로 이동하여 현재 Fava 옵션을 볼 수 있습니다. "Fava 옵션" 섹션에는 명시적으로 설정하지 않은 옵션에 대한 기본값을 포함한 모든 설정 값이 표시됩니다.