نام (NAME)

ledger — ابزار گزارش‌گیری حسابداری دوبل خط فرمان

خلاصه دستور (SYNOPSIS)

ledger [options] [command] [arguments]

توضیحات (DESCRIPTION)

ledger یک ابزار حسابداری خط فرمان مبتنی بر توانمندی و جامعیت حسابداری دوبل (دفترداری دوطرفه) است. این برنامه صرفاً یک ابزار گزارش‌گیری است، به این معنی که هرگز فایل‌های داده‌های شما را تغییر نمی‌دهد، اما مجموعه گسترده‌ای از گزارش‌ها و روش‌های گوناگون را برای سفارشی‌سازی آن‌ها مطابق با نیازهایتان فراهم می‌سازد.

دستورات (COMMANDS)

ledger چندین دستور سطح‌بالا را می‌پذیرد که هر یک نوع متفاوتی از گزارش‌های پایه را تولید می‌کنند. بیشتر آن‌ها یک آرگومان report-query را به منظور تعیین مواردی که باید گزارش شوند، دریافت می‌کنند. برای درک نحو یک report-query ، بخش QUERIES را ببینید. در ابتدایی‌ترین حالت، تنها مشخص کردن یک یا چند رشته به‌سادگی گزارشی برای تمامی حساب‌های حاوی آن رشته‌ها تولید می‌کند.

اگر هیچ دستوری داده نشود، ledger وارد یک REPL یا حلقه فرمان می‌شود که امکان اجرای چندین دستور روی یک مجموعه داده بدون نیاز به تجزیه مجدد را فراهم می‌سازد.

فهرست زیر مجموعه‌ای کامل از دستورات گزارش‌گیری پذیرفته‌شده است:

accounts [report-query]

فهرست کردن تمام حساب‌ها برای ثبت‌هایی که با report-query مطابقت دارند.

balance [report-query]

چاپ یک گزارش ترازنامه که مجموع مبالغ را برای ثبت‌های منطبق بر report-query و مجموع تجمیعی را برای حساب‌های والد آن حساب‌ها نشان می‌دهد. گزینه‌هایی که بیشتر همراه با این دستور استفاده می‌شوند عبارتند از:

--basis (-B)

گزارش بر حسب بهای تمام‌شده پایه، نه مبلغ یا ارزش. این تنها نوع گزارشی است که وقتی هیچ report-query مشخص نشده باشد، تضمین می‌شود همیشه به صفر تراز شود. تنها نمایش مجموع‌ها برای بالاترین حساب‌ها.

--empty (-E)

نمایش حساب‌هایی که مجموع آن‌ها صفر است.

--flat

به جای نمایش یک درخت سلسله‌مراتبی، گزارش را مسطح می‌کند تا جمع‌های جزئی را تنها برای حساب‌های منطبق بر report-query نشان دهد.

--no-total

حذف مجموع کل خلاصه که در پایین گزارش نشان داده می‌شود.

مترادف‌های bal و b نیز پذیرفته می‌شوند.

budget [report-query]

یک گزارش تراز ویژه که شامل سه ستون اضافی است: مبلغ بودجه‌بندی‌شده در طول دوره گزارش، میزان تفاوت هزینه‌کرد با بودجه، و درصد بودجه صرف‌شده (اگر از بودجه فراتر روید از ۱۰۰٪ بیشتر می‌شود). توجه داشته باشید که بودجه‌بندی نیازمند تعریف یک یا چند “تراکنش دوره‌ای” در فایل(های) داده شماست. برای اطلاعات بیشتر به کتابچه راهنما مراجعه کنید.

cleared [report-query]

یک گزارش تراز ویژه که دو ستون اضافی می‌افزاید: مانده تسویه‌شده برای هر حساب، و تاریخ جدیدترین ثبت تسویه‌شده در آن حساب. برای اینکه این حسابداری معنادار باشد، پرچم تسویه باید حداقل روی یک ثبت تنظیم شده باشد. برای اطلاعات بیشتر به کتابچه راهنما مراجعه کنید.

commodities [report-query]

فهرست کردن تمام کالاها (ارزها و دارایی‌ها) برای ثبت‌های منطبق بر report-query.

convert

خواندن داده‌ها از یک فایل CSV (مقادیر جداشده با کاما) و تولید تراکنش‌های ledger.

csv [report-query]

گزارش ثبت‌های منطبق بر report-query در قالب CSV (مقادیر جداشده با کاما). مناسب برای برون‌بری داده‌ها به یک صفحه گسترده جهت تحلیل بیشتر یا نمودارکشی.

entry [entry-template]

تولید و نمایش یک تراکنش جدید با قالب‌بندی درست در ledger از طریق مقایسه entry-template با تراکنش‌های موجود در فایل(های) داده شما. برای اطلاعات بیشتر در خصوص الگوهای پیش‌نویس و استفاده از این دستور برای ایجاد سریع تراکنش‌های جدید، بخش ENTRIES را ببینید.

مترادف xact نیز پذیرفته می‌شود.

emacs [query]

خروجی دادن داده‌های ثبت و تراکنش در قالبی که به سادگی توسط ویرایشگر Emacs قابل استفاده باشد، در قالب مجموعه‌ای از ساختارهای Lisp. این دستور توسط حالت ledger-mode در Emacs برای پردازش داده‌های گزارش از ledger استفاده می‌شود.

equity [report-query]

چاپ یک تراکنش با مجموعه‌ای از ثبت‌ها که مجموع‌های جاری حساب‌های منطبق بر report-query را در یک حساب ویژه به نام Equity:Opening Balances تراز می‌کند. هدف این گزارش بستن حساب‌ها برای سال قبل است، در حالی که از این ثبت‌های حقوق صاحبان سهام (سرمایه) برای انتقال آن مانده‌ها به دوره بعد استفاده می‌شود.

payees [report-query]

فهرست کردن تمام طرف‌های حساب (دریافت‌کنندگان/پرداخت‌کنندگان) برای ثبت‌های منطبق بر report-query.

pricemap

تولید فایلی که می‌تواند برای ساخت یک نمودار با ابزار graphviz جهت نمایش رابطه میان کالاها/ارزها در فایل ledger استفاده شود.

prices [report-query]

گزارش قیمت‌ها برای تمامی کالاها/ارزها در ثبت‌های منطبق بر report-query. قیمت‌ها با تفکیک یک روز منفرد گزارش می‌شوند.

pricedb [report-query]

گزارش قیمت‌ها برای تمامی کالاها/ارزها در ثبت‌های منطبق بر report-query. قیمت‌ها با تفکیک ثانیه و با استفاده از همان قالب فایل ~/.pricedb گزارش می‌شوند.

print [report-query]

چاپ کامل تراکنش‌های هر یک از ثبت‌های منطبق با همان قالبی که در یک فایل داده ظاهر می‌شوند. این می‌تواند برای استخراج زیرمجموعه‌هایی از یک فایل ledger جهت انتقال به فایل‌های دیگر استفاده شود.

push [options]

