نام (NAME)

hledger-ui - واسط کاربری متنی پایانه‌ای برای hledger، یک برنامه حسابداری متن ساده قدرتمند و کاربرپسند

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

hledger-ui [OPTS] [QUERYARGS]

یا

hledger ui [OPTS] [QUERYARGS]

توضیحات (DESCRIPTION)

این راهنما برای واسط کاربری پایانه‌ای hledger، نسخه 1.52 است. برای مفاهیم مشترک و قالب‌های فایل، به راهنمای اصلی hledger نیز مراجعه کنید.

برنامه hledger مجموعه‌ای قدرتمند، کاربرپسند و چندسکویی از ابزارها برای ردیابی پول، زمان یا هر دارایی دیگر با استفاده از حسابداری دوطرفه و یک قالب فایل ساده و قابل ویرایش است. برنامه hledger از ledger(1) الهام گرفته و تا حد زیادی با آن سازگار است، و همچنین تا حد زیادی با beancount(1) قابلیت تبدیل متقابل دارد.

ابزار hledger-ui واسط کاربری پایانه‌ای hledger است که یک واسط متنی تمام‌صفحه و کارآمد را برای مشاهده حساب‌ها و تراکنش‌ها و برخی قابلیت‌های محدود ورود داده ارائه می‌دهد. استفاده از آن نسبت به واسط خط فرمان hledger ساده‌تر است و گاهی از واسط وب سریع‌تر و راحت‌تر است.

مانند hledger، این برنامه داده‌ها را از یک فایل دفتر روزنامه که توسط متغیر محیطی LEDGER_FILE مشخص شده می‌خواند (و به آن اضافه می‌کند) (با مقدار پیش‌فرض $HOME/.hledger.journal)؛ یا می‌توانید فایل‌ها را با گزینه‌های -f مشخص کنید. این ابزار همچنین می‌تواند فایل‌های timeclock، فایل‌های timedot یا هر فایل CSV/SSV/TSV دارای فیلد تاریخ را بخواند. (برای جزئیات بیشتر به بخش Input در hledger(1) مراجعه کنید.)

برخلاف hledger، برنامه hledger-ui به طور پیش‌فرض تمام تراکنش‌های دارای تاریخ آینده را پنهان می‌کند. این تراکنش‌ها، همراه با هرگونه تراکنش دوره‌ای تولیدشده بر اساس قوانین، با فشردن کلید F (یا شروع با --forecast) برای فعال‌سازی «حالت پیش‌بینی (forecast mode)» قابل مشاهده هستند.

گزینه‌ها (OPTIONS)

هر آرگومانی به عنوان یک پرس‌وجوی hledger تفسیر می‌شود که داده‌ها را فیلتر می‌کند. برنامه hledger-ui گزینه‌های زیر را فراهم می‌کند:

فلگ‌ها:
  -w --watch                پایش تغییرات داده‌ها و تاریخ و بارگذاری مجدد خودکار
     --theme=THEME          استفاده از این پوسته نمایش سفارشی (light، dark، terminal، greenterm)
     --cash                 شروع در صفحه حساب‌های نقدینگی
     --bs                   شروع در صفحه حساب‌های ترازنامه
     --is                   شروع در صفحه حساب‌های صورت سود و زیان
     --all                  شروع در صفحه همه حساب‌ها
     --register=ACCTREGEX   شروع در دفتر روزنامه (نخستین منطبق) حساب
     --change               نمایش مانده‌های دوره (تغییرات) در هنگام راه‌اندازی به جای مانده‌های تاریخی
  -l --flat                 نمایش حساب‌ها به صورت فهرست مسطح (پیش‌فرض)
  -t --tree                 نمایش حساب‌ها به صورت درختی

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

