.TH TKREMIND 1 "2026-06-05" "Remind" "VERSION 06.02.07"
.SH "نام (NAME)"
tkremind \- رابط کاربری گرافیکی برای برنامه تقویم Remind
.SH "خلاصه دستور (SYNOPSIS)"
.B tkremind \fR[\fIoptions\fR] [\fIread_file\fR [\fIwrite_file\fR [\fIconfig_file\fR]]]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBTkRemind\fR یک رابط کاربری گرافیکی (front-end) برای برنامه \fBRemind\fR است.
این ابزار یک رابط گرافیکی کاربرپسند فراهم می‌کند که به شما امکان می‌دهد تقویم خود را
مشاهده کرده و بدون نیاز به یادگیری نحو (syntax) دستورات \fBRemind\fR، یادآورها را اضافه کنید.
اگرچه تمام ویژگی‌های \fBRemind\fR در \fBTkRemind\fR در دسترس نیست، اما
\fBTkRemind\fR این امکان را به شما می‌دهد که دستورات یادآوری ایجادشده توسط آن را ویرایش کنید.
این قابلیت به شما کمک می‌کند تا نحو دستورات \fBRemind\fR را بیاموزید و با افزایش مهارت
خود در برنامه‌نویسی \fBRemind\fR، قابلیت‌های پیشرفته‌تری را اضافه نمایید.

برنامه \fBTkRemind\fR به زبان Tcl نوشته شده است و به نگارش ۸٫۵ (یا بالاتر) و
همچنین افزونه tcllib نیاز دارد. این برنامه همچنین به باینری \fBwish\fR
نیازمند است. اگر از Tcl/Tk 8.5 استفاده می‌کنید، ممکن است برای مدیریت تصاویر PNG
به افزونه Img یا tkpng نیز نیاز داشته باشید.

.SH "گزینه‌های خط فرمان (COMMAND-LINE OPTIONS)"
خود برنامه \fBTkRemind\fR تنها یک گزینه خط فرمان دارد:
گزینه \fB\-\-version\fR که نسخه \fBTkRemind\fR را چاپ کرده و خارج می‌شود.
هر آرگومان خط فرمان دیگر که با \fB\-\fR شروع شود، به عنوان یک گزینه به
\fBRemind\fR ارسال می‌شود. علاوه بر این، \fBTkRemind\fR از گزینه‌های
\fB\-m\fR و \fB\-b1\fR پیروی کرده و ظاهر خود را بر اساس آن‌ها تنظیم می‌کند.
.PP
پارامتر \fIread_file\fR فایلی است که \fBTkRemind\fR یادآورها را از آن می‌خواند.
این فایل در قالب استاندارد \fBRemind\fR است. پارامتر \fIwrite_file\fR فایلی است
که \fBTkRemind\fR یادآورهای افزوده‌شده از طریق رابط گرافیکی را در آن ذخیره می‌کند.
اگر \fIread_file\fR مشخص نشود، مقدار پیش‌فرض \fB$HOME/.reminders\fR خواهد بود.
اگر \fIwrite_file\fR مشخص نشود، مقدار پیش‌فرض آن همان \fIread_file\fR است.
.PP
اگر مایلید تمام یادآورهای مربوط به \fBTkRemind\fR را در یک‌جا جمع‌آوری کنید،
می‌توانید مقدار \fIwrite_file\fR را متفاوت از \fIread_file\fR تعیین کنید.
فرض کنید فایل اصلی شما \fI$HOME/.reminders\fR است و می‌خواهید \fBTkRemind\fR
یادآورهای خود را در \fI$HOME/.tkreminders\fR ذخیره کند. در فایل \fI$HOME/.reminders\fR
خط زیر را قرار دهید:
.PP
.nf
	INCLUDE [getenv("HOME")]/.tkreminders
.fi
.PP

پارامتر \fIconfig_file\fR فایلی است که \fBTkRemind\fR تنظیمات و گزینه‌های خود را در آن
ذخیره می‌کند. اگر مشخص نشود، مقدار پیش‌فرض \fI$HOME/.config/tkremindrc\fR است.

.PP
اگر \fB$HOME/.reminders\fR یک \fIدایرکتوری\fR باشد، در این صورت \fBTkRemind\fR
به طور پیش‌فرض اطلاعات را از \fB$HOME/.reminders\fR خوانده و یادآورهای جدید را در
\fB$HOME/.reminders/100-tkremind.rem\fR می‌نویسد. اگر می‌خواهید یادآورهای خود را در
یک دایرکتوری به نام \fB$HOME/.reminders\fR نگه دارید، باید پیش از اجرای \fBTkRemind\fR
آن دایرکتوری را ایجاد کنید.
.SH "پنجره تقویم (THE CALENDAR WINDOW)"
هنگامی که \fBTkRemind\fR را اجرا می‌کنید، تقویمی برای ماه جاری نمایش داده می‌شود
که تاریخ امروز در آن برجسته است. یادآورها در کادر هر روز در تقویم قرار می‌گیرند.
اگر یک کادر شامل یادآورهای زیادی باشد، می‌توانید با کشیدن کلید ۲ موشوار (دکمه وسط)
روی کادر یا با استفاده از چرخ اسکرول (در صورت وجود در موشوار)، آن را به بالا و پایین پیمایش کنید.
توجه داشته باشید که هیچ علامت خاصی برای کادرهای بیش از حد پر وجود ندارد؛ صرفاً
باید توجه کنید که کادر کاملاً پر شده به نظر می‌رسد.

