LEDGER(1) General Commands Manual LEDGER(1) نام (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 جلوگیری از نمایش ثبت‌های توسط ledger. --no-rounding عدم چاپ ثبت‌های "". توجه داشته باشید که این گزینه غالباً باعث می‌شود جمع متحرک درست درنیاید! کاربرد اصلی آن برای گزارش‌های --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 گزارش اختلاف در مقادیر برای گزارش‌های دستی از طریق درج ثبت‌های . این حالت هنگام استفاده از گزینه --exchange (-X) یا --market (-V) به صورت ضمنی فعال می‌شود. --revalued-only نمایش تنها ثبت‌های . --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 روی سیستم شما نصب شده است، دستور info ledger3 باید دسترسی به راهنمای کامل را در اختیارتان بگذارد. نویسندگان (AUTHORS) John Wiegley ⟨johnw@newartisans.com⟩ Linux 6.12.107+deb13-amd64 December 13, 2023 Linux 6.12.107+deb13-amd64