hledger-*: add short/long options and subcommands (#21426)

* hledger-*: add short/long options and subcommands * Update hledger-balance.md Co-authored-by: Darío Hereñú <magallania@gmail.com> --------- Co-authored-by: Darío Hereñú <magallania@gmail.com>
2026-08-28 20:11:19 +08:00 · 2026-03-10 23:10:58 -07:00
parent fdd2fa59e5
commit bbf87c05d3
13 changed files with 60 additions and 60 deletions
@@ -9,7 +9,7 @@

 - Añade transacciones a `2024.journal`, pero también carga `2023.journal` para su completado:

-`hledger add --file {{ruta/a/2024.journal}} --file {{ruta/a/2023.journal}}`
+`hledger add {{[-f|--file]}} {{ruta/a/2024.journal}} {{[-f|--file]}} {{ruta/a/2023.journal}}`

 - Provee respuestas a las primeras 4 preguntas:

@@ -17,7 +17,7 @@

 - Muestra la documentación y opciones de `add` usando `$PAGER`:

-`hledger add --help`
+`hledger add {{[-h|--help]}}`

 - Muestra la documentación de `add` usando `info` o `man` de estar disponibles:

@@ -6,32 +6,32 @@

 - Muestra el cambio de saldo en todas las cuentas de todas las contabilizaciones a lo largo de todo el tiempo:

-`hledger balance`
+`hledger {{[bal|balance]}}`

 - Muestra el cambio de saldo en las cuentas denominadas `*gastos*`, como un árbol, resumiendo solo los dos niveles superiores:

-`hledger balance {{gastos}} --tree --depth {{2}}`
+`hledger {{[bal|balance]}} {{gastos}} {{[-t|--tree]}} {{[-2|--depth 2]}}`

 - Muestra los gastos de cada mes, y sus totales y medias, ordenados por total; y sus objetivos presupuestarios mensuales:

-`hledger balance {{gastos}} --monthly --row-total --average --sort-amount --budget`
+`hledger {{[bal|balance]}} {{gastos}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} {{[-S|--sort-amount]}} --budget`

 - Similar a la anterior, de forma más corta, comparando las cuentas por tipo de `Gastos`, como un árbol de dos niveles sin aplastar las cuentas aburridas:

-`hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide`
+`hledger {{[bal|balance]}} type:{{X}} {{[-MTAS|--monthly --row-total --average --sort-amount]}} --budget {{[-t|--tree]}} {{[-2|--depth 2]}} --no-elide`

 - Muestra saldos finales (incluidos los de contabilizaciones anteriores a la fecha de inicio), trimestrales en 2024, en cuentas denominadas `*activos*` o `*pasivos*`:

-`hledger balance --historical --period '{{trimestral en 2024}}' {{activos}} {{pasivos}}`
+`hledger {{[bal|balance]}} {{[-H|--historical]}} {{[-p|--period]}} '{{trimestral en 2024}}' {{activos}} {{pasivos}}`

- Similar al anterior, de un modo más breve; también muestra saldos en cero, ordena por total y resume a tres niveles:
+- Similar a la anterior, de un modo más breve; también muestra saldos en cero, ordena por total y resume a tres niveles:

-`hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}`
+`hledger {{[bal|balance]}} {{[-HQ|--historical --quarterly]}} date:{{2024}} type:{{AL}} {{[-ES|--empty --sort-amount]}} {{[-3|--depth 3]}}`

 - Muestra el valor de mercado de los activos de inversión en moneda base al final de cada trimestre:

-`hledger bal -HVQ {{activos:inversiones}}`
+`hledger {{[bal|balance]}} {{[-HVQ|--historical --market --quarterly]}} {{activos:inversiones}}`

 - Muestra las ganancias/pérdidas de capital no realizadas por cambios en el precio de mercado en cada trimestre, para activos de inversión que no sean criptomonedas:

-`hledger bal --gain -Q {{activos:inversiones}} not:{{criptomoneda}}`
+`hledger {{[bal|balance]}} --gain {{[-Q|--quarterly]}} {{activos:inversiones}} not:{{criptomoneda}}`
@@ -14,24 +14,24 @@

 - Imprime todas las transacciones, leyendo múltiples archivos de diario específicos:

-`hledger print --file {{ruta/a/precios-2024.journal}} --file {{ruta/a/precios-2023.journal}}`
+`hledger print {{[-f|--file]}} {{ruta/a/precios-2024.journal}} {{[-f|--file]}} {{ruta/a/precios-2023.journal}}`

 - Muestra todas las cuentas, como jerarquía, y sus tipos:

-`hledger accounts --tree --types`
+`hledger accounts {{[-t|--tree]}} --types`

 - Muestra saldos de cuenta de activos y pasivos, incluyendo ceros, jerárquicamente:

-`hledger balancesheet --empty --tree --no-elide`
+`hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}} --no-elide`

 - Muestra ingresos/gastos/totales mensuales, los más grandes primero, resumido a 2 niveles:

-`hledger incomestatement --monthly --row-total --average --sort --depth 2`
+`hledger {{[is|incomestatement]}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} --sort {{[-2|--depth 2]}}`

 - Muestra las transacciones de la cuenta `assets:bank:checking` y su saldo actual:

-`hledger aregister assets:bank:checking`
+`hledger {{[areg|aregister]}} assets:bank:checking`

 - Muestra el monto gastado en comida desde la cuenta `assets:cash`:

-`hledger print assets:cash | hledger -f- -I aregister expenses:food`
+`hledger print assets:cash | hledger {{[-f|--file]}} - {{[-I|--ignore-assertions]}} aregister expenses:food`
@@ -9,7 +9,7 @@

 - `2024.journal`에 거래를 추가하되, 자동 완성을 위해 `2023.journal`도 로드:

-`hledger add --file {{경로/대상/2024.journal}} --file {{경로/대상/2023.journal}}`
+`hledger add {{[-f|--file]}} {{경로/대상/2024.journal}} {{[-f|--file]}} {{경로/대상/2023.journal}}`

 - 처음 네 개의 프롬프트에 대한 답변 제공:

@@ -17,7 +17,7 @@

 - `$PAGER`로 `add`의 옵션 및 문서 보기:

-`hledger add --help`
+`hledger add {{[-h|--help]}}`

 - 사용 가능하면 `info` 또는 `man`으로 `add`의 문서 보기:

@@ -5,16 +5,16 @@

 - `assets:bank:checking` 계좌의 거래 내역과 잔액 표시:

-`hledger aregister assets:bank:checking`
+`hledger {{[areg|aregister]}} assets:bank:checking`

 - `*savings*`라는 이름의 첫 번째 계좌의 거래 내역과 잔액 표시:

-`hledger aregister savings`
+`hledger {{[areg|aregister]}} savings`

 - 지정된 너비로 체크 계좌의 정리된 거래 내역 표시:

-`hledger aregister checking --cleared --width {{120}}`
+`hledger {{[areg|aregister]}} checking {{[-C|--cleared]}} {{[-w|--width]}} {{120}}`

 - 예측 규칙의 거래를 포함하여 체크 계좌의 내역 표시:

-`hledger aregister checking --forecast`
+`hledger {{[areg|aregister]}} checking --forecast`
@@ -6,32 +6,32 @@

 - 모든 시간 동안 모든 계좌의 모든 기입에서 잔액 변화를 표시:

-`hledger balance`
+`hledger {{[bal|balance]}}`

 - `*expenses*`로 명명된 계정에서, 상위 두 수준만 요약하여 트리 형태로 잔액 변화를 표시:

-`hledger balance {{expenses}} --tree --depth {{2}}`
+`hledger {{[bal|balance]}} {{expenses}} {{[-t|--tree]}} {{[-2|--depth 2]}}`

 - 매월 비용, 총계 및 평균을 표시하고, 총계로 정렬하며 월간 예산 목표 포함:

-`hledger balance {{expenses}} --monthly --row-total --average --sort-amount --budget`
+`hledger {{[bal|balance]}} {{expenses}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} {{[-S|--sort-amount]}} --budget`

 - 위와 유사하지만, `Expense` 유형으로 계정을 일치시키고, 지루한 계정을 생략하지 않고 두 개의 수준 트리로 표시:

-`hledger bal type:{{X}} -MTAS --budget -t -{{2}} --no-elide`
+`hledger {{[bal|balance]}} type:{{X}} {{[-MTAS|--monthly --row-total --average --sort-amount]}} --budget {{[-t|--tree]}} {{[-2|--depth 2]}} --no-elide`

 - 종료 잔액을 2024년 분기별로, `*assets*` 또는 `*liabilities*`로 명명된 계정에서 표시 (시작일 이전의 기입 포함):

-`hledger balance --historical --period '{{quarterly in 2024}}' {{assets}} {{liabilities}}`
+`hledger {{[bal|balance]}} {{[-H|--historical]}} {{[-p|--period]}} '{{quarterly in 2024}}' {{assets}} {{liabilities}}`

 - 위와 유사하지만, 0 잔액도 표시하고, 총계로 정렬하여 세 개의 수준으로 요약:

-`hledger bal -HQ date:{{2024}} type:{{AL}} -ES -{{3}}`
+`hledger {{[bal|balance]}} {{[-HQ|--historical --quarterly]}} date:{{2024}} type:{{AL}} {{[-ES|--empty --sort-amount]}} {{[-3|--depth 3]}}`

 - 각 분기 말에 기본 통화로 투자 자산의 시장 가치를 표시:

-`hledger bal -HVQ {{assets:investments}}`
+`hledger {{[bal|balance]}} {{[-HVQ|--historical --market --quarterly]}} {{assets:investments}}`

 - 암호화폐가 아닌 투자 자산에 대한 각 분기의 시장 가격 변동으로 인한 미실현 자본 이득/손실 표시:

-`hledger bal --gain -Q {{assets:investments}} not:{{cryptocurrency}}`
+`hledger {{[bal|balance]}} --gain {{[-Q|--quarterly]}} {{assets:investments}} not:{{cryptocurrency}}`
@@ -6,28 +6,28 @@

 - 0을 제외한 `자산` 및 `부채` 계정의 현재 잔액 표시:

-`hledger balancesheet`
+`hledger {{[bs|balancesheet]}}`

 - 유동 자산(`현금` 계정 유형)만 표시:

-`hledger balancesheet type:C`
+`hledger {{[bs|balancesheet]}} type:C`

 - 0 잔액의 계정을 포함하고 계정 계층 구조 표시:

-`hledger balancesheet --empty --tree`
+`hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}}`

 - 매월 말 잔액 표시:

-`hledger balancesheet --monthly`
+`hledger {{[bs|balancesheet]}} {{[-M|--monthly]}}`

 - 매월 말 잔액의 시장 가치를 홈 통화로 표시:

-`hledger balancesheet --monthly -V`
+`hledger {{[bs|balancesheet]}} {{[-M|--monthly]}} {{[-V|--market]}}`

 - 분기별 잔액을 계정 계층 구조의 상위 두 레벨만 표시:

-`hledger balancesheet --quarterly --tree --depth 2`
+`hledger {{[bs|balancesheet]}} {{[-Qt|--quarterly --tree]}} {{[-2|--depth 2]}}`

 - 위의 명령의 간단한 형태로 `bs.html`에서 HTML 출력 생성:

-`hledger bs -Qt -2 -o bs.html`
+`hledger {{[bs|balancesheet]}} {{[-Qt|--quarterly --tree]}} {{[-2|--depth 2]}} {{[-o|--output-file]}} bs.html`
@@ -17,7 +17,7 @@

 - `bank.csv.rules`를 편집하면서 변환 오류 또는 결과 보기:

-`watchexec -- hledger -f {{경로/대상/은행.csv}} print`
+`watchexec -- hledger {{[-f|--file]}} {{경로/대상/은행.csv}} print`

 - `bank.csv`의 현재 데이터를 이미 가져온 것으로 표시:

@@ -25,4 +25,4 @@

 - `bank.csv`를 모두 새로 가져온 것으로 표시:

-`rm -f .latest.bank.csv`
+`rm {{[-f|--force]}} .latest.bank.csv`
@@ -6,16 +6,16 @@

 - 수익과 비용(수익 및 비용 계정의 변화) 표시:

-`hledger incomestatement`
+`hledger {{[is|incomestatement]}}`

 - 매월 수익과 비용 표시:

-`hledger incomestatement --monthly`
+`hledger {{[is|incomestatement]}} {{[-M|--monthly]}}`

 - 매월 수익/비용/총액을 가장 큰 것부터 두 단계로 요약하여 표시:

-`hledger incomestatement --monthly --row-total --average --sort --depth 2`
+`hledger {{[is|incomestatement]}} {{[-MTAS|--monthly --row-total --average --sort-amount]}} {{[-2|--depth 2]}}`

 - 위 명령의 단축형으로, `is.html`에 HTML 출력 생성:

-`hledger is -MTAS -2 -o is.html`
+`hledger {{[is|incomestatement]}} {{[-MTAS|--monthly --row-total --average --sort-amount]}} {{[-2|--depth 2]}} {{[-o|--output-file]}} is.html`
@@ -9,11 +9,11 @@

 - 암시된 금액이나 비용을 명시적으로 하여 거래 표시:

-`hledger print --explicit --infer-costs`
+`hledger print {{[-x|--explicit]}} --infer-costs`

 - 두 개의 지정된 파일에서 거래를 표시하고, 금액을 비용으로 변환:

-`hledger print --file {{경로/대상/2023.journal}} --file {{경로/대상/2024.journal}} --cost`
+`hledger print {{[-f|--file]}} {{경로/대상/2023.journal}} {{[-f|--file]}} {{경로/대상/2024.journal}} {{[-B|--cost]}}`

 - 이번 달 `*food*` 계좌의 `$` 거래를 표시하되, `*groceries*` 계좌는 제외:

@@ -25,8 +25,8 @@

 - `EUR` 금액을 소수점 콤마로 반올림하여 입금된 거래 표시:

-`hledger print --cleared --commodity '1000, EUR' --round hard`
+`hledger print {{[-C|--cleared]}} --commodity '1000, EUR' --round hard`

 - `foo.journal`의 거래를 CSV 파일로 작성:

-`hledger print --file {{경로/대상/foo.journal}} --output-file {{경로/대상/output_file.csv}}`
+`hledger print {{[-f|--file]}} {{경로/대상/foo.journal}} {{[-o|--output-file]}} {{경로/대상/output_file.csv}}`
@@ -13,15 +13,15 @@

 - 대차대조표 계정 화면에서 시작하고, 계층 구조를 3단계까지 표시:

-`hledger-ui --bs --tree --depth 3`
+`hledger-ui --bs {{[-t|--tree]}} {{[-3|--depth 3]}}`

 - 이 계정의 화면에서 시작하고, 정리된 거래를 표시하며 변경 시 다시 로드:

-`hledger-ui --register {{assets:bank:checking}} --cleared --watch`
+`hledger-ui --register {{assets:bank:checking}} {{[-C|--cleared]}} {{[-w|--watch]}}`

 - 두 개의 저널 파일을 읽고, 알려진 경우 현재 가치로 금액을 표시:

-`hledger-ui --file {{경로/대상/2024.journal}} --file {{경로/대상/2024-prices.journal}} --value now`
+`hledger-ui {{[-f|--file]}} {{경로/대상/2024.journal}} {{[-f|--file]}} {{경로/대상/2024-prices.journal}} --value now`

 - 가능한 경우 Info 형식으로 매뉴얼 표시:

@@ -29,4 +29,4 @@

 - 도움말 표시:

-`hledger-ui --help`
+`hledger-ui {{[-h|--help]}}`
@@ -9,7 +9,7 @@

 - 위와 동일하지만, 특정 파일을 지정하고 기존 데이터 편집 허용:

-`hledger-web --file {{경로/대상/파일.journal}} --allow edit`
+`hledger-web {{[-f|--file]}} {{경로/대상/파일.journal}} --allow edit`

 - 웹 앱만 시작하고, 지정된 호스트와 포트에서 들어오는 연결 수락:

@@ -29,4 +29,4 @@

 - 도움말 표시:

-`hledger-web --help`
+`hledger-web {{[-h|--help]}}`
@@ -14,24 +14,24 @@

 - 여러 지정된 저널 파일에서 모든 거래를 출력:

-`hledger print --file {{경로/대상/prices-2024.journal}} --file {{경로/대상/prices-2023.journal}}`
+`hledger print {{[-f|--file]}} {{경로/대상/prices-2024.journal}} {{[-f|--file]}} {{경로/대상/prices-2023.journal}}`

 - 계정과 그 유형을 계층 구조로 모두 표시:

-`hledger accounts --tree --types`
+`hledger accounts {{[-t|--tree]}} --types`

 - 자산 및 부채 계정 잔액을 0을 포함하여 계층적으로 표시:

-`hledger balancesheet --empty --tree --no-elide`
+`hledger {{[bs|balancesheet]}} {{[-E|--empty]}} {{[-t|--tree]}} --no-elide`

 - 월별 수입/지출/총액을 가장 큰 것부터 2단계로 요약하여 표시:

-`hledger incomestatement --monthly --row-total --average --sort --depth 2`
+`hledger {{[is|incomestatement]}} {{[-M|--monthly]}} {{[-T|--row-total]}} {{[-A|--average]}} --sort {{[-2|--depth 2]}}`

 - `assets:bank:checking` 계정의 거래 및 진행 중인 잔액을 표시:

-`hledger aregister assets:bank:checking`
+`hledger {{[areg|aregister]}} assets:bank:checking`

 - `assets:cash` 계정에서 음식에 소비한 금액을 표시:

-`hledger print assets:cash | hledger -f- -I aregister expenses:food`
+`hledger print assets:cash | hledger {{[-f|--file]}} - {{[-I|--ignore-assertions]}} aregister expenses:food`