در محیط REPL ، قراردادن مجموعه‌ای از options خط فرمان در پشته، تا بر تمامی گزارش‌های بعدی اعمال شوند.

pop

در محیط REPL ، برداشتن تنظیمات گزینه‌هایی که پیش‌تر با push اعمال شده بودند.

register [report-query]

فهرست کردن تمام ثبت‌های منطبق بر report-query. این یکی از رایج‌ترین دستورات است و می‌تواند برای ارائه انواع گزارش‌های مفید استفاده شود. گزینه‌هایی که بیشتر همراه با این دستور استفاده می‌شوند عبارتند از:

--average (-A)

نمایش میانگین متحرک، به جای مجموع متحرک.

--current (-c)

عدم نمایش ثبت‌های فراتر از روز جاری.

--exchange "COMMODITY [, COMMODITY, ...]" (-X)

ارائه تمامی مقادیر بر حسب commodity مشخص‌شده، در صورتی که نرخ تبدیل قیمت قابل تعیین باشد. اگر چند کالا/ارز مشخص شوند، مقادیر مربوط به ارزهای فهرست‌شده به همان صورت باقی می‌مانند و سایرین در نخستین ارز فهرست‌شده‌ای که قابل تبدیل به آن باشند نمایش داده می‌شوند. نرخ‌ها همواره نسبت به تاریخ ثبتی که برای آن محاسبه می‌شوند نمایش می‌یابند. این بدان معناست که یک گزارش register یک گزارش ارزش تاریخی است. برای ارزش‌های جاری، شاید ترجیح داده شود از گزارش balance استفاده شود.

--gain (-G)

نمایش هرگونه سود (یا زیان) در ارزش کالاها/ارزها در طول زمان.

--head number

فقط نمایش به تعداد number از ثبت‌های ابتدایی.

--historical (-H)

ارزش‌گذاری کالاها/ارزها در زمان تحصیل آن‌ها.

--invert

معکوس کردن علامت مبالغ نمایش‌داده‌شده.

--market (-V)

نمایش ارزش‌های جاری بازار برای تمام مبالغ. این مقدار به روشی تا حدی شگفت‌انگیز تعیین می‌شود. احتمالاً استفاده از گزینه --exchange سرراست‌تر است.

--period time-period (-p)

نمایش ثبت‌ها تنها برای time-period مشخص‌شده.

--related (-r)

نمایش ثبت‌هایی که با موارد نمایش‌داده‌شده مرتبط هستند. این گزینه اثر نمایش "طرف دیگر" ثبت‌ها را دارد.

--sort value-expression (-S)

مرتب‌سازی ثبت‌ها با ارزیابی value-expression داده‌شده. توجه داشته باشید که فهرستی از عبارت‌های جداشده با کاما مجاز است، که در این حالت هر عبارت مرتب‌سازی به نوبت برای تعیین ترتیب نهایی استفاده می‌شود. برای مثال برای جستجو بر اساس تاریخ و سپس مبلغ:

ledger reg --sort 'date, amount'

ترتیب مرتب‌سازی را می‌توان با علامت '-' کنترل کرد. برای مثال برای مرتب‌سازی برعکس زمانی:

ledger reg --sort '-date'

--tail number

فقط نمایش به تعداد number از آخرین ثبت‌ها.

--uncleared (-U)

فقط نمایش ثبت‌های تسویه‌نشده (یعنی اخیر).

همچنین چندین گزینه گروه‌بندی وجود دارد که می‌توانند مفید باشند:

--by-payee (-P)

گروه‌بندی ثبت‌ها بر اساس نام مشترک دریافت‌کنندگان وجه (طرف‌های حساب).

--daily (-D)

گروه‌بندی ثبت‌ها بر اساس روز.

--weekly (-W)

گروه‌بندی ثبت‌ها بر اساس هفته (شروع از یکشنبه‌ها).

--start-of-week day

تنظیم روز شروع هر گزارش گروه‌بندی‌شده بر اساس هفته به day مشخص‌شده.

--monthly (-M)

گروه‌بندی ثبت‌ها بر اساس ماه.

--quarterly

گروه‌بندی ثبت‌ها بر اساس فصل مالی.

--yearly (-Y)

گروه‌بندی ثبت‌ها بر اساس سال.

--days-of-week

گروه‌بندی ثبت‌ها بر پایه روزی از هفته که در آن رخ داده‌اند.

--subtotal (-s)

گروه‌بندی تمام ثبت‌ها با یکدیگر. این بسیار شبیه به مجموع‌های نشان‌داده‌شده در گزارش balance است.

مترادف‌های reg و r نیز پذیرفته می‌شوند.

select [sql-query]

فهرست کردن تمام ثبت‌های منطبق بر sql-query. این دستور امکان تولید پرس‌وجوهای شبیه به SQL را فراهم می‌کند، مثلاً:

ledger select date,amount from posts where account=~/Income/

source

تجزیه فایل دفتر روزنامه و بررسی آن برای یافتن خطاها. ledger در صورتی که خطایی یافت نشود، وضعیت موفقیت بازمی‌گرداند.

stats [report-query]

ارائه اطلاعات خلاصه درباره تمام ثبت‌های منطبق بر report-query. این دستور اطلاعاتی از قبیل موارد زیر را فراهم می‌آورد:

• بازه زمانی تمامی ثبت‌های منطبق
• طرف‌های حساب منحصربه‌فرد
• حساب‌های منحصربه‌فرد
• مجموع ثبت‌ها
• ثبت‌های تسویه‌نشده
• روزهای گذشته از آخرین ثبت
• ثبت‌های ۷ روز گذشته
• ثبت‌های ۳۰ روز گذشته
• ثبت‌های این ماه

xml [report-query]

خروجی دادن داده‌های مربوط به گزارش جاری در قالب XML. این شامل تمامی حساب‌ها و کالاهای دخیل در گزارش، به همراه ثبت‌ها و تراکنش‌های دربرگیرنده آن‌هاست. برای اطلاعات بیشتر به کتابچه راهنما مراجعه کنید.

گزینه‌ها (OPTIONS)

--abbrev-len INT

حداقل طولی را که نام یک حساب در صورت جا نشدن در account-width می‌تواند به آن خلاصه شود، تعیین می‌کند. اگر INT صفر باشد، نام حساب از سمت راست بریده می‌شود. اگر INT بزرگتر از account-width باشد، نام حساب از سمت چپ بریده خواهد شد، بدون اینکه هیچ کوتاه‌سازی در نام‌های حساب‌ها به منظور جا شدن در عرض مورد نظر اعمال شود.

--account EXPR

افزودن EXPR به ابتدای تمامی حساب‌های گزارش‌شده. به این معنا که گزینه --account "'Personal'" عبارت Personal: را اضافه می‌کند و --account "tag('VAT')" مقدار برچسب VAT را به ابتدای هر حسابی که در یک گزارش balance یا register گزارش شده است الصاق می‌کند.

--account-width INT

تعیین عرض ستون حساب در گزارش register به میزان INT کاراکتر.