.SH "پیمایش (NAVIGATING)"
برای رفتن به ماه قبل یا بعد، به ترتیب روی دکمه‌های \fB<\-\fR
یا \fB\->\fR کلیک کنید. همچنین می‌توانید از کلیدهای جهت‌نمای چپ/راست
یا کلیدهای \fBPgUp\fR/\fBPgDn\fR برای پیمایش استفاده کنید.

برای بازگشت به ماه جاری، روی \fBToday\fR کلیک کنید یا کلید \fBHome\fR را فشار دهید.
برای رفتن به یک ماه مشخص، روی \fBGo To Date...\fR کلیک کنید یا کلید \fBg\fR را
فشار دهید. این کار پنجره‌ای را باز می‌کند که به شما امکان انتخاب ماه و وارد کردن
سال را می‌دهد. پس از انجام این کار، برای رفتن به تاریخ مورد نظر روی \fBGo\fR،
یا برای انصراف روی \fBCancel\fR کلیک کنید. همچنین توجه داشته باشید که تمام
پنجره‌های بازشو در \fBTkRemind\fR را می‌توان با فشردن \fBEsc\fR یا \fBControl-w\fR بست.

برای خروج از \fBTkRemind\fR، روی \fBQuit\fR کلیک کرده یا کلید ترکیبی \fBControl-q\fR را فشار دهید.

.SH "تغییر نما (CHANGING THE VIEW)"
به طور پیش‌فرض، \fBTkRemind\fR تقویم یک ماه کامل را نمایش می‌دهد.
منوی \fBView...\fR گزینه‌های زیر را در اختیارتان می‌گذارد: نمایش یک ماه کامل،
یا نمایش یادآورهای مربوط به یک، دو یا چهار هفته. اگر نما را تغییر دهید،
\fBTkRemind\fR این تغییر را ذخیره کرده و در اجرای بعدی، آن نما به عنوان نمای
پیش‌فرض استفاده می‌شود.

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

می‌توانید با فشردن کلیدهای \fB1\fR، \fB2\fR، \fB4\fR یا \fBm\fR روی پنجره اصلی تقویم،
نما را به ترتیب به یک هفته، دو هفته، چهار هفته یا یک ماه تغییر دهید.

.SH "افزودن یادآورها (ADDING REMINDERS)"
برای افزودن یک یادآور، با کلید ۱ موشوار روی شماره هر روز در تقویم کلیک کنید.
کادر گفتگوی \fBAdd Reminder...\fR باز می‌شود، در حالی که مقادیر روزی که روی آن
کلیک کرده‌اید از پیش انتخاب شده‌اند.

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

کنترل بعدی تاریخ انقضا را برای یادآور مشخص می‌کند. با فعال کردن گزینه تیک‌دار،
تاریخ انقضا فعال می‌شود و می‌توانید مقادیر را با منوهای کشویی تنظیم کنید.

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

کنترل چهارم تعیین می‌کند که \fBRemind\fR چه روزهایی را به عنوان آخر هفته در نظر بگیرد.
این تنظیم می‌تواند بر معنای «روز کاری» (weekday) در یادآورهای نوع دوم و سوم تأثیر بگذارد.

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

کنترل ششم به شما امکان می‌دهد مشخص کنید که آیا یادآور یک کار (TODO) است یا خیر،
و در صورت مثبت بودن، تاریخ انجام آن را تعیین کنید. با تایپ یک خط مورب «/» در فیلد
«:Complete through»، تاریخ ورودی تقویم به طور خودکار در آن قرار می‌گیرد. در غیر این صورت،
تاریخ تکمیل را به صورت YYYY-MM-DD وارد کنید. همچنین می‌توانید در فیلد «:Max overdue days»
عددی را وارد کنید تا تعداد روزهایی که پس از موعد مقرر، \fBRemind\fR یادآوری TODO را
ادامه می‌دهد، محدود شود.

کنترل هفتم مشخص می‌کند در صورتی که یک یادآور با یک روز تعطیل یا آخر هفته مصادف شود،
\fBRemind\fR چه واکنشی نشان دهد.

