.\" Written by Robert Merkel (rgmerk@mira.net) .\" Process this file with .\" groff -man -Tascii foo.1 .\" .TH GNUCASH 1 "2026-08-13" "Version 5.16-unknown-commit" "GnuCash Manual Pages" .SH "نام (NAME)" gnucash-cli \- ابزار خط فرمان همراه با GnuCash .SH "خلاصه دستور (SYNOPSIS)" .B gnucash-cli [گزینه‌ها] [ .I accounts.gnucash .B ] .SH "توضیحات (DESCRIPTION)" .B gnucash-cli تعامل مشخصی را با فایل دادهٔ gnucash مستقیماً از طریق خط فرمان فراهم می‌کند. این ابزار دارای دو حالت است: حالت .B quotes و حالت .B report . .SH "حالت مظنه‌ها (Quotes Mode) (فعال‌سازی با \-\-quotes )" این حالت دارای گزینه‌هایی برای دریافت مظنه‌های برخط مربوط به ارزهای خارجی و سهام در فایل دادهٔ مشخص‌شده است. این حالت از دستورهای زیر پشتیبانی می‌کند: .IP info نسخهٔ Finance::Quote و منابع مظنهٔ در دسترس را نمایش می‌دهد. .IP get مظنه‌های برخط را دریافت می‌کند. توجه داشته باشید که این دستور مستلزم پیکربندی صحیح Finance::Quote روی سیستم شما است. دستور .B get گزینه‌های زیر را می‌پذیرد: .IP \-\-namespace=REGEXP عبارت باقاعده‌ای (Regular expression) که تعیین می‌کند کالاهای کدام فضای نام (namespace) دریافت شوند. .IP dump مظنه‌های جاری را برای ارزها یا سهام مشخص‌شده از یک فضای نام معین واکشی کرده و نتایج را در کنسول چاپ می‌کند. پس از این دستور باید یک منبع و یک یا چند نماد ذکر شود، مگر اینکه منبع "currency" باشد که در این صورت باید دو یا چند نماد به دنبال آن بیاید؛ اولین نماد، ارزی است که نرخ برابری برای بقیهٔ نمادها بر پایهٔ آن اعلام خواهد شد. دستور .B dump گزینه‌های زیر را می‌پذیرد: .IP \-v .IP \-\-verbose تمام پارامترهایی را که Finance::Quote برای نماد بازمی‌گرداند فهرست می‌کند، به جای اینکه تنها موارد مورد نیاز GnuCash را نمایش دهد. .SH "حالت گزارش (Report Mode) (فعال‌سازی با \-\-report )" این حالت دارای گزینه‌هایی برای کار با گزارش‌ها در فایل دادهٔ مشخص‌شده است. این حالت از دستور زیر پشتیبانی می‌کند: .IP run یک گزارش را روی فایل دادهٔ داده‌شده اجرا می‌کند. دستور .B run گزینه‌های زیر را می‌پذیرد: .IP \-\-name=REPORT_NAME نام گزارشی که باید اجرا شود .IP \-\-export-type=TYPE مشخص کردن نوع برون‌ریزی (export) .SH "گزینه‌های عمومی (General Options)" .IP \-\-version نمایش نسخهٔ .B GnuCash .IP \-\-help نمایش این پیام راهنما .IP \-\-debug فعال‌سازی حالت اشکال‌زدایی: افزایش سطح ثبت وقایع برای ارائهٔ جزئیات عمیق. .IP \-\-extra فعال‌سازی قابلیت‌های اضافی/توسعه/اشکال‌زدایی. .IP \-\-log بازنویسی سطح لاگ، به فرم "log.ger.path={debug,info,warn,crit,error}" این گزینه می‌تواند چندین بار مشخص شود. .IP \-\-logto فایلی که لاگ در آن ذخیره می‌شود؛ پیش‌فرض "$TMPDIR/gnucash.trace" است؛ برای نوشتن در پایانه از "stderr" یا "stdout" استفاده کنید. .SH "فایل‌ها (FILES)" .I ~/.gnucash/config.auto .RS فایل پیکربندی تولیدشده به‌صورت خودکار برای هر کاربر. به صورت دستی ویرایش نکنید! .SH "محیط (ENVIRONMENT)" .IP GNC_DEBUG فعال‌سازی خروجی اشکال‌زدایی. این متغیر به شما امکان می‌دهد اشکال‌زدایی را زودتر از آنچه با .B \-\-debug ممکن است، در فرایند راه‌اندازی فعال کنید. .IP GUILE_LOAD_PATH مسیری جایگزین برای مسیر بارگذاری scheme در .B GnuCash . نیازی به تغییر این متغیر نخواهید داشت. برای اطلاعات بیشتر فایل README را ببینید. .IP GNC_MODULE_PATH مسیری جایگزین برای مسیر بارگذاری scheme در .B GnuCash برای ماژول‌های .B Gnucash . نیازی به تغییر این متغیر نخواهید داشت. برای اطلاعات بیشتر فایل README را ببینید. .SH "گزارش باگ‌ها (BUGS)" .B لطفاً هرگونه باگ را با استفاده از فرم گزارش باگ در وب‌گاه .B GnuCash .B گزارش دهید. .SH "همچنین ببینید (SEE ALSO)" .B GnuCash دارای راهنمای آنلاین جامعی است که از طریق منوی "help" در دسترس است. اطلاعات بیشتر و آخرین نسخه در وب‌گاه زیر در دسترس است: .B https://www.gnucash.org .SH "نویسندگان (AUTHORS)" Robert Merkel این صفحهٔ راهنما را نوشته است. .B GnuCash توسط Robin Clark، Linas Vepstas و هزاران مشارکت‌کنندهٔ دیگر نوشته شده است.