날짜가 지정된 custom "fava-option" 지시문으로 stock Fava를 구성하세요. 이러한 설정은 Beancount 핵심 옵션과 별개입니다.
이 참조는 Beancount 3.2.3, beanquery 0.2.0 및 Fava 1.30.16으로 실행되었습니다. 매트릭스는 해당 stock 릴리스를 설명합니다. Beancount.io는 별도의 대시보드와 백엔드를 가지고 있으며, 노출된 설정이 모든 stock Fava 기능이 그곳에 있음을 증명하지는 않습니다.
문법
값은 정수와 불리언을 포함한 인용된 문자열입니다. 이 완전한 예시는 Beancount와 Fava 모두에서 구문 분석됩니다:
; Minimal Fava configuration
option "operating_currency" "USD"
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" "show-closed-accounts" "false"날짜는 필수입니다. Fava는 로드된 커스텀 지시문을 날짜 순서로 처리하며, 나중에 나온 스칼라 설정이 이전 설정을 대체합니다. 반복되는 collapse-pattern, import-dirs 및 insert-entry 설정은 누적됩니다. 삽입 규칙은 대상 선택에 날짜를 사용하므로, 해당 날짜는 중요합니다.
로컬에서 예제를 재현하려면 uv를 설치한 다음 일회성 환경을 만드세요:
uv venv .venv-fava-docs
uv pip install --python .venv-fava-docs/bin/python 'fava==1.30.16'
uv tool install beancount-io
source .venv-fava-docs/bin/activate
bea --file main.beancount check
fava main.beancount먼저 구성 블록에서 main.beancount을 생성하거나 기존 원장을 사용하세요. 위의 셸 명령은 POSIX 경로를 사용합니다. bea check은 Beancount 문법 및 회계를 점검하며, Fava는 추가로 자체 옵션 이름과 값을 점검합니다. Fava의 오류 보고서도 확인하세요.
아래 기본값은 설치된 FavaOptions 데이터클래스에서 읽고 버전별 옵션 파서를 기준으로 확인했습니다. “Unset”은 None을 의미하며, 빈 컬렉션은 구성된 항목이 없음을 나타냅니다. 값-유형 열은 인용된 문자열 내용 유형을 설명합니다.
| Stock option | 값 유형 | 기본값 |
|---|---|---|
language | 지원되는 번역 코드 | 설정 안 됨 |
locale | 바벨 로케일 코드 | 설정 안 됨; 핵심 render_commas이 true일 때 en이 됨 |
default-page | 상대 보고서 경로, 선택적으로 필터 포함 | income_statement/ |
fiscal-year-end | 회계 날짜 MM-DD | 12-31 |
indent | 정수 | 2 |
currency-column | 정수 | 61 |
show-closed-accounts | 불리언 | false |
show-accounts-with-zero-transactions | 불리언 | true |
show-accounts-with-zero-balance | 불리언 | true |
show-metadata-indicators | 불리언 | true |
collapse-pattern | 계정 정규식; 반복 가능 | 빈 목록 |
sidebar-show-queries | 정수 | 5 |
default-file | 파일 경로, 혹은 이 파일에 대한 생략 값 | 설정 안 됨 |
insert-entry | 계정 정규식; 반복 가능, 날짜 있는 위치 | 빈 목록 |
auto-reload | 불리언 | false |
use-external-editor | 불리언 | false |
import-config | 가져오기 구성 경로 | 설정 안 됨 |
import-dirs | 디렉토리 경로; 반복 가능 | 빈 목록 |
invert-gains-losses-colors | 불리언 | false |
invert-income-liabilities-equity | 불리언 | false |
conversion-currencies | 하나의 문자열에 공백으로 구분된 통화 코드 | 빈 튜플 |
account-journal-include-children | 불리언 | true |
uptodate-indicator-grey-lookback-days | 정수 | 60 |
upcoming-events | 정수 | 7 |
불리언의 경우 "true" 또는 "false"을 사용합니다. 비교는 대소문자를 구분하지 않습니다: "TRUE"도 옵션을 활성화합니다. "true"의 대소문자 변형이 아닌 모든 문자열은 false로 처리됩니다. 정수 파서는 양수 범위가 아닌 정수 문법을 검사하므로, 양수 레이아웃 크기와 0 이상인 개수를 사용하십시오.
표시 및 지역화
language
인터페이스 번역을 설정합니다. 예를 들면 "en", "de" 또는 "zh_CN"입니다. 설정하지 않으면 Fava가 브라우저와 협상합니다. 로케일은 Fava가 제공하는 번역을 포함해야 하며, 문법적으로 올바른 언어 코드만으로는 부족합니다.
locale
인터페이스 언어와 독립적으로 숫자 서식을 설정합니다. 예를 들어 "en_US" 또는 "de_DE"이 있습니다. 이 옵션이 없으면 Fava는 지역화되지 않은 숫자 패턴을 사용합니다. 핵심 option "render_commas" "TRUE"이 en 대체값을 제공합니다. 브라우저 언어를 상속하지 않습니다.
탐색 및 레이아웃
default-page
원장 내의 대상지를 설정합니다. 예를 들어 "balance_sheet/" 또는 "journal/?time=year"입니다. 작동 중인 Fava 재고 URL에서 원장 슬러그 이후 부분을 복사하십시오. /을 덧붙이지 마십시오: 보고서 경로는 해당 원장에 상대적입니다.
fiscal-year-end
회계 기간 필터 경계를 설정합니다. 예를 들어, "03-31"은 회계 연도를 3월 31일에 종료합니다. 회계 연도 및 분기 필터를 지원하며 거래 날짜를 변경하지 않습니다. Fava는 다음 달력 연도에 종료되는 회계 연도를 표시하기 위해 12를 초과하는 월 값을 허용합니다.
indent
생성된 분개 및 편집기 형식을 위한 분개 들여쓰기를 설정합니다. "4"과 같은 양의 정수 문자열을 사용하십시오.
currency-column
분개를 저장하거나 정렬할 때 화폐 정렬 열을 설정합니다. 또한 편집기의 세로 가이드 위치를 지정합니다. 기본값은 "61"입니다.
콘텐츠 가시성
show-closed-accounts
닫힌 계정을 보고서 계정 트리에 포함시킵니다. 잔액이 0이 아닌 계정은 이 설정과 관계없이 계속 표시됩니다.
show-accounts-with-zero-transactions
거래가 없는 계정을 계정 트리에 포함시킵니다. 잔액이 0이 아닌 계정은 숨기지 않습니다.
show-accounts-with-zero-balance
보고서 잔액이 0인 계정을 포함합니다. "false"을 사용하여 꺼서 더 짧은 트리를 만들 수 있습니다.
collapse-pattern
계정 트리에서 축소할 계정 이름과 일치시킵니다. 여러 패턴에 대해 지시문을 반복하십시오. 예를 들어, "^Assets:Investments"은 해당 계정 및 그 하위 계정을 축소합니다.
sidebar-show-queries
사이드바에 연결된 저장된 쿼리 수를 제한합니다. "0"은 해당 링크를 숨깁니다. 사용자 정의 링크 및 쿼리를 참조하십시오.
show-metadata-indicators
저널에 작은 메타데이터 배지를 표시합니다. 원장에서 메타데이터를 제거하지 않고 배지를 숨기려면 "false"으로 설정하십시오.
파일 관리
default-file
편집기가 처음 열 때 선택할 파일과 새 항목의 대체 대상지를 선택합니다. 상대 경로는 이 지시문이 포함된 파일에서 해석됩니다. 값이 없으면 포함된 파일이 선택됩니다. 이 옵션이 없으면 기본 원장 파일이 대체 대상지가 됩니다. 편집 가능한 소스가 되려면 기존 파일도 원장에 포함되어야 합니다.
insert-entry
일치하는 사용자 지정 지시문 앞에 새 항목을 삽입하며, 해당 지시문이 포함된 파일에서 삽입합니다. 정규식은 계정 이름의 시작 부분과 일치하며; 원시 파일 행을 검색하지 않습니다. Fava는 거래 게시를 마지막에서 처음까지 고려합니다. 적합한 일치 항목이 있는 첫 번째 계정에 대해 새 항목보다 엄격히 이전 날짜의 최신 규칙을 선택합니다. 일치하는 규칙이 없으면 기본 파일에 추가합니다. 이 규칙들의 권위는 삽입 구현에 있습니다.
같은 디렉터리에 이 세 파일을 생성하세요. main.beancount은 계정을 제공하며 다음과 같습니다:
; main.beancount
option "title" "Insertion Demo"
option "operating_currency" "USD"
include "january.beancount"
include "february.beancount"
2000-01-01 open Assets:Checking USD
2000-01-01 open Assets:Cash USD
2000-01-01 open Assets:Wallet USD
2000-01-01 open Expenses:Food USD
2000-01-01 custom "fava-option" "default-file"
2024-01-01 custom "fava-option" "insert-entry" "^Expenses:Food$"january.beancount에는 다음이 포함됩니다:
; january.beancount
2024-01-01 custom "fava-option" "insert-entry" "^Assets:Checking$"february.beancount에는 다음이 포함됩니다:
; february.beancount
2024-02-01 custom "fava-option" "insert-entry" "^Assets:Checking$"main.beancount으로 Fava를 시작하세요. 이 거래들을 거래 양식을 통해 추가하세요; 이들은 삽입 작업의 입력이며, 사전에 포함할 추가 파일이 아닙니다:
2024-01-15 * "January groceries"
Expenses:Food 10.00 USD
Assets:Checking -10.00 USD
2024-02-01 * "Same-day boundary"
Expenses:Food 20.00 USD
Assets:Checking -20.00 USD
2024-02-15 * "February groceries"
Expenses:Food 30.00 USD
Assets:Checking -30.00 USD
2024-02-16 * "Cash groceries"
Expenses:Food 40.00 USD
Assets:Cash -40.00 USD
2024-02-17 * "Unmatched cash transfer"
Assets:Cash 50.00 USD
Assets:Wallet -50.00 USD첫 두 항목은 1월 규칙 앞에 들어갑니다. 세 번째는 2월 규칙 앞에 들어갑니다. 네 번째는 Assets:Cash을 시도하나 일치 항목이 없어 메인 파일의 Expenses:Food 규칙을 사용합니다. 다섯 번째는 일치하는 계정 없이 main.beancount에 추가됩니다. 일괄 저장 시 항목이 삽입되면서 규칙 행 번호가 업데이트됩니다.
auto-reload
Fava가 외부 소스 변경을 감지하면 페이지를 자동으로 다시 불러옵니다. 거짓(false)일 경우 Fava는 다시 불러오기 알림을 제공합니다. Fava 자체를 통한 변경은 이미 다시 불러오기를 트리거합니다.
use-external-editor
beancount:// URL 스킴을 통해 소스 링크를 엽니다. 브라우저를 실행하는 컴퓨터에 핸들러를 설치하고 원장 파일에 접근할 수 있도록 하십시오. 이는 호스팅 서버의 파일 자동 연결이 아닙니다.
import-config
Python 가져오기(importer) 구성에 대한 참조입니다. 이것은 통합 설정으로, 구성을 생성하고 가져오기 의존성을 설치한 후 Import 보고서를 사용하십시오. 위에 고정된 세 개 패키지는 은행 가져오기 구성 제공하지 않습니다.
import-dirs
가져오기 후보를 스캔할 디렉터리를 추가합니다. 디렉터리를 추가하려면 지시문을 반복하세요. 실제 접근 가능한 디렉터리를 사용하십시오; 옵션 설정으로 디렉터리가 생성되지 않습니다.
금융 표시
unrealized
표준 Fava 1.30.16 옵션이 아닙니다. Unknown option 을 추가하면 Fava는 백틱 안에 이름과 함께 이를 보고합니다. 표준 미실현 손익 계정을 설정하는 데 사용하지 마십시오.
Beancount.io 소스 스냅샷(2026-09-07 검토)에는 백엔드 옵션 파서와 대시보드 설정 테이블에 기본값이 "Unrealized"인 unrealized이라는 별도의 문자열 필드가 노출되어 있습니다. 이는 해당 필드가 존재함을 확인시켜줍니다. 그러나 이 필드를 변경하는 것이 Income:Unrealized 또는 Expenses:Unrealized을 생성한다거나 특정 배포가 이 스냅샷을 실행한다는 것을 입증하지는 않습니다.
invert-income-liabilities-equity
손익계산서와 대차대조표에서 수입, 부채 및 자본의 표시 부호를 반전시킵니다. 비용의 부호는 유지됩니다. 분개, 계좌별 분개장 및 저장된 게시물은 변경되지 않습니다.
conversion-currencies
변환 드롭다운 선택지를 하나의 문자열 내에 공백으로 구분된 목록으로 대체합니다:
; Conversion dropdown
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"이 옵션을 반복 적용하면 이전 목록을 대체합니다. 설정하지 않으면 Fava는 운영 통화와 ISO 4217 통화로 인식되는 상품을 제공합니다.
account-journal-include-children
기본적으로 하위 계좌 항목을 계좌별 분개장에 포함합니다. "false"으로 설정하면 처음부터 해당 계좌만 표시합니다.
invert-gains-losses-colors
시장 가치 대차대조표 및 시산표 뷰에서 미실현 손익의 색상을 반전시킵니다. 금액이나 계좌명은 변경하지 않고 색상만 변경합니다.
모니터링
uptodate-indicator-grey-lookback-days
회색 신선도 표시기의 조회 기간을 제어합니다. 계좌의 open 지시문에 fava-uptodate-indication: TRUE을 설정하여 계좌 표시기를 활성화하십시오; UI 메타데이터 예제을 참조하세요.
upcoming-events
지정된 일수 이내의 예정된 이벤트에 대한 사이드바 알림 수를 제어합니다. "0"은 카운트를 비활성화합니다.
권장 구성
이 전체 구성은 위 기본 환경을 위한 시작점입니다. 플러그인 로드나 추가 파일 없이 표시 설정만 변경합니다:
option "operating_currency" "USD"
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "locale" "en_US"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
2000-01-01 custom "fava-option" "fiscal-year-end" "12-31"
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" "show-accounts-with-zero-transactions" "true"
2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"
2000-01-01 custom "fava-option" "show-metadata-indicators" "true"
2000-01-01 custom "fava-option" "collapse-pattern" "^Assets:Investments"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
2000-01-01 custom "fava-option" "auto-reload" "false"
2000-01-01 custom "fava-option" "use-external-editor" "false"
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
2000-01-01 custom "fava-option" "invert-gains-losses-colors" "false"
2000-01-01 custom "fava-option" "conversion-currencies" "USD EUR"
2000-01-01 custom "fava-option" "account-journal-include-children" "true"
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"현재 옵션 보기
기본 Fava에서 릴리스 설치에 대한 참조를 위해 도움말 → 옵션 페이지를 열고 지시문 변경 후 오류를 확인하세요. 공식 1.30.16 옵션 도움말이 설정을 설명합니다.
Beancount.io 대시보드에서 원장 설정 페이지를 엽니다. Fava 옵션 테이블은 백엔드가 반환하는 하위 집합을 보여줍니다. 이 UI는 제품 소스 스냅샷에서 검증되었으며, 인증된 운영 세션에서는 아닙니다. 표시된 필드가 기본 Fava 편집기, 가져오기 또는 URL 경로를 구현함을 의미하지는 않습니다.