متن اصلی یادآور را در کادر متنی \fBSummary:\fR وارد کنید. در صورت تمایل، می‌توانید
مکان، یک نشانی اینترنتی (URL) و توضیحات تکمیلی را در کادرهای \fBLocation:\fR،
\fBURL:\fR و \fBDescription:\fR وارد نمایید. در صورت وارد کردن این موارد، آن‌ها به عنوان
آیتم‌های \fBINFO\fR به یادآور افزوده می‌شوند.

برای اضافه کردن یادآور به فایل یادآورها، روی \fBAdd to reminder file\fR کلیک کنید.
برای بستن پنجره بدون ذخیره یادآور در فایل، روی \fBCancel\fR کلیک کنید.
جهت پیش‌نمایش یادآور، روی \fBPreview reminder\fR کلیک کنید تا پنجره پیش‌نمایش
باز شود..SH "پیش‌نمایش یادآورها (PREVIEWING REMINDERS)"
کادر محاوره‌ای \fBPreview reminder\fR راهی عالی برای یادگیری
\fBRemind\fR است. این کادر دستور \fBRemind\fR مربوط به یادآوری که از
طریق کادر محاوره‌ای \fBAdd Reminder...\fR وارد کرده‌اید را نمایش می‌دهد.
می‌توانید یادآور را ویرایش کنید و از این طریق به ویژگی‌های پیشرفتهٔ
\fBRemind\fR دسترسی پیدا کنید. همچنین می‌توانید صرفاً با دستکاری آن،
شیوه‌ها و الگوهای بیانیِ \fBRemind\fR را برای تعریف انواع مختلف یادآورها کشف کنید.
.PP
\fBنکته\fR: اگر یادآوری را به صورت دستی ویرایش کنید، آن یادآور دیگر
در کادر محاوره‌ای گرافیکیِ یادآورِ TkRemind قابل ویرایش \fIنخواهد بود\fR.
برای اعمال تغییرات، باید آن را به صورت دستی ویرایش کنید.

.SH "مشاهدهٔ یادآورهای یک روز (SEEING A SINGLE DAY'S REMINDERS)"
روی شمارهٔ هر روز در تقویم راست‌کلیک کنید تا پنجره‌ای باز شود که
یادآورهای آن روز را در حالت Agenda Mode نمایش دهد. می‌توانید روی
نشانگر تاریخ و زمان فعلی در پایین پنجرهٔ تقویم چپ‌کلیک یا راست‌کلیک کنید
تا یادآورهای امروز را در Agenda Mode ببینید. همچنین می‌توانید در پنجرهٔ
اصلی تقویم کلید \fBt\fR را فشار دهید تا یادآورهای امروز در Agenda Mode نمایش داده شوند.

در نمای Agenda Mode، نگه داشتن نشانگر موش روی یک یادآور، اطلاعات تکمیلی
مانند Location، URL یا Description را نمایش می‌دهد. کلیک روی یک یادآور،
یک ویرایشگر را روی دستور REM که سازندهٔ آن یادآور بوده است باز می‌کند.
همچنین می‌توانید با استفاده از دکمه‌های فلش جلو و عقب، کلیدهای جهت‌نمای
چپ/راست یا \fBPgUp\fR/\fBPgDn\fR، روزها را در پنجرهٔ Agenda Mode یکی‌یکی جابه‌جا کنید.
با کلیک روی \fBToday\fR یا فشردن کلید \fBHome\fR می‌توانید به امروز بازگردید.

می‌توانید با کلیک روی \fBOK\fR یا فشردن کلید \fBEsc\fR، پنجرهٔ Agenda Mode را ببندید.

.SH "چاپ (PRINTING)"
برای چاپ تقویم ماه جاری، روی \fBPrint...\fR در پنجرهٔ اصلی تقویم کلیک کنید
یا کلیدهای \fBp\fR یا \fBControl-p\fR را فشار دهید. با این کار کادر محاوره‌ای
چاپ باز می‌شود. عملیات چاپ یا یک فایل PostScript یا PDF تولید می‌کند،
یا PostScript یا PDF را به یک دستور UNIX ارسال می‌کند.

توجه داشته باشید که برای امکان چاپ، باید \fBrem2pdf\fR نصب باشد.

مقصد چاپ را با انتخاب یکی از گزینه‌های \fBTo file:\fR یا \fBTo command:\fR
در کادر محاوره‌ای چاپ مشخص کنید. دکمهٔ \fBBrowse...\fR را فشار دهید تا مرورگر
فایل باز شود. در مرورگر فایل، می‌توانید نام فایلی را در کادر ورودی متن وارد کنید،
روی نام یک فایل در جعبهٔ فهرست (listbox) دوبار کلیک کنید، یا برای پیمایش در
فایل‌سیستم روی یک دایرکتوری دوبار کلیک نمایید. همچنین می‌توانید چند نویسهٔ اول
نام فایل را در کادر ورودی متن تایپ کنید و کلید فاصله (space) را فشار دهید تا
نام فایل با اولین مدخل منطبق کامل شود.