--actual (-L)

گزارش تنها تراکنش‌های واقعی، بدون استفاده از تراکنش‌های خودکار یا مجازی.

--add-budget

تنها نمایش ثبت‌های بودجه‌بندی‌نشده.

--align-intervals

استفاده از ابتدای دوره گزارش به عنوان شروع بازه‌ها، به جای ابتدای هفته، ماه، فصل یا سال.

--amount EXPR (-t)

اعمال عبارت مقداری داده‌شده بر مبلغ ثبت. با استفاده از --amount EXPR می‌توانید یک تبدیل دلخواه را روی ثبت‌ها اعمال کنید.

--amount-data (-j)

در یک گزارش register تنها تاریخ‌ها و مبلغ ثبت‌ها را چاپ می‌کند. برای برنامه‌های نمودارکشی و صفحات گسترده مفید است.

--amount-width INT

تعیین عرض ستون مبلغ در گزارش register بر حسب تعداد کاراکتر.

--anon

ناشناس‌سازی خروجی دفتر روزنامه، عمدتاً برای ارسال در گزارش خطاها (باگ‌ها).

--ansi

استفاده از رنگ در صورتی که ترمینال از آن پشتیبانی کند. نام مستعار برای --color.

--args-only

نادیده گرفتن فایل‌های پیکربندی آغازین و متغیرهای محیطی برای اجرای ledger.

--auto-match

هنگام تولید یک تراکنش ledger از یک فایل CSV با استفاده از دستور convert ، به طور خودکار حسابی از دفتر روزنامه Ledger تطبیق داده شود.

--aux-date

نمایش تاریخ‌های کمکی برای تمامی محاسبات. نام مستعار برای --effective.

--average (-A)

چاپ مقادیر میانگین بر حسب تعداد تراکنش‌ها به جای مجموع‌های متحرک.

--average-lot-prices

گزارش میانگین قیمتی که هر کالا/ارز با آن خریداری شده در یک گزارش تراز.

--balance-format FMT

تعیین قالب مورد استفاده برای گزارش balance.

--base

تقلیل کالاهای قابل تبدیل به پایین‌ترین سطح تبدیل؛ برای مثال نمایش زمان بر حسب ثانیه.

--basis (-B)

گزارش بهای تمام‌شده پایه در تمام ثبت‌ها. نام مستعار برای --cost.

--begin DATE (-b)

مشخص کردن تاریخ شروع (DATE) برای تمامی محاسبات. تراکنش‌های پیش از آن تاریخ نادیده گرفته می‌شوند.

--bold-if EXPR

چاپ کل خط به صورت پررنگ (bold) در صورتی که عبارت مقداری داده‌شده درست (true) باشد.

--budget

تنها نمایش اقلام بودجه‌بندی‌شده. در یک گزارش register این گزینه تراکنش‌های موجود در بودجه را نمایش می‌دهد، و در یک گزارش balance حساب‌های موجود در بودجه را نمایش می‌دهد.

--budget-format FMT

تعیین قالب مورد استفاده برای گزارش budget.

--by-payee (-P)

گروه‌بندی ثبت‌ها در گزارش register بر اساس نام مشترک طرف‌های حساب (دریافت‌کنندگان وجه).

--check-payees

فعال‌سازی بررسی دقیق و سخت‌گیرانه برای طرف‌های حساب و همچنین حساب‌ها، کالاها و برچسب‌ها.

--cleared (-C)

نمایش تنها ثبت‌های تسویه‌شده.

--cleared-format FMT

تعیین قالب مورد استفاده برای گزارش cleared.

--collapse (-n)

چاپ تنها حساب‌های سطح بالا.

--collapse-if-zero

بستن و جمع کردن نمایش حساب تنها در صورتی که مانده آن صفر باشد.

--color

استفاده از رنگ در صورتی که ترمینال از آن پشتیبانی کند. نام مستعار برای --ansi.

--columns INT

تنظیم عرض گزارش register به اندازه INT کاراکتر. به طور پیش‌فرض ledger از تمامی ستون‌های در دسترس ترمینال شما استفاده خواهد کرد.

--cost

گزارش بهای تمام‌شده پایه در تمام ثبت‌ها. نام مستعار برای --basis.

--count

هدایت ledger به گزارش تعداد اقلام، زمانی که به دستورات commodities ، accounts یا payees پیوست شود.

--csv-format FMT

قالب‌بندی گزارش csv مطابق با FMT.

--current (-c)

شکل کوتاه برای --limit 'date <= today'.

--daily (-D)

شکل کوتاه برای --period daily.

--date EXPR

تبدیل تاریخ تراکنش با استفاده از EXPR.

--date-format DATEFMT (-y)

چاپ تاریخ‌ها با استفاده از DATEFMT. برای جزئیات در خصوص نحو رشته قالب به strftime(3) مراجعه کنید.

--datetime-format DATETIMEFMT

چاپ تاریخ و زمان با استفاده از DATETIMEFMT. برای جزئیات در خصوص نحو رشته قالب به strftime(3) مراجعه کنید.

--date-width INT

تعیین عرض ستون تاریخ در گزارش register بر حسب تعداد کاراکتر.

--day-break

تفکیک ثبت‌های ورودی timelog در گزارش register که چند روز را در بر می‌گیرند بر اساس روز.

--days-of-week

گروه‌بندی تراکنش‌ها بر اساس روزهای هفته. نام مستعار برای --dow.

--dc

نمایش دفتر روزنامه یا تراز در قالب بدهکار/بستانکار. اگر از --dc همراه با هر یک از دستورات register یا balance استفاده کنید، ستون‌های جداگانه‌ای برای بدهکارها و بستانکارها دریافت خواهید کرد.

--debug STR

اگر ledger همراه با گزینه‌های اشکال‌زدایی ساخته شده باشد، این گزینه داده‌های اضافی را در طول اجرا فراهم می‌کند.

--decimal-comma

هدایت ledger به تجزیه دفاتر روزنامه با استفاده از ویرگول استاندارد اروپایی به عنوان ممیز اعشاری، به جای نقطه.

--depth INT

محدود کردن عمق حساب‌های نمایش‌داده‌شده در گزارش‌های balance و register. هر حسابی با عمق بیشتر درون والد خود در سطح مشخص‌شده جمع می‌شود. برای مثال با --depth 2 حساب Expenses:Entertainment:Dining برای نمایش درون Expenses:Entertainment جمع می‌شود. نکته حائز اهمیت این است که این یک گزاره نمایشی است، به این معنی که تنها بر نمایش اثر می‌گذارد نه محاسبات مجموع کل.

--detail

مربوط به دستور convert. مترادف با گزینه --rich-data.

--deviation

گزارش انحراف هر ثبت از میانگین. تنها در گزارش‌های register و prices معنادار است.

--display EXPR (-d)

نمایش خطوطی که عبارت EXPR را برآورده می‌سازند.

--display-amount EXPR

اعمال یک تبدیل روی مبلغ نمایش‌داده‌شده. این کار پس از انجام محاسبات رخ می‌دهد.