فلگ‌های عمومی تبدیل داده/ورودی:
  -f --file=[FMT:]FILE      خواندن داده‌ها از FILE، یا از stdin اگر FILE برابر - باشد،
                            با تشخیص خودکار قالب از روی پسوند یا پیشوند :FMT.
                            می‌تواند بیش از یک بار مشخص شود. اگر مشخص نشود،
                            از $LEDGER_FILE یا $HOME/.hledger.journal خوانده می‌شود.
     --rules=RULESFILE      استفاده از قوانین تعریف‌شده در این فایل قوانین برای
                            تبدیل فایل‌های CSV/SSV/TSV بعدی. در صورت عدم تعیین،
                            برای هر FILE.csv از FILE.csv.rules استفاده می‌شود.
     --alias=A=B|/RGX/=RPL  تبدیل نام حساب‌ها از A به B، یا با
                            جایگزینی مطابقت‌های عبارت باقاعده
     --auto                 تولید ثبت‌های اضافی با اعمال قوانین ثبت خودکار
                            ("=") روی تمام تراکنش‌ها
     --forecast[=PERIOD]    تولید تراکنش‌های اضافی از قوانین دوره‌ای
                            ("~")، از پس از آخرین تراکنش عادی
                            تا ۶ ماه آینده. یا در طول دوره (PERIOD) مشخص‌شده
                            (علامت مساوی الزامی است). قوانین ثبت خودکار
                            روی این تراکنش‌ها نیز اعمال خواهد شد. در
                            hledger-ui، همچنین تراکنش‌های دارای تاریخ آینده را در هنگام راه‌اندازی نمایان می‌کند.
  -I --ignore-assertions    بررسی نکردن پیش‌فرض اعتبارسنجی‌های مانده
     --txn-balancing=...    نحوه بررسی تراز بودن تراکنش‌ها:
                            'old':   استفاده از دقت نمایش سراسری
                            'exact': استفاده از دقت تراکنش (پیش‌فرض)
     --infer-costs          استنتاج ثبت‌های ارزش ویژه تبدیل از هزینه‌ها
     --infer-equity         استنتاج هزینه‌ها از ثبت‌های ارزش ویژه تبدیل
     --infer-market-prices  استنتاج قیمت‌های بازار از هزینه‌ها
     --pivot=TAGNAME        استفاده از فیلد یا برچسب دیگر به عنوان نام حساب‌ها
  -s --strict               انجام بررسی‌های خطای اضافی (و لغو -I)
     --verbose-tags         افزودن برچسب‌های نشان‌دهنده داده‌های تولید/تغییریافته
فلگ‌های عمومی گزارش‌گیری/خروجی (پشتیبانی‌شده در برخی دستورات):
  -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              فقط شامل شدن ثبت‌ها/تراکنش‌های در انتظار
  -C --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 می‌تواند این موارد باشد:
                            'then':     ارزش در تاریخ‌های تراکنش
                            'end':      ارزش در پایان دوره(ها)
                            'now':      ارزش امروز
                            YYYY-MM-DD: ارزش در تاریخ داده‌شده
  -c --commodity-style=S    بازنویسی سبک نمایش یک کالا/واحد پول.
                            مثال: -c '.' یا -c '1.000,00 EUR'
     --pretty[=YN]          استفاده از نویسه‌های کادرسازی در خروجی متنی؟ می‌تواند
                            'y'/'yes' یا 'n'/'no' باشد.
                            در صورت تعیین YN، علامت مساوی الزامی است.
فلگ‌های عمومی راهنما:
  -h --help                 نمایش راهنمای خط فرمان
     --tldr                 نمایش مثال‌های دستور با tldr
     --info                 نمایش راهنما با info
     --man                  نمایش راهنما با man
     --version              نمایش اطلاعات نسخه
     --debug=[1-9]          نمایش این مقدار خروجی اشکال‌زدایی (پیش‌فرض: 1)
     --pager=YN             استفاده از صفحه‌بندی‌کننده در صورت نیاز؟ y/yes (پیش‌فرض) یا n/no
     --color=YNA --colour   استفاده از رنگ ANSI؟ y/yes، n/no، یا auto (پیش‌فرض)

در برنامه hledger-ui، گزینه --debug خروجی اشکال‌زدایی را به یک فایل hledger-ui.log در دایرکتوری جاری ارسال می‌کند.

اگر از پوسته bash استفاده می‌کنید، می‌توانید با فشردن کلید TAB در خط فرمان گزینه‌ها را به صورت خودکار تکمیل کنید. در صورت کار نکردن، به بخش Install > Shell completions مراجعه فرمایید.