کادر \fBMatch:\fR شامل یک الگوی نویسهٔ عام (wildcard) برای نام فایل است که
فایل‌ها را در جعبهٔ فهرست فیلتر می‌کند. می‌توانید این فیلتر را تغییر داده و
کلید enter را برای اسکن مجدد دایرکتوری فشار دهید.

اندازه و جهت مناسب کاغذ را انتخاب کنید. اگر می‌خواهید تقویم کل صفحه را
پر کند، گزینهٔ \fBFill page\fR را فعال کنید. این حالت باید وضعیت معمول باشد،
مگر اینکه در یک روز خاص یادآورهای بسیار زیادی داشته باشید. (مستندات \fBrem2pdf\fR را ببینید.)

اگر گزینهٔ \fBAvoid over-full boxes\fR را فعال کنید، آن‌گاه \fBTkRemind\fR
گزینهٔ \fB\-\-avoid\-overfull\fR را به \fBrem2pdf\fR ارسال خواهد کرد. این کار باعث
می‌شود تا با کوچک کردن اندازهٔ قلم، تلاش شود یادآورهای متعددی در کادر تقویم
جای داده شوند. این گزینه در صورت فعال شدن، به‌طور خودکار \fBFill page\fR را
نیز فعال می‌کند.

در نهایت، روی \fBPrint\fR برای چاپ یا روی \fBCancel\fR برای انصراف کلیک کنید.
توجه داشته باشید که در هنگام چاپ، \fBRemind\fR با گزینهٔ \fB-itkremind=1\fR و
همچنین گزینهٔ اضافی \fB-itkprint=1\fR فراخوانی می‌شود. اگر خروجی PDF تولید می‌کنید،
گزینهٔ \fB-itkpdf=1\fR نیز به \fBRemind\fR ارسال می‌شود.

اگر به جای \fBPrint\fR روی \fBShow Command\fR کلیک کنید، \fBTkRemind\fR در واقع
چیزی چاپ نخواهد کرد. در عوض، پنجره‌ای متنی حاوی دستوری که \fIقصد داشت برای چاپ تقویم
استفاده کند\fR را باز می‌کند. در صورت نیاز می‌توانید دستور را ویرایش کرده و سپس روی
\fBRun\fR کلیک کنید تا دستور تغییریافته اجرا شود. این ویژگی به شما امکان می‌دهد
گزینه‌هایی از \fBrem2pdf\fR را که مستقیماً توسط \fBTkRemind\fR پشتیبانی نمی‌شوند
مشخص کنید.

.SH "ویرایش یادآورها (EDITING REMINDERS)"

اگر یادآوری را با \fBTkRemind\fR ایجاد کرده باشید، با حرکت نشانگر موش روی آن
در پنجرهٔ تقویم، به رنگ قرمز درمی‌آید. دکمهٔ ۱ موش را روی یادآور فشار دهید؛
کادر محاوره‌ای برای شما باز می‌شود که وضعیت آن کاملاً مشابه همان حالتی است
که برای ایجاد یادآور استفاده شده بود. در این مرحله، می‌توانید با ویرایش ورودی‌های
کادر محاوره‌ای و انتخاب \fBReplace reminder\fR، یادآور را تغییر دهید. می‌توانید
با انتخاب \fBDelete reminder\fR یادآور را به طور کامل حذف کنید. دکمه‌های باقی‌مانده،
یعنی \fBPreview reminder\fR و \fBCancel\fR دقیقاً مشابه کادر محاوره‌ای
در بخش «افزودن یادآورها» عمل می‌کنند.

توجه داشته باشید که اگر یادآوری را دستی ویرایش کرده باشید (با استفاده از
\fBPreview reminder\fR)، یا اگر یادآور از ابتدا به صورت دستی ایجاد شده باشد،
کلیک روی آن کادر محاوره‌ای ویرایش یادآورِ TkRemind را باز \fIنخواهد کرد\fR.
در عوض، TkRemind یک ویرایشگر متن (در صورتی که پیکربندی کرده باشید) را باز
می‌کند تا بتوانید یادآور را به صورت دستی ویرایش کنید.

.SH "استفاده از یک ویرایشگر متن (USING A TEXT EDITOR)"

اگر گزینهٔ «ویرایشگر متن» را به‌درستی تنظیم کرده باشید، راست‌کلیک روی یک یادآور،
یک ویرایشگر متن را روی فایل حاوی آن یادآور باز خواهد کرد. مکان‌نما روی خطی که
یادآور را ایجاد کرده قرار می‌گیرد. علاوه بر این، اگر یادآوری دارید که با یک
ویرایشگر قابل ویرایش است اما با \fBTkRemind\fR ایجاد نشده، هنگام حرکت نشانگر
موش روی آن، زیر آن خط کشیده می‌شود و می‌توانید با چپ‌کلیک یا راست‌کلیک روی
یادآور، آن را در یک ویرایشگر متن ویرایش کنید.
.PP
اگر یک یادآور دارای موارد \fBINFO\fR برای مکان (Location) یا توضیحات (Description)
باشد، نگه‌داشتن نشانگر موش روی یادآور، پنجره‌ای حاوی اطلاعات مکان و/یا توضیحات
را نمایش خواهد داد.