--display-total EXPR

اعمال یک تبدیل روی مجموع نمایش‌داده‌شده. این کار پس از انجام محاسبات رخ می‌دهد.

--dow

گروه‌بندی تراکنش‌ها بر اساس روزهای هفته. نام مستعار برای --days-of-week.

--download

باعث می‌شود مظنه‌ها در صورت نیاز به طور خودکار با اجرای اسکریپتی به نام getquote و انتظار اینکه آن اسکریپت مقداری قابل فهم برای ledger بازگرداند، دانلود شوند. یک پیاده‌سازی نمونه از اسکریپت getquote که با پرل پیاده‌سازی شده در توزیع برنامه ارائه شده است. مظنه‌های قیمتی دانلودشده سپس به پایگاه داده قیمت اضافه می‌شوند که معمولاً با متغیر محیطی LEDGER_PRICE_DB مشخص می‌گردد.

--effective

نمایش تاریخ‌های کمکی برای تمامی محاسبات. نام مستعار برای --aux-date.

--empty (-E)

گنجاندن حساب‌های خالی در گزارش.

--end DATE (-e)

محدود کردن گزارش به گونه‌ای که تراکنش‌های در تاریخ یا پس از DATE در نظر گرفته نشوند.

--equity

مربوط به دستور equity. مانده‌های جاری حساب را در قالب یک گزارش register ارائه می‌دهد.

--exact

گزارش ابتدا و انتهای دوره‌ها بر اساس تاریخ نخستین و آخرین ثبت رخ‌داده در آن دوره.

--exchange "COMMODITY [, COMMODITY, ...]" (-X)

نمایش مقادیر بر حسب COMMODITY مشخص‌شده. اگر چند کالا/ارز مشخص شوند، مقادیر مربوط به کالاهای فهرست‌شده همان‌گونه باقی می‌مانند، و سایرین در نخستین کالای فهرست‌شده‌ای که قابل تبدیل به آن باشند نمایش داده می‌شوند.

--file FILE (-f)

خواندن داده‌های دفتر روزنامه از FILE.

--first INT

چاپ اولین INT ورودی. متضاد --last INT. نام مستعار برای --head.

--flat

اجبار به استفاده از نام کامل حساب‌ها در گزارش balance. گزارش balance از یک درخت تورفته استفاده نخواهد کرد.

--force-color

خروجی دادن کدهای رنگی TTY حتی اگر TTY از آن‌ها پشتیبانی نکند. برای پایانه‌هایی که قابلیت‌های خود را به درستی اعلام نمی‌کنند مفید است.

--force-pager

مجبور کردن ledger به صفحه‌بندی خروجی خود.

--forecast-while EXPR

ادامه پیش‌بینی تا زمانی که VEXPR درست باشد. نام مستعار برای --forecast.

--forecast-years INT

پیش‌بینی حداکثر تا INT سال در آینده.

--format FMT (-F)

استفاده از رشته قالب داده‌شده FMT برای چاپ خروجی.

--gain (-G)

گزارش سود یا زیان خالص برای کالاهایی که تاریخچه قیمت دارند.

--generated

گنجاندن ثبت‌های خودکار تولیدشده (مانند ثبت‌های ناشی از تراکنش‌های خودکار) در گزارش، در مواردی که معمولاً آن‌ها را نمی‌خواهید.

--group-by EXPR

گروه‌بندی تراکنش‌ها با یکدیگر در گزارش register. EXPR می‌تواند هر چیزی باشد، هرچند رایج‌ترین آن‌ها payee یا commodity است. تابع tag() نیز در اینجا مفید است.

--group-title-format FMT

تنظیم قالب برای هدرهایی که بخش‌های گزارش را در یک گزارش گروه‌بندی‌شده از هم جدا می‌کنند. تنها در یک گزارش register همراه با --group-by EXPR اثر دارد.

--hashes ALGO

ثبت هش هر تراکنش در مقدار فراداده Hash ، مطابق با الگوریتم درهم‌سازی ارائه‌شده توسط آرگومان ALGO. الگوریتم‌های پشتیبانی‌شده عبارتند از sha512 یا sha512_half که در آن هر دو از SHA512 استفاده می‌کنند، اما دومی تنها نیمه اول مقدار هش را ذخیره می‌کند.

اگر مقدار فراداده Hash به صورت صریح ارائه شده باشد و با آنچه که باید تولید می‌شد مطابقت نداشته باشد، یک خطا گزارش می‌شود. هش‌ها به ورودی‌های پیشین وابسته هستند، به طوری که تنظیم یک مقدار هش منفرد برای تضمین شکل کل تاریخچه منتهی به آن ورودی کافی است.

--head INT

چاپ اولین INT ورودی. متضاد --tail INT. نام مستعار برای --first

--help

چاپ این صفحه راهنما.

--immediate

ارزیابی محاسبات به صورت بلادرنگ به جای ارزیابی تنبل (lazy).

--import FILE

وارد کردن FILE به عنوان ماژول پایتون.

--init-file FILE (-i)

خواندن FILE پیش از هر فایل دیگر ledger. این فایل نباید شامل هیچ ثبتی باشد، اما می‌تواند شامل تنظیمات گزینه‌ها باشد. برای تعیین گزینه‌ها در فایل پیکربندی آغازین، از همان نحو خط فرمان استفاده کنید، اما هر گزینه را در خطی جداگانه قرار دهید.

--inject STR

استفاده از مبالغ STR در محاسبات. در صورتی که می‌دانید مبلغ یک تراکنش چه باید باشد، اما تراکنش واقعی مقدار نادرستی دارد، می‌توانید از فراداده STR برای مشخص کردن مبلغ مورد انتظار استفاده کنید.

--input-date-format DATEFMT

تعیین قالب تاریخ ورودی برای ثبت‌های دفتر روزنامه.

--invert

تغییر علامت تمام مقادیر گزارش‌شده.

--last INT.

گزارش تنها به تعداد INT از آخرین ورودی‌ها. متضاد --first INT. تنها در یک گزارش register مفید است. نام مستعار برای --tail.

--leeway INT (-Z)

نام مستعار برای --price-exp.

--limit EXPR (-l)

محدود کردن ثبت‌ها در محاسبات.

--lisp-date-format FORMAT

تعیین قالب برای تاریخ‌ها در خروجی lisp. پیش‌فرض از قالب زمان Emacs Lisp استفاده می‌کند. گزینه‌های دیگر عبارتند از ‘seconds’ (ثانیه‌های مبدا یونیکس) یا یک رشته قالب strftime مانند ‘%Y-%m-%d’.

--lot-dates

گزارش تاریخی که هر کالا/ارز در یک گزارش تراز در آن خریداری شده است.

--lot-notes

گزارش برچسب پیوست‌شده به هر کالا در یک گزارش تراز.

--lot-prices

گزارش قیمتی که هر کالا در یک گزارش تراز با آن خریداری شده است.

--lots

گزارش تاریخ و قیمتی که هر کالا در یک گزارش تراز با آن خریداری شده است.