ماوس (MOUSE)

در بیشتر پایانه‌های مدرن، می‌توانید با ماوس یا تاچ‌پد میان صفحه‌ها پیمایش کنید:

استفاده از چرخ ماوس یا ترک‌پد برای اسکرول به بالا و پایین
کلیک روی موارد فهرست برای رفتن به عمق بیشتر
کلیک روی حاشیه سمت چپ (ستون ۰) برای بازگشت به عقب.

کلیدها (KEYS)

صفحه‌کلید کنترل بیشتری فراهم می‌کند.

کلید ? یک پنجره راهنما شامل فهرست تمام کلیدها را نشان می‌دهد. (برخی از این موارد در راهنمای سریع پایین هر صفحه نیز نمایش داده می‌شوند.) کلید ? را دوباره فشار دهید (یا ESCAPE، یا LEFT، یا q) تا بسته شود. کلیدهای زیر در بیشتر صفحه‌ها کار می‌کنند:

کلیدهای جهت‌نما پیمایش می‌کنند: RIGHT یا ENTER به سطح عمیق‌تر می‌رود، LEFT به صفحه قبلی بازمی‌گردد، UP/DOWN/PGUP/PGDN/HOME/END در میان فهرست‌ها به بالا و پایین حرکت می‌کنند. کلیدهای J/K در هر بار ۱۰ مورد به پایین/بالا می‌پرند. کلیدهای حرکتی سبک ایمکس (CTRL-p/CTRL-n/CTRL-f/CTRL-b) و سبک وی‌آی (k، j، l، h) نیز پشتیبانی می‌شوند.

(نکته: سرعت حرکت با نرخ تکرار صفحه‌کلید شما محدود می‌شود؛ برای حرکت سریع‌تر ممکن است بخواهید آن را تنظیم کنید. در مک، برنامه Karabiner یکی از راه‌های انجام این کار است.)

کلید / به شما امکان می‌دهد با استفاده از عبارات پرس‌وجوی مشابه hledger و hledger-web، یک پرس‌وجوی فیلتر عمومی برای محدود کردن داده‌های نمایش‌داده‌شده تنظیم کنید. هنگام ویرایش پرس‌وجو، می‌توانید از CTRL-a/e/d/k، کلید BS و کلیدهای جهت‌نما استفاده کنید؛ کلید ENTER را برای اعمال آن، یا ESCAPE را برای لغو فشار دهید. همچنین کلیدهایی برای تنظیم سریع برخی فیلترهای متداول مانند عمق حساب و وضعیت تراکنش وجود دارد (به زیر مراجعه کنید). کلید BACKSPACE یا DELETE تمام فیلترها را حذف کرده و همه تراکنش‌ها را نشان می‌دهد.

همان‌طور که در بالا ذکر شد، hledger-ui به طور پیش‌فرض تراکنش‌های آینده را پنهان می‌کند - هم تراکنش‌های عادی ثبت‌شده در دفتر روزنامه و هم تراکنش‌های دوره‌ای تولیدشده توسط قانون. کلید F حالت پیش‌بینی را تغییر می‌دهد که در آن تراکنش‌های آینده/پیش‌بینی‌شده نمایش داده می‌شوند.

فشردن SHIFT-DOWN دوره گزارش را محدودتر (کوچک‌تر) می‌کند و فشردن SHIFT-UP آن را دوباره گسترش می‌دهد. در حالت محدودشده، دوره گزارش جاری در سطر سربرگ نمایش داده می‌شود؛ فشردن SHIFT-LEFT یا SHIFT-RIGHT به دوره قبلی یا بعدی می‌رود و فشردن T دوره را روی «امروز (today)» تنظیم می‌کند. اگر از -w/--watch استفاده می‌کنید و دوره‌ای محدودشده شامل امروز را مشاهده می‌کنید، نما از هرگونه تغییر در تاریخ سیستم پیروی خواهد کرد (به دوره‌ای که شامل تاریخ جدید است جابه‌جا می‌شود). (این کلیدها فقط با دوره‌های تقویم میلادی استاندارد سال/فصل/ماه/هفته/روز کار می‌کنند؛ آن‌ها تحت تأثیر بازه گزارش سفارشی مشخص‌شده در خط فرمان قرار نمی‌گیرند.)