.SH "پیوندها (HYPERLINKS)"

اگر برای یک یادآور رشتهٔ INFO به صورت «Url:» تنظیم شده باشد، کلیک وسط موش
آن URL را با استفاده از \fBxdg-open\fR باز خواهد کرد.

.SH "خطاها (ERRORS)"

اگر خطایی در فایل یادآور شما وجود داشته باشد، دکمهٔ «...Queue» به «...Errors»
تغییر می‌کند. روی «...Errors» کلیک کنید تا خروجی خطای Remind را مشاهده کنید.
روی «OK» کلیک کنید تا پنجرهٔ خطا بسته شود؛ این کار دکمه را در پنجرهٔ اصلی
TkRemind مجدداً به «...Queue» بازمی‌گرداند. می‌توانید روی هر پیام خطا کلیک
کنید تا ویرایشگری روی فایل و شماره خطی که باعث بروز خطا شده باز شود..SH "یادآورهای پس‌زمینه (BACKGROUND REMINDERS)"

اگر یادآورهای «زمان‌دار» ایجاد کنید، \fBTkRemind\fR آن‌ها را در پس‌زمینه صف‌بندی کرده و با فرارسیدن زمانشان، پنجره‌های جهنده‌ای را باز می‌کند. علاوه بر این، چنانچه یادآور را با استفاده از \fBTkRemind\fR ساخته باشید، این امکان به شما داده می‌شود که یادآور را برای باقی‌ماندهٔ روز «خاموش» کنید. \fBTkRemind\fR صف‌بندی یادآورهای پس‌زمینه را با اجرای \fBRemind\fR در \fIحالت سرور\fR (server mode) انجام می‌دهد که در ادامه توضیح داده شده است.

.SH "گزینه‌ها (OPTIONS)"

دکمهٔ پایانی در پنجرهٔ تقویم، \fBOptions\fR، به شما امکان می‌دهد برخی جنبه‌های \fBTkRemind\fR را پیکربندی کنید. همچنین می‌توانید با فشردن کلید \fBo\fR پنجرهٔ گزینه‌ها را باز کنید. گزینه‌های پیکربندی عبارت‌اند از:

.TP
.B Start up Iconified
اگر این گزینه انتخاب شود، \fBTkRemind\fR به‌صورت کمینه‌شده (iconified) راه‌اندازی می‌شود. در غیر این صورت، در یک پنجرهٔ معمولی آغاز به کار می‌کند.

.TP
.B Show Today's Reminders on Startup
اگر این گزینه انتخاب شود، \fBTkRemind\fR در زمان راه‌اندازی و همچنین هنگام تغییر تاریخ در نیمه‌شب، پنجره‌ای متنی شامل یادآورهایی که توسط "remind \-q \-a \-r" صادر می‌شوند را نمایش می‌دهد.

.TP
.B Confirm Quit
اگر این گزینه انتخاب شود، هنگام فشردن \fBQuit\fR از شما تأییدیه خواسته می‌شود. در غیر این صورت، \fBTkRemind\fR بدون اعلان خارج می‌شود.

.TP
.B Automatically close pop-up reminders after a minute
اگر این گزینه انتخاب شود، پنجره‌های جهندهٔ یادآور پس از گذشت یک دقیقه بسته می‌شوند. در غیر این صورت، تا زمانی که صریحاً آن‌ها را نبندید، برای همیشه روی صفحه باقی خواهند ماند.

.TP
.B Use system notifications when issuing a reminder
این گزینه تنها برای Tcl/Tk نسخهٔ 9.0 یا بالاتر، یا در صورت نصب بودن برنامهٔ \fBnotify-send\fR در دسترس است؛ اگر هیچ‌یک از این دو شرط برقرار نباشد، خاکستری (غیرفعال) خواهد بود. در صورت انتخاب، با جهیدن یک یادآور، پیامی نیز به سامانهٔ اعلان‌های میزکار ارسال شده و سبب نمایش اعلان می‌شود.

.TP
.B Beep terminal when popping up a reminder
در صورت انتخاب، \fBTkRemind\fR هنگام جهیدن یک یادآورِ صف‌بندی‌شده، زنگ ترمینال را به صدا درمی‌آورد.

.TP
.B Deiconify calendar window when popping up a reminder
در صورت انتخاب، همان کاری را انجام می‌دهد که از نامش برمی‌آید (پنجرهٔ تقویم را از حالت کمینه خارج می‌کند).

.TP
.B Run command when popping up a reminder
اگر این ورودی خالی نباشد، دستور مشخص‌شده هر زمان که یک یادآورِ پس‌زمینه جهش کند اجرا می‌شود.

