'\" t .\" Title: \fBrkward\fR .\" Author: Thomas Friedrichsmeier .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2024-05-26 .\" Manual: RKWard User's Manual .\" Source: KDE Applications RKWard 0.8.0 .\" Language: Persian .\" .TH "\FBRKWARD\FR" "1" "2024\-05\-26" "KDE Applications RKWard 0.8.0" "RKWard User's Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" غیرفعال‌کردن خط تیره اتصال کلمات .nh .\" تراز متن به چپ .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" rkward \- یک واسط کاربری مبتنی بر KDE برای R .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBrkward\fR\ 'u \fBrkward\fR [\fB\-\-evaluate\fR\fI Rcode\fR] [\fB\-\-debug\-level\fR\fI level\fR] [\fB\-\-debug\-flags\fR\fI flags\fR] [\fB\-\-debug\-output\fR\fI where\fR] [\fB\-\-backend\-debugger\fR\fI debugger_command\fR] [\fB\-\-r\-executable\fR\fI path_to_executable\fR] [\fB\-\-reuse\fR] [\fB\-\-autoreuse\fR] [\fB\-\-nowarn\-external\fR] [گزینه‌های\ عمومی\ KDE] [گزینه‌های\ عمومی\ Qt] [\fIfiles_to_open\fR] .SH "توضیحات (DESCRIPTION)" .PP RKWard یک رابط کاربری گرافیکی (GUI) و محیط توسعه یکپارچه (IDE) مبتنی بر KDE برای زبان اسکریپت‌نویسی R جهت محاسبات آماری است\&. .PP برای اطلاعات بیشتر، لطفاً به \m[blue]\fBوبگاه RKWard\fR\m[]\&\s-2\u[1]\d\s+2 و مستندات ارائه‌شده درون خود RKWard مراجعه کنید\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-\-evaluate\fR \fIRcode\fR .RS 4 کد R داده‌شده پس از راه‌اندازی RKWard و پس از بارگذاری هر فضای کاری مشخص‌شده، ارزیابی می‌شود\&. این گزینه بیشتر برای آزمایش‌های خودکار کاربرد دارد\&. .RE .PP \fB\-\-debug\-level\fR \fIlevel\fR .RS 4 میزان جزئیات خروجی اشکال‌زدایی\&. مقادیر بین 0 تا 5 هستند، که در آن 0 به معنی بدون خروجی و 5 شامل همه خروجی‌ها از جمله اطلاعات ردگیری (trace) توابع است\&. مقدار پیش‌فرض 2 است\&. .RE .PP \fB\-\-debug\-output\fR \fIwhere\fR .RS 4 محل ارسال خروجی اشکال‌زدایی\&. مقدار پیش‌فرض، ذخیره آن در فایلی درون دایرکتوری موقت است\&. مشخص کردن "terminal" خروجی اشکال‌زدایی را در عوض به stderr می‌فرستد (برای اشکال‌زدایی مشکلات راه‌اندازی مفید است)\&. توجه داشته باشید که خروجی اشکال‌زدایی فرآیند backend همواره در یک فایل ذخیره می‌شود\&. .RE .PP \fB\-\-debug\-flags\fR \fIflags\fR .RS 4 پیکربندی بخش‌هایی از کد که باید اشکال‌زدایی شوند\&. پرچم‌ها به‌صورت یک عدد باینری (دودویی) مشخص می‌شوند\&. برای مستندات به فایل‌های منبع مراجعه کنید، چرا که این گزینه کاملاً یک گزینه داخلی است\&. .RE .PP \fB\-\-backend\-debugger\fR \fIcommand\fR .RS 4 اجرای بخش پس‌زمینه (backend) RKWard از طریق دستور اشکال‌زدای مشخص‌شده\&. برای افزودن گزینه‌های خط فرمان به دستور اشکال‌زدا، آن‌ها را همراه با دستور در علامت نقل‌قول تکی (\*(Aq\*(Aq) محصور کنید\&. \fIنکته:\fR آرگومان‌های اشکال‌زدا با فاصله جدا خواهند شد\&. اگر این رفتار مناسب نیست، باید اسکریپت پوششی (wrapper) خود را برای فراخوانی اشکال‌زدا بنویسید\&. همچنین مطمئن شوید که تمامی خروجی‌ها و/یا ورودی‌های اشکال‌زدا را به شکل مقتضی بازهدایت (redirect) کنید\&. مثال‌ها را ببینید\&. .RE .PP \fB\-\-r\-executable\fR \fIcommand\fR .RS 4 در صورت وجود چندین نصب از R، نصبی را که باید استفاده شود مشخص کنید، برای نمونه /usr/bin/R\&. همچنین می‌توانید از رشته \fI"auto"\fR استفاده کنید، که در این صورت RKWard سعی خواهد کرد R را در یکی از مسیرهای نصب استاندارد و شناخته‌شده پیدا کند\&. \fIتوجه\fR داشته باشید که اگرچه RKWard \fIاغلب\fR با نسخه‌های جدیدتر R کار می‌کند، اما \fIگاهی اوقات\fR نیاز به کامپایل مجدد برای آن نسخه دارد یا ممکن است کلاً ناسازگار باشد\&. .sp این گزینه نصب R را تنها برای نشست فعلی تغییر می‌دهد و تغییر آن ماندگار نیست\&. .RE .PP \fB\-\-reuse\fR .RS 4 اگر یک نمونه از RKWard از قبل در حال اجرا باشد، آن را به جلو می‌آورد و \fIfiles_to_open\fR را باز می‌کند\&. توجه داشته باشید در صورتی که از یک نمونه مجدداً استفاده شود، تمام گزینه‌های دیگر خط فرمان نادیده گرفته خواهند شد\&. .RE .PP \fB\-\-autoreuse\fR .RS 4 در صورتی که هرگونه آرگومان فایلی نیز داده شده باشد مانند \fB\-\-reuse\fR رفتار می‌کند؛ در غیر این صورت، یک نمونه جدید را آغاز می‌کند\&. برای استفاده در فایل \&.desktop در نظر گرفته شده است\&. .RE .PP \fB\-\-nowarn\-external\fR .RS 4 معمولاً هنگام فراخوانی افزونه‌های RKWard از خط فرمان (یعنی زمانی که \fIfiles_to_open\fR شامل URLهایی به شکل \fIrkward://runplugin/\&.\&.\&.\fR باشد)، RKWard هشداری را نشان می‌دهد مبنی بر اینکه چنین URLهایی \fIمی‌توانند\fR برای اجرای اقدامات مخرب روی سیستم شما استفاده شوند\&. این هشدار به‌طور مشخص مربوط به پیوندهای یافت‌شده در وبگاه‌های غیرقابل اعتماد یا سایر منابع خارجی نامعتبر است\&. اگر می‌خواهید برای RKWard به‌صورت محلی اسکریپت بنویسید، می‌توانید با افزودن \-\-nowarn\-external به خط فرمان از نمایش این هشدار جلوگیری کنید\&. .sp (اگر در ترکیب با \-\-reuse استفاده شود، برای فرونشاندن هشدار باید *هر دو* دستور مورد نظر با \-\-nowarn\-external فراخوانی شوند\&.) .RE .PP \fB\-\-setup\fR .RS 4 طوری عمل می‌کند که گویی نسخه جدیدی از RKWard نصب شده است؛ به‌ویژه با نصب مجدد بسته پشتیبانی R و نمایش ویزارد راه‌اندازی\&. این ویژگی عمدتاً برای توسعه‌دهندگان و آزمون‌کنندگان هدف‌گذاری شده است\&. .RE .PP \fB\-\-quirkmode\fR .RS 4 غیرفعال‌سازی برخی از کدهای اعتبارسنجی راه‌اندازی\&. گزینه‌ای آزمایشی است و برای استفاده عادی در نظر گرفته نشده است\&. .RE .PP \fIfiles_to_open\fR .RS 4 می‌توانید هر تعداد نام فایل یا URL را برای باز شدن توسط RKWard مشخص کنید\&. این موارد معمولاً فایل‌های فضای کاری (workspace)، فایل‌های محیط کار (workplace)، فایل‌های اسکریپت R یا URLهای rkward:// (مثلاً برای شروع با پنجره محاوره‌ای یک افزونه) هستند\&. تعیین بیش از یک فایل فضای کاری منجر به ادغام فضاهای کاری با یکدیگر خواهد شد و توصیه نمی‌شود\&. .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBR\fR(1) .SH "مثال‌ها (EXAMPLES)" .PP .if n \{\ .RS 4 .\} .nf # شروع با پنجره محاوره‌ای t\-test rkward \-\-nowarn\-external rkward://runplugin/rkward::t_test/ # باز کردن دو فایل اسکریپت در یک نمونه در حال اجرای RKWard (یا نمونه‌ای تازه اگر RKWard در حال اجرا نباشد) rkward \-\-reuse file_a\&.R file_b\&.R # اجرای پس‌زمینه rkward از طریق valgrind rkward \-\-backend\-debugger \*(Aqvalgrind \-\-log\-file=valgrind\&.log\*(Aq .fi .if n \{\ .RE .\} .SH "نویسندگان (AUTHORS)" .PP RKWard توسط Thomas Friedrichsmeier و تیم RKWard نوشته شده است\&. به \m[blue]\fBوبگاه RKWard\fR\m[]\&\s-2\u[1]\d\s+2 مراجعه کنید\&. .SH "نویسنده (AUTHOR)" .PP \fBThomas Friedrichsmeier\fR <\&rkward@kde\&.org\&> .RS 4 صفحه راهنمای RKWard\&. .RE .SH "نکات (NOTES)" .IP " 1." 4 وبگاه RKWard .RS 4 \%https://rkward.kde.org .RE