날짜가 지정된 custom "fava-option" 지시문으로 기본 Fava를 구성하세요. 이러한 설정은 Beancount 핵심 옵션과 별개입니다.
이 참고 자료는 Beancount 3.2.3, beanquery 0.2.0 및 Fava 1.30.16에서 실행되었습니다. 매트릭스는 해당 릴리스를 설명합니다. Beancount.io는 별도의 대시보드와 백엔드를 가지고 있습니다. 노출된 설정이 모든 기본 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 'beancount==3.2.3' 'beanquery==0.2.0' 'fava==1.30.16'
source .venv-fava-docs/bin/activate
bean-check main.beancount
fava main.beancount먼저 구성 블록에서 main.beancount 파일을 만들거나 기존 원장을 사용하세요. 위의 셸 명령은 POSIX 경로를 사용합니다. bean-check는 Beancount 구문과 회계를 확인합니다. Fava는 추가로 자체 옵션 이름과 값을 확인합니다. Fava의 오류 보고서도 검사하세요.
아래 기본값은 설치된 FavaOptions 데이터클래스에서 읽었으며 버전별 옵션 파서와 비교 확인했습니다. “설정되지 않음”은 None을 의미합니다. 빈 컬렉션은 구성된 항목이 없음을 의미합니다. 값 유형 열은 따옴표로 묶인 문자열의 내용을 설명합니다.
| 기본 옵션 | 값 유형 | 기본값 |
|---|---|---|
language | 지원되는 번역 코드 | 설정되지 않음 |
locale | Babel 로케일 코드 | 설정되지 않음, 핵심 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로 처리됩니다. 정수 파서는 정수 구문을 확인하며 양수 범위는 확인하지 않습니다. 양수 레이아웃 크기와 음수가 아닌 개수를 사용하세요.
표시 및 지역화
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 가져오기 도구 구성 파일을 가리킵니다. 이는 통합 설정입니다. 가져오기 보고서를 사용하기 전에 구성을 만들고 가져오기 도구 종속성을 설치하세요. 위의 세 가지 고정 패키지는 은행 가져오기 도구 구성을 제공하지 않습니다.
import-dirs
가져오기 후보를 검색할 디렉터리를 추가합니다. 디렉터리를 추가하려면 지시문을 반복하세요. 실제로 액세스 가능한 디렉터리를 사용하세요. 옵션을 설정해도 디렉터리가 생성되지는 않습니다.
재무 표시
unrealized
기본 Fava 1.30.16 옵션이 아닙니다. 추가하면 Fava가 백틱으로 이름을 표시하는 Unknown option 을 보고합니다. 기본 미실현 손익 계정을 구성하는 데 사용하지 마세요.
2026-09-07에 검토된 Beancount.io 소스 스냅샷은 백엔드 옵션 파서 및 대시보드 설정 테이블에서 기본값이 "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 경로를 구현한다는 것을 의미하지는 않습니다.