.TP
.B Feed popped-up reminder to command's standard input
در صورت انتخاب، متن یادآور را به ورودی استاندارد دستوری که در بالا توضیح داده شد ارسال می‌کند. متن یادآور با پیشوند "HH:MM " همراه است که در آن HH:MM زمان یادآور است.

.TP
.B E-mail reminders here if popup not dismissed
اگر نشانی ایمیلی در این فیلد وارد کنید، چنانچه پنجرهٔ جهنده را ظرف یک دقیقه نبندید، \fBTkRemind\fR یادآور را برای شما ایمیل خواهد کرد. این ویژگی زمانی مفید است که نیاز دارید ترمینال خود را ترک کنید اما می‌خواهید یادآورهایتان از طریق ایمیل شما را «دنبال» کنند.

.TP
.B Name or IP address of SMTP server
برنامهٔ \fBTkRemind\fR برای ارسال ایمیل از اتصال مستقیم SMTP استفاده می‌کند. آدرس IP یا نام سرور SMTP خود را اینجا وارد کنید.

.TP
.B Text Editor
این گزینه ویرایشگر متنی را تعیین می‌کند که هنگام کلیک راست روی یک یادآور فراخوانی می‌شود. توالی "%d" با شماره خط فایلی که شامل یادآور است، و "%s" با نام فایل جایگزین می‌شود. رشته‌های مفیدی مانند "emacs +%d %s" یا "gvim +%d %s" نمونه‌هایی از آن هستند.

.TP
.B Extra Arguments for Remind
این گزینه آرگومان‌های اضافی را مشخص می‌کند که باید هنگام فراخوانی \fBremind\fR توسط \fBTkRemind\fR به آن ارسال شوند. مگر اینکه دقیقاً بدانید چه می‌کنید، این بخش را خالی بگذارید.

.TP
.B Change entry font...
این دکمه کادر گفتگوی انتخاب قلم را باز می‌کند که به شما اجازه می‌دهد قلم مورد استفاده برای رسم موارد تقویم در خانه‌های تقویم را تغییر دهید.

.TP
.B Change heading font...
مشابه Change entry font است، اما برای سربرگ تقویم (نام‌های ماه و روز و شماره‌های روزها) اعمال می‌شود.

.PP
پس از اینکه گزینه‌ها را به دلخواه خود پیکربندی کردید، برای اعمال آن‌ها روی \fBApply Options\fR، برای اعمال و ذخیرهٔ آن‌ها در $HOME/.config/tkremindrc روی \fBSave Options\fR، یا برای لغو هرگونه تغییرات ایجادشده روی \fBCancel\fR کلیک کنید.

.SH "به‌روزرسانی‌های آنی (IMMEDIATE UPDATES)"

اگر \fBTkRemind\fR را روی لینوکس اجرا می‌کنید و \fBRemind\fR با پشتیبانی از \fBinotify\fR(7) کامپایل شده باشد، در صورت تغییر \fB$HOME/.reminders\fR (یا در صورتی که دایرکتوری باشد، تغییر هر فایلی درون آن دایرکتوری)، \fBTkRemind\fR پنجرهٔ تقویم را \fIبلافاصله\fR دوباره رسم می‌کند.
.PP
این ویژگی به \fBTkRemind\fR امکان می‌دهد بلافاصله به یادآورهای ویرایش‌شده به‌صورت دستی یا فایل‌های یادآوری که از سامانهٔ تقویم دیگری وارد شده‌اند واکنش نشان دهد (برای مثال، ممکن است یک کار cron داشته باشید که به‌طور دوره‌ای ورودی‌های تقویم Google شما را به قالب Remind وارد می‌کند).

.SH "نکات و متفرقه‌ها (ODDS AND ENDS)"
هنگامی که یادآوری را اضافه یا پیش‌نمایش می‌کنید، \fBTkRemind\fR برخی بررسی‌های اولیهٔ سازگاری را انجام می‌دهد. با این حال، اگر یادآوری را در پیش‌نمایشگر ویرایش کنید، \fBTkRemind\fR یادآورِ ویرایش‌شده را بررسی \fIنمی‌کند\fR. شما می‌توانید یادآورهای غیرمجازی ایجاد کنید که ممکن است باعث بروز مشکل شوند. (این یک دلیل مناسب برای جداسازی یادآورهای \fBTkRemind\fR در یک فایل مجزا است.)
.PP
برنامهٔ \fBTkRemind\fR بدنهٔ یادآور را به هیچ وجه بررسی \fIنمی‌کند\fR. می‌توانید از توالی‌های جایگزینیِ عادی \fBRemind\fR در بدنه استفاده کنید. علاوه بر این، اگر از درج عبارت (expression-pasting) در بدنه استفاده کنید، \fBTkRemind\fR آن عبارت‌ها را اعتبارسنجی \fIنمی‌کند\fR.
.PP
هنگامی که \fBTkRemind\fR برنامهٔ \fBRemind\fR را فراخوانی می‌کند، گزینهٔ زیر را:
.PP
.nf
	\-itkremind=1