--lots-actual

حفظ یکتایی کالاها به طوری که در طول گزارش‌گیری بدون چاپ حاشیه‌نویسی‌های لات با یکدیگر ادغام نشوند.

--market (-V)

استفاده از آخرین ارزش بازار برای تمامی کالاها/ارزها.

--master-account STR

افزودن STR به ابتدای تمامی نام‌های حساب.

--meta STR

در گزارش register، تراکنش را با مقدار برچسب داده‌شده STR آغاز می‌کند.

--meta-width INT

تعیین عرض ستون Meta استفاده‌شده برای گزینه‌های --meta TAG.

--monthly (-M)

شکل کوتاه برای --period monthly.

--no-aliases

نام‌های مستعار کاملاً نادیده گرفته می‌شوند.

--no-color

حذف هرگونه خروجی رنگی TTY.

--no-pager

غیرفعال کردن صفحه‌بندی در خروجی TTY.

--no-revalued

جلوگیری از نمایش ثبت‌های <Revalued> توسط ledger.

--no-rounding

عدم چاپ ثبت‌های "<Adjustment>". توجه داشته باشید که این گزینه غالباً باعث می‌شود جمع متحرک درست درنیاید! کاربرد اصلی آن برای گزارش‌های --amount-data (-j) و --total-data (-J) است.

--no-titles

حذف خروجی عنوان‌های گروه.

--no-total

عدم چاپ خط مجموع نهایی در یک گزارش تراز.

--now DATE

استفاده از DATE به عنوان تاریخ جاری. این گزینه بر خروجی هنگام استفاده از --period -، --begin -، --end یا --current برای تصمیم‌گیری درباره اینکه کدام تاریخ‌ها در گذشته یا آینده قرار دارند اثر می‌گذارد.

--only EXPR

این یک گزاره ثبت است که پس از اجرای تبدیلات مشخصی مانند گردآوری دوره‌ای اعمال می‌شود.

--options

نمایش گزینه‌های فعال برای این فراخوانی ، به همراه مقادیر آن‌ها و منبع آن مقادیر.

--output FILE (-o)

هدایت مجدد خروجی ledger به FILE.

--pager STR

استفاده از STR به عنوان برنامه صفحه‌بندی (pager).

--payee

تنظیم یک عبارت مقداری برای قالب‌بندی طرف حساب. در گزارش register این گزینه از داشتن تاریخ و طرف حساب برای ورودی دوم در هر تراکنش جلوگیری می‌کند.

--payee-width INT

تنظیم تعداد ستون‌های اختصاص‌یافته به طرف حساب در گزارش register به INT.

--pedantic

حساب‌ها، برچسب‌ها یا کالاهایی که از پیش اعلان نشده باشند موجب خطا خواهند شد.

--pending

استفاده تنها از ثبت‌هایی که به عنوان در انتظار (pending) علامت‌گذاری شده‌اند.

--percent (-%)

محاسبه مقدار درصدی هر حساب در یک گزارش تراز. تنها برای حساب‌هایی کار می‌کند که دارای یک کالا/ارز منفرد باشند.

--period PERIOD (-p)

تعریف یک عبارت دوره که بازه زمانی حسابرسی تراکنش‌ها را تعیین می‌کند. برای یک گزارش register تنها تراکنش‌هایی که عبارت دوره را برآورده کنند نمایش داده می‌شوند. برای یک گزارش تراز تنها آن تراکنش‌ها در مانده‌های نهایی محاسبه خواهند شد.

--period-sort

مرتب‌سازی ثبت‌ها در درون تراکنش‌ها با استفاده از عبارت مقداری داده‌شده.

--permissive

نادیده گرفتن گزاره‌های بررسی صحت تراز (assertions).

--pivot TAG

تولید گزارش تراز محوری "پیرامون" برچسب داده‌شده TAG.

--plot-amount-format FMT

تعیین قالب خروجی برای رسم نمودار داده‌های مبلغ.

--plot-total-format FMT

تعیین قالب خروجی برای رسم نمودار داده‌های مجموع.

--prepend-format FMT

افزودن FMT به ابتدای هر خط از خروجی.

--prepend-width INT

رزرو کردن INT فاصله در ابتدای هر خط از خروجی.

--price (-I)

استفاده از قیمت خرید کالا برای انجام محاسبات.

--price-db FILE

 

--price-exp INT (-Z)

تنظیم میزان تازگی مورد انتظار برای مظنه‌های قیمت، به میزان INT ساعت. به این معنا که اگر آخرین مظنه شناخته‌شده برای هر کالایی قدیمی‌تر از این مقدار باشد، و اگر --download در حال استفاده باشد، آنگاه اینترنت مجدداً برای دریافت قیمت جدیدتر بررسی خواهد شد. در غیر این صورت، قیمت پیشین همچنان به اندازه کافی تازه در نظر گرفته می‌شود. نام مستعار برای --leeway.

--prices-format FMT

تنظیم قالب برای گزارش prices.

--pricedb-format FMT

تنظیم قالب مورد انتظار برای فایل قیمت‌های تاریخی.

--primary-date

نمایش تاریخ‌های اولیه برای تمامی محاسبات. نام مستعار برای --actual-dates.

--quantity (-O)

گزارش مجموع کالاها (این حالت پیش‌فرض است).

--quarterly

شکل کوتاه برای --period quarterly.

--raw

در گزارش print ، تراکنش‌ها دقیقاً با همان نحوی که توسط کاربر در فایل داده‌ها مشخص شده نمایش داده شوند. هیچ‌گونه دستکاری یا تفسیر انجام نشود. برای تمیزکاری‌های جزئی مانند تراز کردن مبالغ می‌تواند مفید باشد.

--real (-R)

حسابداری تنها با استفاده از تراکنش‌های واقعی و نادیده گرفتن تراکنش‌های مجازی و خودکار.

--recursive-aliases

باعث می‌شود ledger تلاش کند نام‌های مستعار را به صورت بازگشتی گسترش دهد، یعنی نتیجه گسترش قبلی را مجدداً گسترش دهد، تا زمانی که دیگر هیچ گسترشی قابل اعمال نباشد.

--register-format FMT

تعیین قالب خروجی برای گزارش register.

--related (-r)

در گزارش register حساب مرتبط را نشان می‌دهد. این همان طرف دیگر تراکنش است.

--related-all

نمایش تمام ثبت‌ها در یک تراکنش، مشابه --related اما نمایش هر دو طرف هر تراکنش.

--revalued

گزارش اختلاف در مقادیر برای گزارش‌های دستی از طریق درج ثبت‌های <Revalued> . این حالت هنگام استفاده از گزینه --exchange (-X) یا --market (-V) به صورت ضمنی فعال می‌شود.

--revalued-only

نمایش تنها ثبت‌های <Revalued> .

--revalued-total

نمایش مجموع ثبت‌های بازتخمین‌شده به عنوان جمع متحرک، که برای نمایش سرمایه تحقق‌نیافته در یک گزارش سود/زیان کاربرد دارد.

