.TH  PDFPCRC 5
.if !dURL \{\
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.\}
.if \n[.g] .mso www.tmac

.SH "نام (NAME)"
pdfpcrc \- پرونده پیکربندی pdfpc

.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBpdfpc\fR(1)
ابتدا پرونده پیکربندی سراسری سیستم و سپس در صورت وجود، پرونده پیکربندی اختصاصی کاربر را می‌خواند.

.SS "کلیدهای میانبر (Keybindings)"
.PP
دستورهای زیر پذیرفته می‌شوند:
.TP
.B bind <key> <action> [<arg>]
اتصال یک کلید به یک عمل، همراه با ارسال آرگومان مشخص‌شده برای عمل‌هایی که به آن نیاز دارند.
.TP
.B unbind <key>
لغو اتصال کلید داده‌شده.
.TP
.B unbind_all
پاک‌سازی تمام اتصالات کلیدها.
.TP
.B mouse <button> <action>
اتصال یک دکمه موشواره به یک عمل.
.TP
.B unmouse <button>
لغو اتصال یک دکمه موشواره.
.TP
.B unmouse_all
پاک‌سازی تمام اتصالات موشواره.

.PP
نام کلیدها را می‌توان به کمک ابزار
\fBxev\fR(1)
به دست آورد. توجه داشته باشید که نام‌ها به حروف بزرگ و کوچک حساس هستند. ترکیب‌های کلیدی به همراه تبدیلگرها (Modifiers) را می‌توان به صورت
.RI < mod >+< key >
مشخص کرد، که در آن
.I <mod>
یکی از مقادیر
.B S
(برای Shift)،
.B C
(برای Control) و
.B A/M
(برای Alt/Meta) است.

.PP
یک روش خلاصه برای مشخص کردن ترکیب‌های کلیدی شامل Shift و یک نویسه الفبایی، استفاده از شکل بزرگ آن نویسه الفبایی است؛ به عنوان مثال،
.B S+r
و
.B R
معادل یکدیگرند.

.PP
فهرستی از تمام عمل‌های ممکن را می‌توان از طریق گزینه خط فرمان
.B \-L
در
\fBpdfpc\fR(1)
به دست آورد. برای فهرست کردن اتصالات عمل‌های تعریف‌شده از گزینه خط فرمان
.B \-B
استفاده کنید.

.SS "گزینه‌ها (Options)"
.PP
برخی از تغییرات دائمی را می‌توان از طریق پرونده پیکربندی تنظیم کرد. ساختار نگارش به صورت زیر است:
.TP
.B option <option_name> <option_value>

.PP
نام‌های گزینه (\fIoption_name\fR) زیر پشتیبانی می‌شوند:

.TP
.B black-on-end
افزودن یک اسلاید سیاه اضافی در پایان ارائه (بولی، پیش‌فرض: false).
.TP
.BI cache-clean-period
دوره زمانی (بر حسب ثانیه) برای بررسی محتوای منقضی‌شده در حافظه نهان (عدد صحیح، پیش‌فرض: 60).
.TP
.BI cache-expiration
مدت زمان (بر حسب ثانیه) برای نگهداری اسلایدهای رندرشده (یا پیش‌رندرشده) در حافظه نهان (عدد صحیح، پیش‌فرض: 600). برای نگهداری دائمی اسلایدهای ذخیره‌شده در حافظه نهان، مقدار منفی تعیین کنید.
.TP
.BI cache-max-rtime
حداکثر زمان (بر حسب میلی‌ثانیه) رندر یک اسلاید برای این‌که حافظه نهان آن در برابر انقضا محافظت شود (عدد صحیح، پیش‌فرض: 1000).
.TP
.BI cache-min-rtime
حداقل زمان (بر حسب میلی‌ثانیه) رندر یک اسلاید برای این‌که در حافظه نهان ذخیره شود (عدد صحیح، پیش‌فرض: 10).
.TP
.BI cache-max-usize
حداکثر اندازه (بر حسب کیلوبایت) تصویر یک اسلاید برای ذخیره‌سازی غیرفشرده در حافظه نهان (عدد صحیح، پیش‌فرض: 256).
.TP
.B current-height
درصد ارتفاع ناحیه «اصلی» ارائه‌دهنده که برای اسلاید کنونی استفاده می‌شود (عدد صحیح، پیش‌فرض: 80).
.TP
.B current-size
درصد عرض صفحه نمایش ارائه‌دهنده که برای اسلاید کنونی استفاده می‌شود (عدد صحیح، پیش‌فرض: 60).
.TP
.B cursor-timeout
مدت زمان عدم فعالیت موشواره (بر حسب ثانیه) که پس از آن مکان‌نما پنهان می‌شود (عدد صحیح، پیش‌فرض: 2).
.TP
.BI disable-input-autodetection
عدم تشخیص خودکار نوع دستگاه‌های ورودی تبلت (قلم یا پاک‌کن) (بولی، پیش‌فرض: false).
.TP
.BI disable-input-pressure
نادیده گرفتن حساسیت به فشار دستگاه‌های ورودی تبلت (قلم یا پاک‌کن) حتی زمانی که توسط سخت‌افزار پشتیبانی می‌شود (بولی، پیش‌فرض: false).
.TP
.BI disable-scrolling
غیرفعال کردن رویدادهای پیمایش (اسکرول) در پنجره ارائه‌دهنده (بولی، پیش‌فرض: false).
.TP
.BI disable-tooltips
غیرفعال کردن پیش‌نمایش‌های راهنما برای جعبه‌ابزار (بولی، پیش‌فرض: false).
.TP
.BI enable-auto-srt-load
تلاش برای بارگذاری خودکار پرونده‌های زیرنویس ویدیو. برای هر رسانه ویدیویی،
pdfpc
پسوند
.B .srt
را به نشانی رسانه افزوده و تلاش می‌کند پرونده زیرنویس (در قالب SRT) را از آن محل بارگذاری نماید (بولی، پیش‌فرض: false).
.TP
.B final-slide
نمایش اسلاید پایانی یک گروه هم‌پوشان (Overlay) به جای اسلاید بعدی. اگر کاربر به آخرین اسلاید از گروه هم‌پوشان برسد، اسلاید بعدی دوباره نمایش داده خواهد شد.
.TP
.B move-on-mapped
جای‌گذاری پنجره تمام‌صفحه در دو نمایشگر کار دشواری است. برخی از مدیران پنجره (مانند FVWM) اگر جای‌گذاری قبل از نمایش پنجره انجام شود آن را نادیده می‌گیرند. این گزینه یک راه‌حل جایگزین را فعال می‌کند (بولی، پیش‌فرض: false).
.TP
.B next-height
درصد ارتفاع ناحیه «اصلی» ارائه‌دهنده که برای اسلاید بعدی استفاده می‌شود (عدد صحیح، پیش‌فرض: 70).
.TP
.B next-slide-first-overlay
اگر اسلاید بعدی یک گروه هم‌پوشان باشد، نمایش اولین اسلاید آن گروه در نمای اسلاید بعدی به جای آخرین اسلاید آن گروه (بولی، پیش‌فرض: false).
.TP
.B overview-min-size
حداقل عرض برای تصاویر بندانگشتی نمای کلی، بر حسب پیکسل (عدد صحیح، پیش‌فرض: 150).
.TP
.B pointer-color
تنظیم رنگ نشانگر. می‌تواند نام یک رنگ یا نمایشی به صورت
.B #rrggbb
باشد (پیش‌فرض: red).
.TP
.B pointer-opacity
تنظیم میزان کدر بودن نشانگر بر حسب درصد (عدد صحیح، پیش‌فرض: 50).
.TP
.B pointer-size
تنظیم اندازه اولیه نشانگر، بر حسب پیکسل (عدد صحیح، پیش‌فرض: 10).
.TP
.B prerender-delay
میزان تاخیر (بر حسب ثانیه) برای شروع فرایند پیش‌رندر پس از تغییر اسلاید (عدد صحیح، پیش‌فرض: 4).
.TP
.B prerender-slides
تعداد اسلایدهای جلوتر از اسلاید کنونی جهت پیش‌رندر (عدد صحیح، پیش‌فرض: 2). برای غیرفعال کردن پیش‌رندر مقدار را روی 0 تنظیم کنید؛ برای پیش‌رندر یک‌باره همه اسلایدها یک عدد منفی وارد نمایید.
.TP
.B presentation-interactive
امکان واکنش پنجره ارائه به کنش‌های کاربر، همانند پنجره ارائه‌دهنده (بولی، پیش‌فرض: false). توجه داشته باشید اگر پنجره ارائه تنها رابط گرافیکی
pdfpc
باشد (یعنی در صورت اجرا با
.BR \-sS \fR)،
صرف نظر از این گزینه تعاملی خواهد بود.
.TP
.B presentation-screen
صفحه نمایش مورد استفاده برای ارائه (نام خروجی، به عنوان مثال خروجی «xrandr \-\-listmonitors» را ببینید).
.TP
.B presenter-screen
صفحه نمایش مورد استفاده برای ارائه‌دهنده (نام خروجی).
.TP
.B rest-https
اجرای سرور REST در حالت TLS (بولی، پیش‌فرض: false).
.TP
.B rest-port
درگاه (پورت) سرور REST (عدد صحیح، پیش‌فرض: 8088).
.TP
.B rest-passwd
گذرواژه برای احراز هویت در سرور REST (رشته؛ در صورت عدم تنظیم، یک مقدار تصادفی تولید و استفاده می‌شود).
.TP
.B rest-static-root
مسیر ریشه برای ارائه محتوای ایستا HTML. اگر با «/» شروع شود، به عنوان مسیر مطلق تفسیر می‌شود؛ در غیر این صورت، نسبت به
.I /usr/share/pdfpc
سنجیده خواهد شد (رشته، پیش‌فرض: "www").
.TP
.B spotlight-opacity
تنظیم کدر بودن ناحیه خارج از کانون نور (Spotlight) بر حسب درصد (عدد صحیح، پیش‌فرض: 50).
.TP
.B spotlight-size
تنظیم اندازه اولیه کانون نور (Spotlight) بر حسب پیکسل (عدد صحیح، پیش‌فرض: 100).
.TP
.B status-height
درصد ارتفاع صفحه نمایش ارائه‌دهنده که به ناحیه وضعیت (زمان‌سنج، نوار پیشرفت، آیکون‌ها) اختصاص می‌یابد، به طوری که
(100 \- status_height)%
برای ناحیه «اصلی» باقی بماند (عدد صحیح، پیش‌فرض: 10).
.TP
.B switch-screens
جابجایی صفحه ارائه و صفحه ارائه‌دهنده با یکدیگر (بولی، پیش‌فرض: false).
.TP
.B time-of-day
نمایش ساعت جاری به جای زمان‌سنج.
.TP
.B timer-pace-color
فعال‌سازی نشانه‌های رنگی زمان‌سنج برای مشخص کردن مداوم این‌که آیا ارائه مطابق با سرعت مورد انتظار پیش می‌رود یا خیر (بولی، پیش‌فرض: true). توضیحات عملکرد زمان‌سنج را در
\fBpdfpc\fR(1)
ببینید.
.TP
.B toolbox
نمایش جعبه‌ابزار هنگام راه‌اندازی (بولی، پیش‌فرض: false).
.TP
.B toolbox-direction
تنظیم جهت جعبه‌ابزار. مقادیر LtoR،‏ RtoL،‏ TtoB یا BtoT به ترتیب برای چپ‌به‌راست، راست‌به‌چپ، بالا‌به‌پایین یا پایین‌به‌بالا (پیش‌فرض: LtoR).
.TP
.B toolbox-minimized
تنظیم وضعیت اولیه جعبه‌ابزار به صورت کمینه‌شده (بولی، پیش‌فرض: false).
.TP
.B transition-fps
تعداد فریم بر ثانیه برای گذار اسلایدها (عدد صحیح، پیش‌فرض: 25). برای غیرفعال کردن تمامی گذارها روی 0 تنظیم کنید.
.TP
.B windowed-mode
تنظیم حالت پنجره‌ای اولیه: none،‏ presenter،‏ presentation یا both (پیش‌فرض: presenter).

.SH "مثال‌ها (EXAMPLES)"

.PP
برای تغییر رنگ قلم طراحی با استفاده از کلیدهای صفحه کلید عددی (Numpad):

.RS
bind S+KP_1    setPenColor  red
.br
bind S+KP_2    setPenColor  green
.br
bind S+KP_3    setPenColor  blue
.RE

.PP
برای فعال‌سازی همیشگی گزینه black\-on\-end، می‌توان خط زیر را به پرونده پیکربندی افزود:

.RS
option black-on-end true
.RE

.SH "فایل‌ها (FILES)"
.PP
.B /etc/pdfpcrc
.RS 4
پرونده پیکربندی سراسری سیستم
.RE
.PP
.B $XDG_CONFIG_HOME/pdfpc/pdfpcrc
.RS 4
پرونده پیکربندی کاربر (در صورتی که
.B $XDG_CONFIG_HOME
تنظیم نشده باشد،
.I $HOME/.config
استفاده خواهد شد).
.RE


.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpdfpc\fR(1)