.fi
.PP
در خط فرمان ارسال می‌کند. بنابراین، در فایل \fBRemind\fR خود می‌توانید کد زیر را بگنجانید:
.PP
.nf
	IF defined("tkremind")
		# Then I'm probably being invoked by TkRemind
	ENDIF
.fi
.PP
می‌توانید از این قابلیت برای فعال‌سازی برخی یادآورها به روش‌های متفاوت ویژهٔ \fBTkRemind\fR (به‌عنوان مثال) استفاده کنید.
.PP
برنامهٔ \fBTkRemind\fR از برچسب‌ها (tags) برای پیگیری یادآورها در فایل اسکریپت استفاده می‌کند. اگر از قوانین و محدودیت‌های زیر آگاه باشید، می‌توانید یادآورهای «دست‌نویس» را با یادآورهای ایجادشده توسط \fBTkRemind\fR ترکیب کنید:
.TP
o
برنامهٔ \fBTkRemind\fR از \fBTAG\fRهایی به فرم \fBTKTAG\fR\fInnn\fR استفاده می‌کند که در آن \fInnn\fR یک عدد است. شما نباید از چنین \fBTAG\fRهایی در یادآورهای دست‌نویس استفاده کنید.
.TP
o
یادآورهای دست‌نویس با \fBTkRemind\fR قابل ویرایش نیستند، و برای یادآورهای زمان‌دار دست‌نویس، هنگام جهیدن پنجرهٔ آن‌ها، گزینهٔ "Don't remind me again" به شما نمایش داده نخواهد شد.

.PP
با این حال، به‌جای ترکیب فایل‌های دست‌نویس با موارد تولیدشده توسط \fBTkRemind\fR، بهتر است \fB$HOME/.reminders\fR را به یک دایرکتوری تبدیل کنید و فایل‌های ویرایش‌شده به‌صورت دستی را در یک فایل \fB*.rem\fR جداگانه از فایل \fB100-tkremind.rem\fR متعلق به \fBTkRemind\fR نگهداری نمایید..SH "حالت سرور (SERVER MODE)"

\fBRemind\fR یک حالت ویژه برای تعامل با برنامه‌هایی مانند
\fBTkRemind\fR دارد. این حالت \fIحالت سرور (server mode)\fR نامیده می‌شود و با
ارائهٔ گزینهٔ \fB\-zj\fR به \fBRemind\fR فعال می‌گردد.

در حالت سرور، \fBRemind\fR مشابه با حالت دیمن (daemon mode) عمل می‌کند، با این تفاوت
که دستورها را (یک دستور در هر خط) از ورودی استاندارد می‌خواند و خطوط وضعیت
را در خروجی استاندارد می‌نویسد. هر خط وضعیت یک شیء JSON است.

دستورهای پذیرفته‌شده در حالت سرور عبارتند از:

.TP
EXIT
پایان دادن به فرآیند \fBRemind\fR. نشانگر پایان پرونده (EOF) در ورودی استاندارد نیز
همین کار را انجام می‌دهد. \fBRemind\fR بلافاصله و بدون چاپ خط وضعیت JSON
خارج می‌شود.

.TP
STATUS
بازگرداندن تعداد یادآورهای موجود در صف. شیء JSON شبیه به این خواهد بود:
.nf

{"response":"queued","nqueued":n,"command":"STATUS"}

.fi
که در آن \fIn\fR تعداد یادآورهای موجود در صف است.

.TP
QUEUE یا JSONQUEUE
بازگرداندن محتویات صف. شیء JSON چیزی شبیه به این خواهد بود:
.nf

{"response":"queue","queue":[ ... ],"command":"QUEUE"}

.fi
مقدار کلید \fBqueue\fR آرایه‌ای از اشیاء JSON است که هر کدام
نشان‌دهندهٔ یک یادآور در صف هستند.

.TP
TRANSLATE Any string goes here
ترجمهٔ «Any string goes here» را بر اساس جدول ترجمهٔ \fBRemind\fR
بازمی‌گرداند. توجه داشته باشید که باید دقیقاً یک فاصله پس از
TRANSLATE و قبل از رشته‌ای که می‌خواهید ترجمه کنید وجود داشته باشد. شیء JSON
حاصل از «TRANSLATE New Moon» ممکن است شبیه به این باشد:
.nf

{"response":"translate","translation":{"New Moon":"Nieuwe maan"},"command":"TRANSLATE"}