--rich-data

هنگام تولید تراکنش ledger از یک فایل CSV با استفاده از دستور convert ، فراداده‌های CSV، Imported و UUID اضافه شوند.

--seed INT

تنظیم بذر تصادفی روی INT برای دستور generate. به عنوان بخشی از آزمون‌های توسعه استفاده می‌شود.

--script FILE

اجرای یک اسکریپت ledger.

--sort EXPR (-S)

مرتب‌سازی گزارش register بر اساس عبارت مقداری EXPR.

--sort-xacts

مرتب‌سازی ثبت‌ها در درون تراکنش‌ها با استفاده از عبارت مقداری داده‌شده.

--start-of-week STR

استفاده از STR به عنوان روز خاصی از هفته برای شروع، هنگام استفاده از گزینه --weekly. مقدار STR می‌تواند نام روزها، مخفف آن‌ها مانند "Mon ،" یا شماره روز هفته با شروع از 0 برای یکشنبه باشد.

--sort-all

مرتب‌سازی تمام حساب‌ها و کالاها.

--strict

حساب‌ها، برچسب‌ها یا کالاهایی که پیش‌تر اعلان نشده باشند موجب هشدار خواهند شد.

--subtotal (-s)

گزارش register به عنوان یک زیرمجموع واحد.

--tail INT

گزارش تنها به تعداد INT از آخرین ورودی‌ها. تنها در گزارش register مفید است. نام مستعار برای --last INT.

--time-colon

نمایش مقدار برای کالاهای مبتنی بر ثانیه به صورت ساعت و دقیقه. بنابراین 8100s به جای 2.25h به صورت 2:15h نمایش داده خواهد شد.

--time-report

افزودن دو ستون به گزارش balance برای نمایش زودترین زمان‌های ورود و خروج مربوط به ثبت‌های timelog.

--total EXPR (-T)

تعریف یک عبارت مقداری برای محاسبه مجموع در گزارش‌ها.

--total-data (-J)

نمایش تنها تاریخ‌ها و مجموع‌ها برای قالب‌بندی خروجی جهت رسم نمودارها.

--total-width INT

تنظیم عرض فیلد مجموع در گزارش register.

--trace INT

فعال‌سازی ردیابی (trace). آرگومان INT سطح ردیابی مورد نظر را مشخص می‌کند.

--truncate STR

مشخص می‌کند در صورتی که محتوای ستون‌ها از عرض آن‌ها بیشتر شود، بریدگی چگونه باید صورت گیرد. مقادیر معتبر برای STR عبارتند از leading ، middle و trailing. حالت پیش‌فرض هوشمندانه‌تر از هر سه تای این‌هاست، چرا که زیرنام‌های موجود در نام حساب را در نظر می‌گیرد (این شیوه "abbreviate" نامیده می‌شود).

--unbudgeted

نمایش تنها ثبت‌های بودجه‌بندی‌نشده.

--uncleared (-U)

استفاده تنها از تراکنش‌های تسویه‌نشده در محاسبات و گزارش‌ها.

--unrealized

نمایش حساب‌های سود و زیان تحقق‌نیافته تولیدشده در گزارش balance.

--unrealized-gains

اجازه به کاربر برای تعیین اینکه چه نام حسابی باید برای سودهای تحقق‌نیافته استفاده شود. پیش‌فرض Equity:Unrealized Gains است. اغلب در فایل پیکربندی آغازین برای تغییر پیش‌فرض تنظیم می‌شود.

--unrealized-losses

اجازه به کاربر برای تعیین اینکه چه نام حسابی باید برای زیان‌های تحقق‌نیافته استفاده شود. پیش‌فرض Equity:Unrealized Losses است. اغلب در فایل پیکربندی آغازین برای تغییر پیش‌فرض تنظیم می‌شود.

--unround

انجام تمام محاسبات بدون گرد کردن و نمایش نتایج با دقت کامل.

--values

نمایش مقادیر استفاده‌شده توسط هر برچسب در صورت استفاده ترکیبی با دستور tags.

--value-expr EXPR

تنظیم یک حاشیه‌نویسی عبارت مقداری سراسری.

--verbose

چاپ اطلاعات با جزئیات کامل درباره اجرای ledger.

--verify

فعال‌سازی بررسی‌های صحت مضاعف (assertions) در طول زمان اجرا. این کار باعث کاهش چشمگیر سرعت می‌شود. هنگام ترکیب با --debug CODE ، برنامه ledger اطلاعات ردیابی حافظه تولید خواهد کرد.

--verify-memory

بررسی اینکه هر شیء ایجادشده به درستی تخریب شود. این گزینه تنها برای اهداف اشکال‌زدایی است.

--version

چاپ اطلاعات نسخه و خروج.

--weekly (-W)

شکل کوتاه برای --period weekly.

--wide (-w)

فرض ۱۳۲ ستون به جای عرض پایانه (TTY).

--yearly (-Y)

شکل کوتاه برای --period yearly.

پیش‌دستورات (PRE-COMMANDS)

پیش‌دستورات زمانی سودمند هستند که مطمئن نیستید یک دستور یا گزینه چگونه کار خواهد کرد. تفاوت میان یک پیش‌دستور و یک دستور معمولی در این است که پیش‌دستورات فایل داده‌های دفتر روزنامه را کاملاً نادیده می‌گیرند و فایل پیکربندی آغازین کاربر نیز خوانده نمی‌شود.

args / query

ارزیابی آرگومان‌های داده‌شده و گزارش نحوه تفسیر آن توسط ledger در برابر تراکنش مدل زیر:

2004/05/27 Book Store
    ; This note applies to all postings. :SecondTag:
    Expenses:Books                 20 BOOK @ $10
    ; Metadata: Some Value
    ; Typed:: $100 + $200
    ; :ExampleTag:
    ; Here follows a note describing the posting.
    Liabilities:MasterCard        $-200.00

eval

ارزیابی عبارت مقداری داده‌شده در برابر تراکنش مدل.

format

چاپ جزئیات نحوه استفاده ledger از توصیف قالب‌بندی ارائه‌شده و اعمال آن در برابر یک تراکنش مدل.

parse / expr

چاپ جزئیات نحوه استفاده ledger از توصیف عبارت مقداری داده‌شده و اعمال آن در برابر یک تراکنش مدل.

generate

تولید تصادفی داده‌های معتبر از دید نحوی در ledger از روی یک بذر (seed). توسط سامانه GenerateTests برای آزمون‌های توسعه استفاده می‌شود.

period

ارزیابی دوره داده‌شده و گزارش نحوه تفسیر آن توسط ledger.

template

نمایش الگوی درجی که دستور xact تولید می‌کند. این یک دستور اشکال‌زدایی است.

پرس‌وجوها (QUERIES)

نحو عبارات پرس‌وجوی گزارش‌گیری می‌تواند تا حدی پیچیده باشد. این نحو مجموعه‌ای از عبارات پرس‌وجو است که عملگر ضمنی OR میان آن‌ها برقرار است. عبارات زیر پذیرفته می‌شوند:

regex

یک رشته ساده به عنوان یک عبارت باقاعده (PCRE) در نظر گرفته می‌شود که با نام کامل حساب مطابقت داده می‌شود. بنابراین برای گزارش تراز جاری تمام دارایی‌ها و بدهی‌ها، می‌توانید از دستور زیر استفاده کنید:

ledger bal asset liab

payee regex (@regex)

پرس‌وجو بر پایه طرف حساب (دریافت‌کننده وجه)، به جای حساب.

tag regex (%regex)

پرس‌وجو بر پایه برچسب‌ها.

note regex (=regex)

پرس‌وجو روی هر موردی که در یادداشت یک قلم یافت شود.

code regex (#regex)

پرس‌وجو بر پایه کد اختیاری تراکنش (که می‌تواند هر رشته دلخواه کاربر باشد).

term and term

عبارات پرس‌وجو با یک عملگر ضمنی OR به هم متصل می‌شوند. می‌توانید با استفاده از کلمه کلیدی and این حالت را به AND تغییر دهید. به عنوان مثال، برای نمایش هزینه‌های خوراک رخ‌داده در Shakee's Pizza، می‌توانید بگویید:

ledger reg food and @Shakee

term or term

هنگامی که می‌خواهید صریح‌تر عمل کنید، از عملگر OR استفاده نمایید.

show

 

not term

معکوس کردن معنای منطقی عبارت پس از آن. این عملگر می‌تواند همراه با پرانتزها اثر بسیار مفیدی داشته باشد:

ledger reg food and @Shakee and not dining

( term )

اگر مایلید عملگرهای OR و AND را با یکدیگر ترکیب کنید، اغلب احاطه کردن واحدهای منطقی با پرانتز کمک‌کننده است. نکته: به دلیل شیوه تفسیر پرانتزها در برخی پوسته‌ها، همواره باید آن‌ها را اسکیپ کنید:

ledger bal \( assets or liab \) and not food

عبارت‌ها (EXPRESSIONS)

abs(value)

بازگرداندن قدر مطلق مقدار داده‌شده (value).

account

بازگرداندن حساب مربوط به ثبت.

account_base

بازگرداندن حساب پایه، یعنی هر آنچه پس از آخرین جداکننده حساب ':' قرار دارد.

actual

بازگرداندن درست (true) در صورتی که تراکنش واقعی باشد، یعنی یک تراکنش خودکار یا مجازی نباشد؛ و نادرست (false) در غیر این صورت.

amount

بازگرداندن مبلغ ثبت.

amount_expr

بازگرداندن مبلغ محاسبه‌شده ثبت با توجه به گزینه --amount.

ansify_if(value, color, bool)

ارائه مقدار داده‌شده (value) به صورت یک رشته، با اعمال کدهای گریز مناسب ANSI برای نمایش آن در رنگ (color) مشخص‌شده در صورتی که bool درست باشد. این تابع معمولاً مقدار گزینه --color را بررسی می‌کند، به عنوان مثال:

ansify_if(amount, blue, options.color)

beg_line

شماره خطی که ورودی مربوط به ثبت در آن آغاز می‌شود.

beg_pos

موقعیت کاراکتری که ورودی مربوط به ثبت در آن آغاز می‌شود.

ceiling(value)

بازگرداندن عدد صحیح بعدی مقدار (value) به سمت بی‌نهایت مثبت (سقف).

cleared

بازگرداندن درست در صورتی که ثبت تسویه شده باشد؛ و نادرست در غیر این صورت.

code

بازگرداندن کد تراکنش، رشته‌ای که میان پرانتزها پس از تاریخ قرار دارد.

commodity(value)

بازگرداندن کالا/ارز مقدار (value) یا مبلغ ثبت در زمانی که value مشخص نشده باشد.

date

بازگرداندن تاریخ ثبت.

end_line

شماره خطی که ورودی مربوط به ثبت در آن پایان می‌یابد.

end_pos

موقعیت کاراکتری که ورودی مربوط به ثبت در آن پایان می‌یابد.

floor(value)

بازگرداندن عدد صحیح بعدی مقدار (value) به سمت بی‌نهایت منفی (کف).

filename

نام فایل داده ledger که ثبت از آن استخراج شده است.

format(string)

ارزیابی string به عنوان قالب درست مانند گزینه --format.

format_date(date, format)

بازگرداندن تاریخ (date) به صورت یک رشته با استفاده از قالب (format). برای جزئیات رشته قالب به strftime(3) مراجعه کنید.

format_datetime(datetime, format)

بازگرداندن تاریخ و زمان (datetime) به صورت یک رشته با استفاده از قالب (format). برای جزئیات رشته قالب به strftime(3) مراجعه کنید.

get_at(seq, index)

بازگرداندن مقدار در اندیس (index) از دنباله (seq). استفاده داخلی برای ساخت گزارش‌های گوناگون.

has_meta(tag)

بازگرداندن درست در صورتی که ثبت دارای فراداده‌ای با نام tag باشد؛ و نادرست در غیر این صورت.

has_tag(tag)

بازگرداندن درست در صورتی که ثبت دارای فراداده‌ای با نام tag باشد؛ و نادرست در غیر این صورت.

is_seq(value)

بازگرداندن درست در صورتی که value یک دنباله باشد. استفاده داخلی.

join(value)

جایگزینی تمامی خطوط جدید در value با \n.

justify(value, first_width, latter_width, right_justify, colorize)

تراز کردن رشته نمایانگر value به سمت راست یا چپ. عرض فیلد در خط اول با first_width تعیین می‌شود. برای خطوط بعدی عرض با latter_width مشخص می‌گردد. اگر latter_width برابر با 1- باشد، first_width برای تمام خطوط استفاده می‌شود. اگر right_justify درست باشد، فیلد درون عرض مشخص‌شده راست‌چین می‌شود. اگر نادرست باشد، فیلد چپ‌چین شده و تا عرض کامل فیلد با فاصله پر می‌گردد. اگر colorize درست باشد، ledger تنظیمات رنگ را اعمال خواهد کرد.

market(value, datetime)

بازگرداندن قیمت value در زمان datetime. توجه داشته باشید که datetime باید درون براکت‌ها قرار گیرد تا به درستی تجزیه شود، مانند [2012/03/23].

meta(name)

بازگرداندن مقدار فراداده با نام name.

note

بازگرداندن یادداشت مربوط به ثبت.

now

بازگرداندن تاریخ و زمان جاری.

options

متغیری که امکان دسترسی به مقادیر گزینه‌های خط فرمان ارائه‌شده با استفاده از نام‌های بلند گزینه‌ها را فراهم می‌کند، برای مثال برای بررسی اینکه آیا گزینه --daily (-D) ارائه شده بود یا خیر از option.daily استفاده کنید.

payee

بازگرداندن طرف حساب ثبت.

percent(value_a, value_b)

بازگرداندن درصد value_a نسبت به value_b (که به عنوان ۱۰۰٪ در نظر گرفته می‌شود).

pending

بازگرداندن درست در صورتی که ثبت به عنوان در انتظار (pending) علامت‌گذاری شده باشد؛ و نادرست در غیر این صورت.

percent(value_a, value_b)

بازگرداندن درصد value_a نسبت به value_b.

print(value)

چاپ value در خروجی استاندارد (stdout). استفاده داخلی برای اشکال‌زدایی.

quantity(value)

بازگرداندن مقدار کمیت value برای مقادیری که بهای تمام‌شده به ازای هر واحد دارند.

quoted(expression)

احاطه کردن expression با علامت نقل‌قول دوتایی (گیومه).

quoted_rfc(expression)

احاطه کردن expression با علامت نقل‌قول دوتایی، سازگار با استاندارد RFC 4180.

real

بازگرداندن درست در صورتی که تراکنش واقعی باشد، یعنی یک تراکنش خودکار یا مجازی نباشد؛ و نادرست در غیر این صورت.

roundto(value, n)

بازگرداندن value گردشده به تعداد n رقم. بر قالب‌بندی اثر نمی‌گذارد.

should_bold

بازگرداندن درست در صورتی که عبارت داده‌شده به --bold-if به درست ارزیابی شود. تنها استفاده داخلی!

scrub(value)

پاکسازی value با استفاده از تبدیل‌های گوناگون مانند گرد کردن، حذف حاشیه‌نویسی‌های مقدار و موارد دیگر.

strip(value)

حذف حاشیه‌نویسی مقدار از value.

tag(name)

بازگرداندن مقدار برچسب با نام name.

to_amount(value)

تبدیل value به یک مبلغ. تنها استفاده داخلی!

to_balance(value)

تبدیل value به یک تراز. تنها استفاده داخلی!

to_boolean(value)

تبدیل value به یک مقدار بولی. تنها استفاده داخلی!

to_date(value)

تبدیل value به یک تاریخ. تنها استفاده داخلی!

to_datetime(value)

تبدیل value به یک تاریخ و زمان. تنها استفاده داخلی!

to_int(value)

بازگرداندن مقدار عدد صحیح برای value.

to_mask(value)

تبدیل value به یک ماسک. تنها استفاده داخلی!

to_sequence(value)

تبدیل value به یک دنباله. تنها استفاده داخلی!

to_string(value)

تبدیل value به یک رشته کاراکتری.

today

بازگرداندن تاریخ امروز.

total

بازگرداندن مجموع ثبت.

total_expr

بازگرداندن مجموع محاسبه‌شده ثبت با توجه به گزینه --total.

trim(value)

حذف فاصله‌های سفید ابتدایی و انتهایی از value.

truncated(string, total_len, account_len)

کوتاه کردن string به طول total_len با تضمین اینکه طول هر حساب حداقل به اندازه account_len باشد.

virtual

بازگرداندن درست در صورتی که تراکنش مجازی باشد (برای مثال خودکار)؛ و نادرست در غیر این صورت.

averaged_lots()

بازگرداندن لات‌ها با میانگین قیمت‌ها.

clear_commodity()

پاک کردن اطلاعات قیمت‌گذاری کالا/ارز.

commodity_price(commodity)

بازگرداندن قیمت کالا/ارز داده‌شده.

display_amount(amount)

قالب‌بندی مبلغ برای نمایش.

display_total(total)

قالب‌بندی مجموع برای نمایش.

lot_date(posting)

بازگرداندن تاریخ لات یک ثبت.

lot_price(posting)

بازگرداندن قیمت لات یک ثبت.

lot_tag(posting)

بازگرداندن برچسب لات یک ثبت.

nail_down(amount)

تثبیت دقت یک مبلغ.

round(amount)

گرد کردن یک مبلغ به دقت استاندارد.

rounded(amount)

بازگرداندن نسخه گردشده یک مبلغ.

set_commodity_price(commodity, price)

تنظیم قیمت برای یک کالا/ارز.

top_amount(amount)

بازگرداندن مبلغ سطح بالا.

unround(amount)

حذف گرد کردن از یک مبلغ.

unrounded(amount)

بازگرداندن نسخه گردنشده یک مبلغ.

دستورات اشکال‌زدایی (DEBUG COMMANDS)

علاوه بر دستورات گزارش‌گیری معمول، ledger چندین دستور اشکال‌زدایی را نیز می‌پذیرد:

args [report-query]

نمایش تحلیل کاملی از نحوه تفسیر report-query داده‌شده توسط ledger. در صورتی که بخواهید بدانید پرس‌وجوهای گزارش چگونه به عبارات مقداری ترجمه می‌شوند سودمند است.

eval [value-expression]

ارزیابی value-expression داده‌شده و چاپ نتیجه. برای اطلاعات بیشتر درباره عبارات مقداری، بخش EXPRESSIONS را ببینید.

format [format-string]

نمایش تحلیلی از نحوه تجزیه format-string و اینکه اعمال آن روی یک تراکنش نمونه چگونه خواهد بود. برای اطلاعات بیشتر درباره رشته‌های قالب، بخش FORMATS را ببینید.

generate

تولید ۵۰ تراکنش تصادفی اما معتبر در ledger.

parse [value-expression]

تجزیه value-expression داده‌شده و نمایش تحلیلی از درخت عبارت و مقدار ارزیابی‌شده آن. برای اطلاعات بیشتر درباره عبارات مقداری، بخش EXPRESSIONS را ببینید.

python [file]

فراخوانی یک مفسر پایتون برای خواندن file داده‌شده. نکته ویژه این دستور آن است که ماژول ledger به صورت توکار است و از دیسک خوانده نمی‌شود، بنابراین نیازی به نصب بودن ledger در جایی از سیستم یا ساخت نسخه‌های کتابخانه مشترک آن نیست.

reload

بارگذاری مجدد بلادرنگ تمام فایل‌های داده برای نشست جاری. تنها در REPL قابل استفاده است.

template [draft-template]

نمایش اطلاعاتی درباره نحوه تجزیه draft-template. بخش DRAFTS را ببینید.

محیط (ENVIRONMENT)

هر گزینه‌ای برای ledger در صورتی که دارای نام بلند باشد، می‌تواند با استفاده از یک متغیر محیطی تنظیم شود. برای مثال، تنظیم متغیر محیطی LEDGER_DATE_FORMAT="%d.%m.%Y" اثری مشابه با مشخص کردن --date-format '%d.%m.%Y' در خط فرمان خواهد داشت. با این حال گزینه‌های خط فرمان همیشه نسبت به تنظیمات متغیرهای محیطی اولویت دارند.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/ledger/ledgerrc

 

~/.config/ledger/ledgerrc

 

~/.ledgerrc

تنظیمات آغازین شخصی شما برای ledger.

همچنین ببینید (SEE ALSO)

beancount(1), hledger(1)

مستندات کامل برای ledger به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه info روی سیستم شما نصب شده است، دستور

نویسندگان (AUTHORS)

John Wiegley ⟨johnw@newartisans.com⟩