.TH "HLEDGER\-WEB" "1" "March 2026" "hledger-web-1.52 " "hledger User Manuals"



.SH "نام (NAME)"
hledger\-web \- رابط کاربری وب و API برای \f[CR]hledger\f[R]، برنامه‌ای قدرتمند و کاربرپسند برای حسابداری متن ساده
.SH "خلاصه دستور (SYNOPSIS)"
\f[CR]hledger\-web [OPTS] [QUERY]\f[R]
.PD 0
.P
.PD
یا
.PD 0
.P
.PD
\f[CR]hledger web [OPTS] [QUERY]\f[R]
.SH "توضیحات (DESCRIPTION)"
این راهنما برای رابط وب hledger نسخه 1.52 است.
برای مفاهیم مشترک و فرمت‌های فایل، به راهنمای hledger نیز مراجعه کنید.
.PP
برنامه hledger مجموعه‌ای قدرتمند، کاربرپسند و چندسکویی از برنامه‌ها برای ردیابی پول، زمان، یا هر کالای دیگر با استفاده از حسابداری دوبل و فرمت فایل ساده و قابل ویرایش است.
برنامه hledger از ledger(1) الهام گرفته و تا حد زیادی با آن سازگار است، و همچنین تا حد زیادی با beancount(1) قابلیت تبدیل متقابل دارد.
.PP
دستور hledger\-web یک برنامه تحت وب ساده برای مرور و افزودن تراکنش‌ها است.
این ابزار رابط کاربری بهتری نسبت به واسط خط فرمان (CLI) یا واسط متنی (TUI) برنامه hledger\-ui فراهم می‌کند و موارد بیشتری را به‌صورت هم‌زمان نشان می‌دهد (حساب‌ها، دفتر حساب جاری، نمودارهای تراز) و امکان ورود داده با آگاهی از تاریخچه، جستجوی تعاملی و نشانه‌گذاری را مهیا می‌سازد.
.PP
همچنین hledger\-web به شما امکان می‌دهد دفتر روزنامه (journal) را با چندین کاربر یا حتی در وب عمومی به اشتراک بگذارید.
هیچ سیستم کنترل دسترسی درونی وجود ندارد، بنابراین در صورت نیاز باید آن را پشت یک پراکسی وب مناسب قرار دهید.
به عنوان یک محافظت کوچک در برابر از دست رفتن داده‌ها هنگام اجرای یک نمونه محافظت‌نشده، در هر ویرایش، یک نسخه پشتیبان شماره‌گذاری‌شده (تنها) از فایل اصلی ژورنال ایجاد می‌کند.
.PP
مانند hledger، داده‌ها را از یک فایل ژورنال مشخص‌شده با متغیر محیطی \f[CR]LEDGER_FILE\f[R] می‌خواند (و به آن اضافه می‌کند) (با مقدار پیش‌فرض \f[CR]$HOME/.hledger.journal\f[R])؛ یا می‌توانید فایل‌ها را با گزینه‌های \f[CR]\-f\f[R] تعیین کنید.
همچنین می‌تواند فایل‌های timeclock، فایل‌های timedot، یا هر فایل CSV/SSV/TSV دارای فیلد تاریخ را بخواند.
(برای جزئیات به hledger(1) \-> Input مراجعه کنید.)
.PP
دستور hledger\-web را می‌توان در سه حالت اجرا کرد:
.IP \(bu 2
حالت \f[CR]\-\-serve\-browse\f[R] (حالت پیش‌فرض): برنامه رابط وب و JSON API را ارائه می‌دهد، در صورت امکان مرورگر پیش‌فرض شما را برای نمایش برنامه باز می‌کند، و پس از دو دقیقه عدم فعالیت (بدون دریافت درخواست و بدون هیچ پنجره باز مرورگری که آن را نمایش دهد) به‌طور خودکار خارج می‌شود.
.IP \(bu 2
\f[CR]\-\-serve\f[R]: برنامه فقط رابط وب و JSON API را ارائه می‌دهد.
.IP \(bu 2
\f[CR]\-\-serve\-api\f[R]: برنامه فقط JSON API را ارائه می‌دهد.
.PP
در تمامی حالت‌ها، hledger\-web به عنوان یک پردازه در پیش‌زمینه اجرا شده و لاگ درخواست‌ها را در stdout ثبت می‌کند.
.SH "گزینه‌ها (OPTIONS)"
دستور hledger\-web گزینه‌های زیر را ارائه می‌دهد:
.IP
.EX
Flags:
     \-\-serve \-\-server       ارائه خدمات و ثبت لاگ درخواست‌ها، بدون مرورگر یا خروج خودکار
     \-\-serve\-api            مشابه \-\-serve، اما فقط ارائه‌دهنده JSON web API،
                            نه رابط کاربری وب
     \-\-allow=view|add|edit  تنظیم سطح دسترسی کاربر برای تغییر داده‌ها
                            (پیش‌فرض: \(gaadd\(ga). همچنین مقدار \(gasandstorm\(ga را برای
                            استفاده در آن پلتفرم می‌پذیرد (مجوزها را از هدر درخواست
                            \(gaX\-Sandstorm\-Permissions\(ga می‌خواند).
     \-\-cors=ORIGIN          مجاز کردن درخواست‌های cross\-origin از مبدأ مشخص‌شده؛
                            تنظیم ORIGIN بر روی \(dq*\(dq به درخواست‌های هر مبدأیی اجازه می‌دهد
     \-\-host=IPADDR          شنود روی این آدرس IP (پیش‌فرض: 127.0.0.1)
     \-\-port=PORT            شنود روی این درگاه TCP (پیش‌فرض: 5000)
     \-\-socket=SOCKET        شنود روی سوکت یونیکس ارائه‌شده به‌جای آدرس IP و درگاه
                            (فقط یونیکس؛ مستلزم \-\-serve است)
     \-\-base\-url=BASEURL     تنظیم URL پایه (پیش‌فرض: http://IPADDR:PORT)
     \-\-test                 اجرای آزمایش‌های hledger\-web و خروج. آرگومان‌های اجراکننده
                            آزمون hspec می‌توانند پس از \-\- بیایند، مانند: hledger\-web \-\-test \-\-help
.EE
.PP
به‌طور پیش‌فرض hledger\-web تنها بر روی آدرس آی‌پی \f[CR]127.0.0.1\f[R] شنود می‌کند که فقط از طریق رایانه محلی قابل دسترسی است.
.PP
برای مجاز کردن دسترسی از دیگر مبادی، از \f[CR]\-\-host\f[R] استفاده کنید تا یک آدرس با قابلیت دسترسی بیرونی که روی این سیستم پیکربندی شده است را مشخص کنید. آدرس ویژه \f[CR]0.0.0.0\f[R] باعث می‌شود برنامه روی تمامی آدرس‌های این ماشین شنود کند.
.PP
به همین ترتیب، می‌توانید از \f[CR]\-\-port\f[R] برای شنود بر روی یک درگاه TCP غیر از ۵۰۰۰ استفاده نمایید.
این گزینه زمانی مفید است که بخواهید چندین نمونه hledger\-web را روی یک سیستم اجرا کنید.
.PP
هنگامی که از \f[CR]\-\-socket\f[R] استفاده می‌شود، hledger\-web به‌جای پورت TCP از طریق یک فایل سوکت ارتباط برقرار می‌سازد.
این شیوه می‌تواند امن‌تر باشد، به مجوزهای فایل یونیکس احترام می‌گذارد، و موارد کاربرد خاصی مانند اجرای نمونه‌های مجزا برای هر کاربر پشت پراکسی معکوس nginx را ساده‌تر می‌کند.
(برای مثال:
\f[CR]proxy_pass http://unix:/tmp/hledger/${remote_user}.socket;\f[R].)
.PP
می‌توانید از \f[CR]\-\-base\-url\f[R] برای تغییر پروتکل، نام میزبان، درگاه و مسیری که در پیوندهای وب hledger\-web نمایش داده می‌شوند استفاده نمایید.
این امر برای نمونه هنگام ادغام hledger\-web درون یک وب‌سایت بزرگ‌تر کاربرد دارد.
مقدار پیش‌فرض \f[CR]http://HOST:PORT/\f[R] با استفاده از آدرس میزبان و درگاه TCP پیکربندی‌شده سرور است (یا \f[CR]http://HOST\f[R] در صورتی که درگاه ۸۰ باشد).
توجه داشته باشید که این گزینه بر تولید URL اثر می‌گذارد اما تجزیه مسیرها (route parsing) را تغییر نمی‌دهد.
.PP
دستور hledger\-web همچنین از بسیاری از گزینه‌های عمومی hledger پشتیبانی می‌کند:
.IP
.EX
General input/data transformation flags:
  \-f \-\-file=[FMT:]FILE      خواندن داده‌ها از FILE، یا از stdin در صورتی که FILE برابر \- باشد،
                             با استنتاج فرمت از پسوند یا پیشوند FMT:.
                             می‌تواند بیش از یک‌بار مشخص شود. در صورت عدم تعیین،
                             از $LEDGER_FILE یا $HOME/.hledger.journal خوانده می‌شود.
     \-\-rules=RULESFILE      استفاده از قواعد تعریف‌شده در این فایل قوانین برای
                             تبدیل فایل‌های CSV/SSV/TSV بعدی. در صورت عدم تعیین،
                             از FILE.csv.rules برای هر FILE.csv استفاده می‌کند.
     \-\-alias=A=B|/RGX/=RPL  تبدیل نام حساب‌ها از A به B، یا با
                             جایگزینی تطابق‌های عبارات باقاعده
     \-\-auto                 تولید ثبت‌های اضافی با اعمال قواعد ثبت خودکار
                             (\(dq=\(dq) بر روی تمامی تراکنش‌ها
     \-\-forecast[=PERIOD]    تولید تراکنش‌های اضافی از قواعد دوره‌ای
                             (\(dq\(ti\(dq)، از پس از آخرین تراکنش عادی
                             تا ۶ ماه آینده. یا در طول دوره (PERIOD) مشخص‌شده
                             (علامت مساوی الزامی است). قواعد ثبت خودکار نیز
                             بر این تراکنش‌ها اعمال خواهد شد. در
                             hledger\-ui همچنین تراکنش‌های آینده‌دار را در هنگام راه‌اندازی نمایان می‌کند.
  \-I \-\-ignore\-assertions    بررسی نکردن اعتبارسنجی ترازها (balance assertions) به‌طور پیش‌فرض
     \-\-txn\-balancing=...    نحوه بررسی تراز بودن تراکنش‌ها:
                             \(aqold\(aq:   استفاده از دقت نمایش عمومی
                             \(aqexact\(aq: استفاده از دقت تراکنش (پیش‌فرض)
     \-\-infer\-costs          استنتاج ثبتهای ارزش ویژه تبدیل از هزینه‌ها
     \-\-infer\-equity         استنتاج هزینه‌ها از ثبتهای ارزش ویژه تبدیل
     \-\-infer\-market\-prices  استنتاج قیمت‌های بازار از هزینه‌ها
     \-\-pivot=TAGNAME        استفاده از یک فیلد یا برچسب متفاوت به عنوان نام حساب‌ها
  \-s \-\-strict               انجام بررسی‌های خطای اضافی (و لغو \-I)
     \-\-verbose\-tags         افزودن برچسب‌هایی که داده‌های تولیدشده/تغییریافته را نشان می‌دهند

General output/reporting flags (supported by some commands):
  \-b \-\-begin=DATE           شامل شدن ثبت‌ها/تراکنش‌ها در/پس از این تاریخ
  \-e \-\-end=DATE             شامل شدن ثبت‌ها/تراکنش‌ها پیش از این تاریخ
                             (همراه با بازه گزارش، با پایان زیردوره بعدی تنظیم خواهد شد)
  \-D \-\-daily                گزارش چنددوره‌ای با بازه ۱ روزه
  \-W \-\-weekly               گزارش چنددوره‌ای با بازه ۱ هفته‌ای
  \-M \-\-monthly              گزارش چنددوره‌ای با بازه ۱ ماهه
  \-Q \-\-quarterly            گزارش چنددوره‌ای با بازه ۱ فصل (سه ماهه)
  \-Y \-\-yearly               گزارش چنددوره‌ای با بازه ۱ ساله
  \-p \-\-period=PERIODEXP     تنظیم تاریخ آغاز، تاریخ پایان، و/یا بازه گزارش
                             با انعطاف‌پذیری بیشتر
     \-\-today=DATE           بازنویسی تاریخ امروز (بر تاریخ‌های نسبی اثر می‌گذارد)
     \-\-date2                تطابق/استفاده از تاریخ‌های ثانویه به‌جای آن (منسوخ‌شده)
  \-U \-\-unmarked             شامل شدن تنها ثبت‌ها/تراکنش‌های بدون نشانه‌گذاری
  \-P \-\-pending              شامل شدن تنها ثبت‌ها/تراکنش‌های در انتظار (pending)
  \-C \-\-cleared              شامل شدن تنها ثبت‌ها/تراکنش‌های تسویه‌شده (cleared)
                             (امکان ترکیب \-U/\-P/\-C وجود دارد)
  \-R \-\-real                 شامل شدن تنها ثبت‌های غیرمجازی
  \-E \-\-empty                نمایش موارد صفر که به‌طور معمول پنهان هستند.
                             در hledger\-ui و hledger\-web برعکس عمل می‌کند.
     \-\-depth=DEPTHEXP       اگر عدد (یا NUM\-) باشد: نمایش تنها NUM سطح نخست
                             حساب‌ها. اگر REGEXP=NUM باشد، محدودیت تنها بر
                             حساب‌های منطبق با عبارت باقاعده اعمال می‌شود.
  \-B \-\-cost                 نمایش مبالغ تبدیل‌شده به بهای تمام‌شده/مبلغ فروش آنها
  \-V \-\-market               نمایش مبالغ تبدیل‌شده به ارزش آنها در پایان دوره(ها)
                             در کالای سنجش پیش‌فرض ارزش‌گذاری آنها.
                             معادل با \-\-value=end.
  \-X \-\-exchange=COMM        نمایش مبالغ تبدیل‌شده به ارزش آنها در پایان دوره(ها)
                             در کالای مشخص‌شده.
                             معادل با \-\-value=end,COMM.
     \-\-value=WHEN[,COMM]    نمایش مبالغ تبدیل‌شده به ارزش آنها در تاریخ(های) مشخص‌شده
                             در کالای پیش‌فرض ارزش‌گذاری یا یک کالای مشخص. WHEN می‌تواند موارد زیر باشد:
                             \(aqthen\(aq:     ارزش در تاریخ‌های تراکنش
                             \(aqend\(aq:      ارزش در پایان دوره(ها)
                             \(aqnow\(aq:      ارزش امروز
                             YYYY\-MM\-DD: ارزش در تاریخ داده‌شده
  \-c \-\-commodity\-style=S    بازنویسی شیوه نمایش یک کالا.
                             مثال: \-c \(aq.\(aq یا \-c \(aq1.000,00 EUR\(aq
     \-\-pretty[=YN]          استفاده از نویسه‌های رسم کادر در خروجی متنی؟ می‌تواند
                             \(aqy\(aq/\(aqyes\(aq یا \(aqn\(aq/\(aqno\(aq باشد.
                             در صورت مشخص شدن YN، علامت مساوی الزامی است.

General help flags:
  \-h \-\-help                 نمایش راهنمای خط فرمان
     \-\-tldr                 نمایش مثال‌های دستور با tldr
     \-\-info                 نمایش راهنما با info
     \-\-man                  نمایش راهنما با man
     \-\-version              نمایش اطلاعات نسخه
     \-\-debug=[1\-9]          نمایش این میزان خروجی اشکال‌زدایی (پیش‌فرض: 1)
     \-\-pager=YN             استفاده از صفحه‌بند (pager) در صورت نیاز؟ y/yes (پیش‌فرض) یا n/no
     \-\-color=YNA \-\-colour   استفاده از رنگ‌های ANSI؟ y/yes، n/no، یا auto (پیش‌فرض)
.EE
.PP
دستور hledger\-web حساب‌های با مانده صفر را به‌طور پیش‌فرض نشان می‌دهد (مشابه \f[CR]hledger\-ui\f[R] و برعکس \f[CR]hledger\f[R]).
استفاده از گزینه \f[CR]\-E/\-\-empty\f[R] این رفتار را معکوس می‌کند.
اگر حساب‌هایی را مشاهده می‌کنید که به نظر مانده صفر دارند اما با \f[CR]\-E\f[R] پنهان نمی‌شوند، به این دلیل است که مانده‌ای با بهای تمام‌شده مختلط دارند که وقتی هزینه‌ها پنهان باشند مانند صفر به نظر می‌رسد.
(دستور hledger\-web بهای تمام‌شده را نشان نمی‌دهد.)
.PP
گزینه‌های گزارش‌گیری و/یا آرگومان‌های پرس‌وجو (query) را می‌توان برای تنظیم یک پرس‌وجوی اولیه به کار برد که گرچه در رابط کاربری نمایش داده نمی‌شود، داده‌های نمایش‌داده‌شده را محدود می‌کند (علاوه بر هرگونه پرس‌وجوی جستجویی که در رابط کاربری وارد شود).
.PP
اگر از پوسته bash استفاده می‌کنید، می‌توانید با فشردن کلید TAB در خط فرمان، گزینه‌ها را به‌طور خودکار تکمیل کنید.
اگر این قابلیت کار نمی‌کند، به بخش Install > Shell completions مراجعه فرمایید.
.SH "مجوزها و سطوح دسترسی (PERMISSIONS)"
به‌طور پیش‌فرض، hledger\-web به هر کسی که بتواند به آن دسترسی داشته باشد اجازه می‌دهد ژورنال را مشاهده کرده و تراکنش‌های جدید بیفزاید، اما اجازه تغییر داده‌های موجود را نمی‌دهد.
.PP
می‌توانید افرادی را که به آن دسترسی دارند با روش‌های زیر محدود کنید:
.IP \(bu 2
تنظیم آدرس IP که برنامه بر روی آن شنود می‌کند (به \f[CR]\-\-host\f[R] در بالا مراجعه کنید).
به‌طور پیش‌فرض روی 127.0.0.1 شنود می‌کند که فقط برای کاربران رایانه محلی قابل دسترسی است.
.IP \(bu 2
قرار دادن آن پشت یک پراکسی احراز هویت، مانند caddy یا apache
.IP \(bu 2
قرار دادن آن پشت یک فایروال
.PP
و می‌توانید کارهایی را که کاربران متصل می‌توانند انجام دهند، با تعیین گزینه \f[CR]\-\-allow=ACCESSLEVEL\f[R] هنگام راه‌اندازی محدود کنید.
مقدار ACCESSLEVEL یکی از موارد زیر است:
.IP \(bu 2
\f[CR]view\f[R] \- اجازه مشاهده فایل(های) ژورنال را می‌دهد
.IP \(bu 2
\f[CR]add\f[R] \- همچنین اجازه افزودن تراکنش‌های جدید به فایل اصلی ژورنال را می‌دهد
.IP \(bu 2
\f[CR]edit\f[R] \- همچنین اجازه ویرایش، بارگذاری یا بارگیری فایل(های) ژورنال را می‌دهد
.IP \(bu 2
\f[CR]sandstorm\f[R] \- (برای برنامه Sandstorm مربوط به hledger\-web:) بسته به اینکه کدام‌یک از موارد \f[CR]view\f[R]، \f[CR]add\f[R] یا \f[CR]edit\f[R] در هدر HTTP به نام \f[CR]X\-Sandstorm\-Permissions\f[R] تعیین شده باشند، دسترسی می‌دهد
.PP
سطح دسترسی پیش‌فرض برابر \f[CR]add\f[R] است.
.SH "ویرایش، بارگذاری، بارگیری (EDITING, UPLOADING, DOWNLOADING)"
اگر قابلیت \f[CR]manage\f[R] ذکرشده در بالا را فعال کنید، یک دکمه جدید به شکل «آچار» در سمت راست فرم جستجو خواهید دید.
کلیک روی این دکمه به شما امکان می‌دهد فایل ژورنال یا هر فایلی را که شامل می‌شود، ویرایش، بارگذاری یا بارگیری کنید.
.PP
توجه داشته باشید که برخلاف هر دستور دیگر hledger، در این حالت شما (یا هر بیننده‌ای) می‌توانید فایل‌های داده را تغییر داده یا پاک کنید.
.PP
به‌طور معمول هر زمان که یک فایل از این طریق تغییر می‌کند، hledger\-web یک نسخه پشتیبان شماره‌گذاری‌شده ذخیره می‌کند (با فرض اینکه مجوزهای فایل اجازه دهند، دیسک پر نباشد، و غیره).
در حال حاضر hledger\-web از سیستم‌های کنترل نسخه آگاه نیست؛ اگر از یکی از آن‌ها استفاده می‌کنید، باید ترتیبی دهید که تغییرات را خودتان ثبت (commit) کنید (مثلاً با یک cron job یا ناظر فایل مانند entr).
.PP
تغییراتی که فایل(های) ژورنال را غیرقابل تجزیه یا نامعتبر سازند (مثلاً با شکست خوردن بررسی‌های تراز) مسدود می‌شوند.
(احتمالاً؛ این مورد نیاز به بررسی مجدد دارد.)
.SH "بارگذاری مجدد (RELOADING)"
دستور hledger\-web تغییرات ایجادشده در فایل‌ها با روش‌های دیگر را (مثلاً اگر آن را مستقیماً خارج از hledger\-web ویرایش کنید) تشخیص می‌دهد، و با بارگذاری مجدد صفحه یا رفتن به صفحه‌ای جدید، داده‌های تازه را نشان خواهد داد.
اگر تغییری باعث غیرقابل تجزیه شدن فایل شود، hledger\-web تا زمانی که فایل اصلاح شود یک پیام خطا نمایش می‌دهد.
.PP
(نکته: اگر فایل‌های مانت‌شده از ماشین دیگری را مشاهده می‌کنید، اطمینان حاصل کنید که ساعت‌های هر دو ماشین تقریباً با هم همگام باشند.)
.SH "رابط برنامه‌نویسی جی‌سان (JSON API)"
علاوه بر رابط کاربری وب، hledger\-web یک JSON API نیز ارائه می‌دهد که می‌توان از آن برای دریافت داده‌ها یا افزودن تراکنش‌های جدید استفاده کرد.
اگر فقط JSON API را می‌خواهید، می‌توانید از گزینه \f[CR]\-\-serve\-api\f[R] استفاده کنید.
مثال:
.IP
.EX
$ hledger\-web \-f examples/sample.journal \-\-serve\-api
\&...
.EE
.PP
می‌توانید داده‌های JSON را از این مسیرها دریافت کنید:
.IP
.EX
/version
/accountnames
/transactions
/prices
/commodities
/accounts
/accounttransactions/ACCOUNTNAME
.EE
.PP
برای مثال، تمام نام‌های حساب‌ها در ژورنال (مشابه دستور accounts).
(جی‌سان hledger\-web شامل خطوط جدید نیست؛ در اینجا از پایتون برای خواناتر کردن آن استفاده می‌کنیم):
.IP
.EX
$ curl \-s http://127.0.0.1:5000/accountnames | python \-m json.tool
[
    \(dqassets\(dq,
    \(dqassets:bank\(dq,
    \(dqassets:bank:checking\(dq,
    \(dqassets:bank:saving\(dq,
    \(dqassets:cash\(dq,
    \(dqexpenses\(dq,
    \(dqexpenses:food\(dq,
    \(dqexpenses:supplies\(dq,
    \(dqincome\(dq,
    \(dqincome:gifts\(dq,
    \(dqincome:salary\(dq,
    \(dqliabilities\(dq,
    \(dqliabilities:debts\(dq
]
.EE
.PP
یا تمام تراکنش‌ها:
.IP
.EX
$ curl \-s http://127.0.0.1:5000/transactions | python \-m json.tool
[
    {
        \(dqtcode\(dq: \(dq\(dq,
        \(dqtcomment\(dq: \(dq\(dq,
        \(dqtdate\(dq: \(dq2008\-01\-01\(dq,
        \(dqtdate2\(dq: null,
        \(dqtdescription\(dq: \(dqincome\(dq,
        \(dqtindex\(dq: 1,
        \(dqtpostings\(dq: [
            {
                \(dqpaccount\(dq: \(dqassets:bank:checking\(dq,
                \(dqpamount\(dq: [
                    {
                        \(dqacommodity\(dq: \(dq$\(dq,
                        \(dqaismultiplier\(dq: false,
                        \(dqaprice\(dq: null,
\&...
.EE
.PP
بخش عمده JSON متناظر با انواع داده hledger است؛ برای جزئیات در مورد معنای فیلدها، به مستندات haddock مربوط به Hledger.Data.Json مراجعه کرده و روی انواع مختلف داده مانند Transaction کلیک کنید.
و برای درک در سطحی بالاتر، مستندات ژورنال را ببینید.
یک مشخصات پایه OpenAPI نیز وجود دارد.
.PP
در برخی موارد یک JSON بیرونی متناظر با نوع داده \(dqReport\(dq وجود دارد.
برای درک آن، به haddock مربوط به Hledger.Web.Handler.MiscR مراجعه کرده و به کد منبع هندلر مربوطه نگاه کنید تا ببینید چه چیزی برمی‌گرداند.
برای مثال در مورد \f[CR]/accounttransactions\f[R]، این تابع getAccounttransactionsR است که یک \(dq\f[CR]accountTransactionsReport ...\f[R]\(dq برمی‌گرداند.
با بررسی haddock برای آن می‌بینیم که accounttransactions/ یک AccountTransactionsReport برمی‌گرداند که از یک عنوان گزارش و فهرستی از AccountTransactionsReportItem (و غیره) تشکیل شده است.
.PP
می‌توانید با یک درخواست PUT به \f[CR]/add\f[R]، تراکنش جدیدی به ژورنال اضافه کنید، به شرطی که hledger\-web با قابلیت \f[CR]add\f[R] راه‌اندازی شده باشد (که به‌طور پیش‌فرض فعال است).
بدنه داده (payload) باید نمایش JSON کامل و دقیق یک تراکنش hledger باشد (داده‌های ناقص پذیرفته نمی‌شوند).
می‌توانید نمونه JSON را از \f[CR]/transactions\f[R] یا \f[CR]/accounttransactions\f[R] در hledger\-web دریافت کنید، یا با hledger\-lib صادر نمایید، به عنوان مثال:
.IP
.EX
\&.../hledger$ stack ghci hledger\-lib
>>> writeJsonFile \(dqtxn.json\(dq (head $ jtxns samplejournal)
>>> :q
.EE
.PP
در اینجا نمونه ساختار آن در نسخه hledger\-1.17 آورده شده است (به یاد داشته باشید این JSON متناظر با Transaction و انواع داده مرتبط در hledger است):
.IP
.EX
{
    \(dqtcomment\(dq: \(dq\(dq,
    \(dqtpostings\(dq: [
        {
            \(dqpbalanceassertion\(dq: \f[B]null\f[R],
            \(dqpstatus\(dq: \(dqUnmarked\(dq,
            \(dqpamount\(dq: [
                {
                    \(dqaprice\(dq: \f[B]null\f[R],
                    \(dqacommodity\(dq: \(dq$\(dq,
                    \(dqaquantity\(dq: {
                        \(dqfloatingPoint\(dq: 1,
                        \(dqdecimalPlaces\(dq: 10,
                        \(dqdecimalMantissa\(dq: 10000000000
                    },
                    \(dqaismultiplier\(dq: \f[B]false\f[R],
                    \(dqastyle\(dq: {
                        \(dqascommodityside\(dq: \(dqL\(dq,
                        \(dqasdigitgroups\(dq: \f[B]null\f[R],
                        \(dqascommodityspaced\(dq: \f[B]false\f[R],
                        \(dqasprecision\(dq: 2,
                        \(dqasdecimalpoint\(dq: \(dq.\(dq
                    }
                }
            ],
            \(dqptransaction_\(dq: \(dq1\(dq,
            \(dqpaccount\(dq: \(dqassets:bank:checking\(dq,
            \(dqpdate\(dq: \f[B]null\f[R],
            \(dqptype\(dq: \(dqRegularPosting\(dq,
            \(dqpcomment\(dq: \(dq\(dq,
            \(dqpdate2\(dq: \f[B]null\f[R],
            \(dqptags\(dq: [],
            \(dqporiginal\(dq: \f[B]null\f[R]
        },
        {
            \(dqpbalanceassertion\(dq: \f[B]null\f[R],
            \(dqpstatus\(dq: \(dqUnmarked\(dq,
            \(dqpamount\(dq: [
                {
                    \(dqaprice\(dq: \f[B]null\f[R],
                    \(dqacommodity\(dq: \(dq$\(dq,
                    \(dqaquantity\(dq: {
                        \(dqfloatingPoint\(dq: \-1,
                        \(dqdecimalPlaces\(dq: 10,
                        \(dqdecimalMantissa\(dq: \-10000000000
                    },
                    \(dqaismultiplier\(dq: \f[B]false\f[R],
                    \(dqastyle\(dq: {
                        \(dqascommodityside\(dq: \(dqL\(dq,
                        \(dqasdigitgroups\(dq: \f[B]null\f[R],
                        \(dqascommodityspaced\(dq: \f[B]false\f[R],
                        \(dqasprecision\(dq: 2,
                        \(dqasdecimalpoint\(dq: \(dq.\(dq
                    }
                }
            ],
            \(dqptransaction_\(dq: \(dq1\(dq,
            \(dqpaccount\(dq: \(dqincome:salary\(dq,
            \(dqpdate\(dq: \f[B]null\f[R],
            \(dqptype\(dq: \(dqRegularPosting\(dq,
            \(dqpcomment\(dq: \(dq\(dq,
            \(dqpdate2\(dq: \f[B]null\f[R],
            \(dqptags\(dq: [],
            \(dqporiginal\(dq: \f[B]null\f[R]
        }
    ],
    \(dqttags\(dq: [],
    \(dqtsourcepos\(dq: {
        \(dqtag\(dq: \(dqJournalSourcePos\(dq,
        \(dqcontents\(dq: [
            \(dq\(dq,
            [
                1,
                1
            ]
        ]
    },
    \(dqtdate\(dq: \(dq2008\-01\-01\(dq,
    \(dqtcode\(dq: \(dq\(dq,
    \(dqtindex\(dq: 1,
    \(dqtprecedingcomment\(dq: \(dq\(dq,
    \(dqtdate2\(dq: \f[B]null\f[R],
    \(dqtdescription\(dq: \(dqincome\(dq,
    \(dqtstatus\(dq: \(dqUnmarked\(dq
}
.EE
.PP
و در اینجا نحوه آزمایش افزودن آن با curl آمده است.
این دستور باید ورودی جدیدی به ژورنال شما بیفزاید:
.IP
.EX
$ curl http://127.0.0.1:5000/add \-X PUT \-H \(aqContent\-Type: application/json\(aq \-\-data\-binary \(attxn.json
.EE
.SH "خروجی اشکال‌زدایی (DEBUG OUTPUT)"
.SS "خروجی اشکال‌زدایی"
می‌توانید \f[CR]\-\-debug[=N]\f[R] را به خط فرمان اضافه کنید تا خروجی اشکال‌زدایی ثبت شود.
مقدار N از ۱ (کمترین خروجی، پیش‌فرض) تا ۹ (بیشترین خروجی) است.
به‌طور معمول با ۱ شروع می‌کنید و آن را افزایش می‌دهید تا زمانی که خروجی کافی را مشاهده کنید.
خروجی اشکال‌زدایی به stderr ارسال می‌شود و با درخواست‌های ثبت‌شده در stdout آمیخته می‌گردد.
برای ثبت خروجی اشکال‌زدایی در یک فایل لاگ به‌جای ترمینال، معمولاً می‌توانید stderr را هدایت کنید، به عنوان مثال:
.PD 0
.P
.PD
\f[CR]hledger\-web \-\-debug=3 2>hledger\-web.log\f[R].
.SH "محیط (ENVIRONMENT)"
\f[B]LEDGER_FILE\f[R] فایل اصلی ژورنال برای استفاده در زمانی که با \f[CR]\-f/\-\-file\f[R] مشخص نشده باشد.
پیش‌فرض: \f[CR]$HOME/.hledger.journal\f[R].
.SH "اشکالات (BUGS)"
ما از گزارش‌های اشکال در سامانه رهگیری باگ‌های hledger
(https://bugs.hledger.org)، یا در چت یا لیست پستی hledger
(https://hledger.org/support) استقبال می‌کنیم.
.PP
برخی مسائل شناخته‌شده:
.PP
روی نمایشگرهای کوچک یا در مرورگرهای متنی به خوبی کار نمی‌کند.


.SH "نویسندگان (AUTHORS)"
Simon Michael <simon@joyful.com> و مشارکت‌کنندگان.
.br
به پیوند http://hledger.org/CREDITS.html مراجعه کنید.

.SH "حق نشر (COPYRIGHT)"
حق نشر 2007-2023 متعلق به Simon Michael و مشارکت‌کنندگان است.

.SH "مجوز (LICENSE)"
تحت مجوز GNU GPL نسخه ۳ یا بالاتر منتشر شده است.

.SH "همچنین ببینید (SEE ALSO)"
hledger(1), hledger\-ui(1), hledger\-web(1), ledger(1)