.fi
همان‌طور که مشاهده می‌کنید، مقدار کلید \fBtranslation\fR شیئی است که کلید آن
متن اصلی و مقدار آن متن ترجمه‌شده است. یک واسط کاربری (front-end)
می‌تواند از TRANSLATE برای محلی‌سازی خود استفاده کند؛ برای نمونه،
TkRemind از آن برای بومی‌سازی پنجرهٔ بازشوی وضعیت ماه در
نمایش SPECIAL MOON استفاده می‌کند.
.RS
.PP
اگر آرگومان داده‌شده به TRANSLATE در جدول ترجمه نباشد، آن‌گاه
\fBRemind\fR \fIاصلاً هیچ پاسخی\fR به دستور TRANSLATE صادر نخواهد کرد.
.RE
.TP
TRANSLATE_DUMP
محتویات جدول ترجمه را بازمی‌گرداند. شیء JSON شبیه به این خواهد بود:
.nf

{"response":"translate_dump","table":{...},"command":"TRANSLATE_DUMP"}

.fi
مقدار کلید \fBtable\fR یک دیکشنری از رشته‌های اصلی به ترجمه‌شده است.

.TP
DEL \fIqid\fR
یادآور با شناسهٔ صف \fIqid\fR را از صف حذف می‌کند.

.TP
REREAD
خواندن مجدد پروندهٔ یادآور. خط وضعیت زیر را بازمی‌گرداند:

.nf

{"response":"reread","command":"REREAD"}

.fi

.PP
سایر خطوط وضعیت نوشته‌شده به شرح زیر هستند:

.TP
.nf

{"response":"reminder","ttime":tt,"tdatetime":tdt,"now":now,"tags":tags,"qid":qid,"body":body}

.fi
در این خط، \fItt\fR زمان فعال‌سازی یادآور است (به صورت یک رشته بیان می‌شود)،
\fItdt\fR زمان و تاریخ فعال‌سازی یادآور (DATETIME) است که به عنوان رشته‌ای
با قالب «\fIYYYY-MM-DD\fRT\fIHH:MM\fR» بیان می‌شود؛
\fInow\fR زمان فعلی است، \fItags\fR (در صورت وجود) برچسب یا برچسب‌های
مرتبط با یادآور بوده و \fIbody\fR متن بدنهٔ یادآور است. این پاسخ باعث
می‌شود \fBTkRemind\fR یک اعلان یادآور را به صورت بازشو نمایش دهد.
\fIqid\fR یک شناسهٔ یکتا برای این یادآور است. شما می‌توانید با ارسال
دستور \fBDEL\fR \fIqid\fR به سرور، آن را از صف حذف کنید. توجه داشته باشید
که \fIqid\fRها در خواندن‌های مجدد پایدار نیستند؛ اگر \fBRemind\fR برای
خواندن مجدد پروندهٔ یادآور بازراه‌اندازی شود، احتمالاً مقادیر \fIqid\fR تغییر
خواهند کرد و هر یادآوری که با دستور \fBDEL\fR \fIqid\fR حذف شده باشد،
ممکن است دوباره در صف قرار گیرد.
.TP
.nf

{"response":"newdate"}

.fi

این خط هر زمان که \fBRemind\fR تغییر و گردش تاریخ سیستم را تشخیص دهد، صادر
می‌شود. برنامهٔ واسط باید تقویم خود را دوباره ترسیم کند یا هر اقدام لازم
دیگری را به انجام رساند.

.TP
.nf

{"response":"reread","command":"inotify"}

.fi

اگر \fBRemind\fR با پشتیبانی از \fBinotify\fR(7) کامپایل شده باشد، در صورت
تشخیص تغییری در پرونده یا دایرکتوری سطح‌بالای یادآور، پاسخ بالا را
صادر می‌کند. واسط کاربری باید تقویم خود را از نو ترسیم کند، زیرا این
پاسخ نشان می‌دهد که تغییری در پرونده یا دایرکتوری یادآور ایجاد شده است.

.PP
لطفاً توجه داشته باشید که \fBRemind\fR می‌تواند \fIدر هر زمانی\fR یک پیام وضعیت
بنویسد و این امر فقط در پاسخ به دستور ارسال‌شده به ورودی استاندارد آن نیست.
بنابراین، برنامه‌ای که \fBRemind\fR را در حالت سرور اجرا می‌کند باید برای
مدیریت پیام‌های وضعیت ناهمگام (asynchronous) آماده باشد..SH "نویسنده (AUTHOR)"
TkRemind توسط Dianne Skoll <dianne@skoll.ca> نوشته شده است.

حق نشر (C) 1996-2026 \fBTkRemind\fR متعلق به Dianne Skoll است.

.SH "فایل‌ها (FILES)"

$HOME/.reminders \-\- فایل یا دایرکتوری پیش‌فرض یادآورها.

$HOME/.config/tkremindrc \-\- گزینه‌های ذخیره‌شدهٔ \fBTkRemind\fR.

.SH "صفحه خانگی (HOME PAGE)"
https://dianne.skoll.ca/projects/remind
.SH "همچنین ببینید (SEE ALSO)"
\fBremind\fR، \fBrem2pdf\fR، \fBrem2html\fR