همچنین می‌توانید یک دوره غیر استاندارد را با / و یک پرس‌وجوی date: مشخص کنید؛ در این حالت، دوره با کلیدهای جهت‌نما قابل جابه‌جایی نیست.

(نکته: کلیدهای جهت‌نما همراه با Shift در تمام نرم‌افزارهای پایانه به صورت پیش‌فرض کار نمی‌کنند. برای مثال در Terminal اپل، کلیدهای SHIFT-DOWN و SHIFT-UP باید به صورت زیر پیکربندی شوند: در تنظیمات Terminal، روی Profiles کلیک کنید، پروفایل جاری خود را در سمت چپ انتخاب کنید، روی Keyboard در سمت راست کلیک کنید، روی + کلیک کنید و برای SHIFT-DOWN این مقدار را اضافه کنید: \033[1;2B، روی + کلیک کنید و برای SHIFT-UP این مقدار را اضافه کنید: \033[1;2A. در پایانه‌های دیگر (مانند Windows Terminal) ممکن است نیاز داشته باشید SHIFT-RIGHT و SHIFT-LEFT را به ترتیب برای ارسال \033[1;2C و \033[1;2D پیکربندی کنید.)

کلید ESCAPE وضعیت واسط کاربری را بازنشانی کرده و به بالاترین صفحه بازمی‌گردد و وضعیت اولیه برنامه در هنگام راه‌اندازی را بازیابی می‌کند. یا اینکه ورود داده در مینی‌بافر یا پنجره راهنما را لغو می‌کند.

کلید CTRL-l صفحه را بازترسیم می‌کند و در صورت امکان مورد انتخاب‌شده را در مرکز قرار می‌دهد (موارد نزدیک به بالا وسط‌چین نخواهند شد، زیرا به بالای سطر اول اسکرول نمی‌کنیم).

کلید g داده‌ها را از فایل(های) داده دوباره بارگذاری کرده و صفحه جاری و صفحه‌های قبلی را به‌روزرسانی می‌کند. (در فایل‌های بزرگ، این کار ممکن است مکث محسوسی ایجاد کند.)

کلید I بررسی اعتبارسنجی مانده را فعال/غیرفعال می‌کند. غیرفعال کردن موقت اعتبارسنجی‌های مانده می‌تواند برای عیب‌یابی مفید باشد. (اگر hledger-ui با گزینه --pivot شروع شده باشد، فعال‌سازی مجدد اعتبارسنجی مانده با کلید I دفتر روزنامه را نیز مانند g مجدداً بارگذاری می‌کند.)

کلید a دستور add از خط فرمان hledger را اجرا کرده و فایل به‌روزرسانی‌شده را دوباره بارگذاری می‌کند. این امکان مقداری ورود داده اولیه را فراهم می‌سازد.

کلید A مشابه a است، اما ابزار hledger-iadd را اجرا می‌کند که واسط کاربری پایانه‌ای تعاملی ارائه می‌دهد. این کلید در صورتی در دسترس خواهد بود که hledger-iadd در مسیر $PATH نصب شده باشد.

کلید E ویرایشگر تعیین‌شده در $HLEDGER_UI_EDITOR یا $EDITOR یا ویرایشگر پیش‌فرض (emacsclient -a "" -nw) را روی فایل دفتر روزنامه اجرا می‌کند. در برخی ویرایشگرها (emacs، vi)، در صورت فراخوانی از صفحه‌های دفتر روزنامه و تراکنش، مکان‌نما روی تراکنش جاری قرار می‌گیرد و در صورت فراخوانی از صفحه خطا، در محل خطا (در صورت امکان) قرار خواهد گرفت.

کلید B حالت هزینه را تغییر می‌دهد و مبالغ تبدیل‌شده به واحد بهای تمام‌شده را نشان می‌دهد (به بخش Cost reporting در راهنمای hledger مراجعه کنید).

کلید V حالت ارزش را تغییر می‌دهد و مبالغ تبدیل‌شده به ارزش بازار آن‌ها را نشان می‌دهد (به بخش Valuation flag در راهنمای hledger مراجعه کنید). به طور دقیق‌تر،

1.: به طور پیش‌فرض، کلید V نمایش ارزش پایانی (--value=end) را روشن یا خاموش می‌کند. تاریخ ارزشیابی در صورت تعیین، تاریخ پایان گزارش و در غیر این صورت امروز خواهد بود.
2.: اگر hledger-ui را با ارزشیابی دیگری راه‌اندازی کرده باشید (مانند --value=then,EUR)، کلید V آن را خاموش یا روشن می‌کند.

نکات هزینه/ارزش: - هنگام نمایش ارزش پایانی، می‌توانید تاریخ پایان گزارش را بدون راه‌اندازی مجدد، با فشردن / و افزودن پرس‌وجویی مانند date:..YYYY-MM-DD تغییر دهید. - حالت هزینه یا حالت ارزش می‌توانند فعال باشند، اما نه هر دو همزمان. حالت هزینه اولویت دارد. - هنوز هیچ نشانگر بصری برای فعال بودن حالت هزینه یا ارزش به جز مقادیر مبالغ وجود ندارد.

کلید q از برنامه خارج می‌شود.

کلیدهای اختصاصی صفحه‌های دیگر در زیر توضیح داده شده‌اند.

صفحه‌ها (SCREENS)

در هنگام راه‌اندازی، hledger-ui به طور پیش‌فرض صفحه منو را نشان می‌دهد. از اینجا می‌توانید با استفاده از کلیدهای جهت‌نما به سایر صفحه‌ها بروید: UP/DOWN برای انتخاب، RIGHT برای رفتن به صفحه انتخاب‌شده، LEFT برای بازگشت به صفحه قبلی. یا می‌توانید از ESC برای بازگشت مستقیم به صفحه منوی اصلی استفاده کنید.

همچنین می‌توانید از یک فلگ خط فرمان برای مشخص کردن صفحه شروع متفاوت استفاده کنید (--cs، --bs، --is، --all، یا --register=ACCT).

صفحه منو (Menu screen)

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

صفحه حساب‌های نقدینگی (Cash accounts screen)

این صفحه حساب‌های «نقدینگی» (یعنی دارایی‌های نقد) را نشان می‌دهد (مشابه hledger balancesheet type:c). همیشه مانده‌ها را نشان می‌دهد (مانده‌های پایانی تاریخی در تاریخی که در سطر عنوان نشان داده شده است).

صفحه حساب‌های ترازنامه (Balance sheet accounts screen)

این صفحه حساب‌های دارایی، بدهی و ارزش ویژه/حقوق صاحبان سهام را نشان می‌دهد (مشابه hledger balancesheetequity). همیشه مانده‌ها را نشان می‌دهد.

صفحه حساب‌های صورت سود و زیان (Income statement accounts screen)

این صفحه حساب‌های درآمد و هزینه را نشان می‌دهد (مشابه hledger incomestatement). همیشه تغییرات را نشان می‌دهد (تغییرات مانده در دوره نشان‌داده‌شده در سطر عنوان).

صفحه همه حساب‌ها (All accounts screen)

این صفحه همه حساب‌های موجود در دفتر روزنامه شما را نشان می‌دهد (مگر اینکه توسط یک پرس‌وجو فیلتر شده باشد؛ مشابه hledger balance). به طور پیش‌فرض مانده‌ها را نشان می‌دهد؛ می‌توانید با کلید H نمایش تغییرات را تغییر وضعیت دهید.

صفحه دفتر روزنامه حساب (Register screen)

این صفحه تراکنش‌های مؤثر بر یک حساب خاص را نشان می‌دهد. هر سطر نشان‌دهنده یک تراکنش است و موارد زیر را نمایش می‌دهد:

حساب(های) دیگر درگیر در تراکنش، به صورت مختصر. (اگر هم ثبت‌های واقعی و هم مجازی وجود داشته باشد، فقط حساب‌های متأثر از ثبت‌های واقعی را نشان می‌دهد.)
تغییر کلی در مانده حساب جاری؛ مقدار مثبت برای ورود به این حساب و منفی برای خروج.
مجموع جاری پس از تراکنش. با کلید H می‌توانید بین موارد زیر تغییر وضعیت دهید:

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

توجه داشته باشید، این صفحه ثبت‌های درون دوره هر تراکنش را در یک قلم تک‌سطری با تاریخ اولیه تراکنش یا تاریخ ثبت درون دوره ترکیب می‌کند (مانند aregister در hledger). بنابراین تاریخ‌های ثبت سفارشی می‌توانند باعث شوند مانده جاری موقتاً غیردقیق باشد. (به بخش aregister and posting dates در راهنمای hledger مراجعه کنید.)

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

کلید U فیلتر بر اساس وضعیت بدون علامت را تغییر می‌دهد و تراکنش‌های بدون علامت را نشان می‌دهد یا پنهان می‌کند. به طور مشابه، P تراکنش‌های در انتظار و C تراکنش‌های تسویه‌شده را تغییر وضعیت می‌دهد. (به طور پیش‌فرض، تراکنش‌ها با تمام وضعیت‌ها نمایش داده می‌شوند؛ اگر یک یا دو فیلتر وضعیت را فعال کنید، فقط آن تراکنش‌ها نمایش داده می‌شوند؛ و اگر هر سه را فعال کنید، فیلتر حذف می‌شود.)

کلید R حالت واقعی را تغییر می‌دهد که در آن ثبت‌های مجازی نادیده گرفته می‌شوند.

کلید z حالت غیر صفر را تغییر می‌دهد که در آن فقط تراکنش‌هایی که تغییری غیر صفر ثبت می‌کنند نشان داده می‌شوند (hledger-ui برخلاف خط فرمان hledger به طور پیش‌فرض موارد صفر را نشان می‌دهد).

برای مشاهده تراکنش انتخاب‌شده با جزئیات کامل، کلید RIGHT را فشار دهید.

صفحه تراکنش (Transaction screen)

این صفحه یک تراکنش منفرد را به صورت یک ثبت عمومی دفتر روزنامه، مشابه دستور print و قالب دفتر روزنامه hledger (hledger_journal(5)) نشان می‌دهد.

تاریخ(های) تراکنش و هرگونه فلگ تسویه‌شده، کد تراکنش، توضیحات، یادداشت‌ها، همراه با تمام ثبت‌های حساب آن نمایش داده می‌شوند. تراکنش‌های ساده دو ثبت دارند، اما می‌توانند بیشتر (یا در موارد خاص، کمتر) باشند.

کلیدهای UP و DOWN در میان تمام تراکنش‌های فهرست‌شده در صفحه قبلی دفتر روزنامه حساب حرکت می‌کنند. در نوار عنوان، اعداد درون پرانتز موقعیت شما را در آن دفتر روزنامه حساب نشان می‌دهند. این اعداد بسته به اینکه از کدام دفتر روزنامه حساب آمده‌اید متفاوت خواهند بود (به یاد داشته باشید بیشتر تراکنش‌ها در چندین دفتر روزنامه حساب ظاهر می‌شوند). شماره N# پیش از آن‌ها، موقعیت تراکنش را در کل دفتر روزنامه فیلترنشده نشان می‌دهد که یک شناسه پایدارتر است (حداقل تا بارگذاری مجدد بعدی).

در این صفحه (و صفحه دفتر روزنامه)، کلید E ویرایشگر متن شما را باز می‌کند و مکان‌نما در صورت امکان روی تراکنش جاری قرار می‌گیرد.

صفحه خطا (Error screen)

اگر هنگام فشردن g برای بارگذاری مجدد مشکلی مانند خطای تجزیه رخ دهد، این صفحه ظاهر می‌شود. پس از رفع مشکل، دوباره g را فشار دهید تا بارگذاری مجدد انجام شده و عملکرد عادی از سر گرفته شود. (یا می‌توانید escape را فشار دهید تا تلاش برای بارگذاری مجدد لغو شود.)

حالت پایش (WATCH MODE)

یکی از بهترین ویژگی‌های hledger-ui حالت بارگذاری خودکار -w/--watch است. با این فلگ، هر زمان که تغییراتی در فایل‌های داده ذخیره شود، صفحه نمایش به طور خودکار به‌روزرسانی می‌شود.

این ویژگی هنگام مغایرت‌گیری و تطبیق حساب‌ها بسیار کاربردی است. یک گردش کار مناسب این است که دفتر روزنامه آنلاین بانک خود را برای مرجع در یک پنجره مرورگر باز داشته باشید؛ فایل دفتر روزنامه را در یک پنجره ویرایشگر باز نگه دارید؛ و hledger-ui را در حالت پایش در پنجره پایانه اجرا کنید، مانند:

$ hledger-ui --watch --register checking -C

همان‌طور که موارد را در ویرایشگر به عنوان تسویه‌شده علامت می‌زنید، می‌توانید اثر آن را بلافاصله بدون نیاز به تعویض محیط مشاهده کنید. این کار تمرکز ذهنی بیشتری برای حسابداری شما باقی می‌گذارد. البته همچنان می‌توانید در صورت نیاز با hledger-ui تعامل داشته باشید، مثلاً برای تغییر حالت تسویه‌شده یا بررسی تاریخچه.

مشکلات --watch

با این حال، محدودیت‌ها/اشکالات حل‌نشده‌ای در --watch وجود دارد:

بسته به پلتفرم یا پیکربندی سیستم، ممکن است اصلاً برای شما کار نکند. در برخی سیستم‌های یونیکس، افزایش پارامترهای fs.inotify.max_user_watches یا fs.file-max در /etc/sysctl.conf ممکن است کمک کند. (#836)
ممکن است تغییرات اعمال‌شده از خارج یک ماشین مجازی (یعنی توسط ویرایشگری که روی سیستم میزبان اجرا می‌شود) را تشخیص ندهد.
ممکن است تغییرات فایل را در برخی فایل‌سیستم‌های کمتر رایج تشخیص ندهد.
ممکن است با گذشت زمان، به‌ویژه در فایل‌های بزرگ، مصرف CPU و RAM افزایش یابد. (این مشکل احتمالاً مختص --watch نیست و ممکن است با فشردن مکرر g بتوانید آن را بازتولید کنید.) (#1825)

نکات/راهکارها:

اگر --watch برای شما کار نمی‌کند، کلید g را فشار دهید تا داده‌ها به صورت دستی بازنشانی شوند.
اگر --watch با گذشت زمان دچار نشت منابع می‌شود، زمانی که از hledger-ui استفاده نمی‌کنید آن را بسته و مجدداً راه‌اندازی کنید (یا به حالت تعلیق درآورده و ادامه دهید).
هنگام اجرای hledger-ui درون یک ماشین مجازی، تغییرات فایل را نیز درون همان ماشین مجازی اعمال کنید.
هنگام کار با فایل‌های مانت‌شده از ماشینی دیگر، مطمئن شوید ساعت‌های سیستم در هر دو ماشین تقریباً همگام باشند.

محیط (ENVIRONMENT)

LEDGER_FILE فایل اصلی دفتر روزنامه برای استفاده در صورت عدم تعیین با -f/--file. مقدار پیش‌فرض: $HOME/.hledger.journal.

اشکالات (BUGS)

گزارش‌های اشکال را در سامانه ردیابی اشکالات hledger (https://bugs.hledger.org) یا در گفت‌وگو یا فهرست ایمیل hledger (https://hledger.org/support) پذیرا هستیم.

برخی مشکلات شناخته‌شده:

گزینه -f- کار نمی‌کند (hledger-ui نمی‌تواند از stdin بخواند).

گزینه --watch به‌ویژه با فایل‌های بزرگ پایدار نیست (به بخش حالت پایش در بالا مراجعه کنید).

اگر با فایل‌های بزرگ کلید g را فشار دهید، ممکن است مکث محسوسی رخ دهد که طی آن واسط کاربری پاسخگو نباشد.

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

Simon Michael <simon@joyful.com> و مشارکت‌کنندگان.
مشاهده کنید: http://hledger.org/CREDITS.html

حق نشر (COPYRIGHT)

حق نشر 2007-2023 Simon Michael و مشارکت‌کنندگان.

مجوز (LICENSE)

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

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

hledger(1), hledger-ui(1), hledger-web(1), ledger(1)