PDFPCRC(5)                    File Formats Manual                   PDFPCRC(5)



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


توضیحات (DESCRIPTION)
       برنامه pdfpc(1) ابتدا پرونده پیکربندی سراسری سیستم و سپس در صورت وجود،
       پرونده پیکربندی اختصاصی کاربر را می‌خواند.


   کلیدهای میانبر (Keybindings)
       دستورهای زیر پذیرفته می‌شوند:

       bind <key> <action> [<arg>]
              اتصال یک کلید به یک عمل، همراه با ارسال آرگومان مشخص‌شده برای
              عمل‌هایی که به آن نیاز دارند.

       unbind <key>
              لغو اتصال کلید داده‌شده.

       unbind_all
              پاک‌سازی تمام اتصالات کلیدها.

       mouse <button> <action>
              اتصال یک دکمه موشواره به یک عمل.

       unmouse <button>
              لغو اتصال یک دکمه موشواره.

       unmouse_all
              پاک‌سازی تمام اتصالات موشواره.


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


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


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


   گزینه‌ها (Options)
       برخی از تغییرات دائمی را می‌توان از طریق پرونده پیکربندی تنظیم کرد.
       ساختار نگارش به صورت زیر است:

       option <option_name> <option_value>


       نام‌های گزینه (option_name) زیر پشتیبانی می‌شوند:


       black-on-end
              افزودن یک اسلاید سیاه اضافی در پایان ارائه (بولی، پیش‌فرض:
              false).

       cache-clean-period
              دوره زمانی (بر حسب ثانیه) برای بررسی محتوای منقضی‌شده در حافظه
              نهان (عدد صحیح، پیش‌فرض: 60).

       cache-expiration
              مدت زمان (بر حسب ثانیه) برای نگهداری اسلایدهای رندرشده (یا
              پیش‌رندرشده) در حافظه نهان (عدد صحیح، پیش‌فرض: 600). برای نگهداری
              دائمی اسلایدهای ذخیره‌شده در حافظه نهان، مقدار منفی تعیین کنید.

       cache-max-rtime
              حداکثر زمان (بر حسب میلی‌ثانیه) رندر یک اسلاید برای این‌که حافظه
              نهان آن در برابر انقضا محافظت شود (عدد صحیح، پیش‌فرض: 1000).

       cache-min-rtime
              حداقل زمان (بر حسب میلی‌ثانیه) رندر یک اسلاید برای این‌که در حافظه
              نهان ذخیره شود (عدد صحیح، پیش‌فرض: 10).

       cache-max-usize
              حداکثر اندازه (بر حسب کیلوبایت) تصویر یک اسلاید برای ذخیره‌سازی
              غیرفشرده در حافظه نهان (عدد صحیح، پیش‌فرض: 256).

       current-height
              درصد ارتفاع ناحیه «اصلی» ارائه‌دهنده که برای اسلاید کنونی استفاده
              می‌شود (عدد صحیح، پیش‌فرض: 80).

       current-size
              درصد عرض صفحه نمایش ارائه‌دهنده که برای اسلاید کنونی استفاده
              می‌شود (عدد صحیح، پیش‌فرض: 60).

       cursor-timeout
              مدت زمان عدم فعالیت موشواره (بر حسب ثانیه) که پس از آن مکان‌نما
              پنهان می‌شود (عدد صحیح، پیش‌فرض: 2).

       disable-input-autodetection
              عدم تشخیص خودکار نوع دستگاه‌های ورودی تبلت (قلم یا پاک‌کن) (بولی،
              پیش‌فرض: false).

       disable-input-pressure
              نادیده گرفتن حساسیت به فشار دستگاه‌های ورودی تبلت (قلم یا پاک‌کن)
              حتی زمانی که توسط سخت‌افزار پشتیبانی می‌شود (بولی، پیش‌فرض: false).

       disable-scrolling
              غیرفعال کردن رویدادهای پیمایش (اسکرول) در پنجره ارائه‌دهنده
              (بولی، پیش‌فرض: false).

       disable-tooltips
              غیرفعال کردن پیش‌نمایش‌های راهنما برای جعبه‌ابزار (بولی، پیش‌فرض:
              false).

       enable-auto-srt-load
              تلاش برای بارگذاری خودکار پرونده‌های زیرنویس ویدیو. برای هر رسانه
              ویدیویی، pdfpc پسوند .srt را به نشانی رسانه افزوده و تلاش می‌کند
              پرونده زیرنویس (در قالب SRT) را از آن محل بارگذاری نماید (بولی،
              پیش‌فرض: false).

       final-slide
              نمایش اسلاید پایانی یک گروه هم‌پوشان (Overlay) به جای اسلاید
              بعدی. اگر کاربر به آخرین اسلاید از گروه هم‌پوشان برسد، اسلاید
              بعدی دوباره نمایش داده خواهد شد.

       move-on-mapped
              جای‌گذاری پنجره تمام‌صفحه در دو نمایشگر کار دشواری است. برخی از
              مدیران پنجره (مانند FVWM) اگر جای‌گذاری قبل از نمایش پنجره انجام
              شود آن را نادیده می‌گیرند. این گزینه یک راه‌حل جایگزین را فعال
              می‌کند (بولی، پیش‌فرض: false).

       next-height
              درصد ارتفاع ناحیه «اصلی» ارائه‌دهنده که برای اسلاید بعدی استفاده
              می‌شود (عدد صحیح، پیش‌فرض: 70).

       next-slide-first-overlay
              اگر اسلاید بعدی یک گروه هم‌پوشان باشد، نمایش اولین اسلاید آن گروه
              در نمای اسلاید بعدی به جای آخرین اسلاید آن گروه (بولی، پیش‌فرض:
              false).

       overview-min-size
              حداقل عرض برای تصاویر بندانگشتی نمای کلی، بر حسب پیکسل (عدد
              صحیح، پیش‌فرض: 150).

       pointer-color
              تنظیم رنگ نشانگر. می‌تواند نام یک رنگ یا نمایشی به صورت #rrggbb
              باشد (پیش‌فرض: red).

       pointer-opacity
              تنظیم میزان کدر بودن نشانگر بر حسب درصد (عدد صحیح، پیش‌فرض: 50).

       pointer-size
              تنظیم اندازه اولیه نشانگر، بر حسب پیکسل (عدد صحیح، پیش‌فرض: 10).

       prerender-delay
              میزان تاخیر (بر حسب ثانیه) برای شروع فرایند پیش‌رندر پس از تغییر
              اسلاید (عدد صحیح، پیش‌فرض: 4).

       prerender-slides
              تعداد اسلایدهای جلوتر از اسلاید کنونی جهت پیش‌رندر (عدد صحیح،
              پیش‌فرض: 2). برای غیرفعال کردن پیش‌رندر مقدار را روی 0 تنظیم کنید؛
              برای پیش‌رندر یک‌باره همه اسلایدها یک عدد منفی وارد نمایید.

       presentation-interactive
              امکان واکنش پنجره ارائه به کنش‌های کاربر، همانند پنجره ارائه‌دهنده
              (بولی، پیش‌فرض: false). توجه داشته باشید اگر پنجره ارائه تنها
              رابط گرافیکی pdfpc باشد (یعنی در صورت اجرا با -sS)، صرف نظر از
              این گزینه تعاملی خواهد بود.

       presentation-screen
              صفحه نمایش مورد استفاده برای ارائه (نام خروجی، به عنوان مثال
              خروجی «xrandr --listmonitors» را ببینید).

       presenter-screen
              صفحه نمایش مورد استفاده برای ارائه‌دهنده (نام خروجی).

       rest-https
              اجرای سرور REST در حالت TLS (بولی، پیش‌فرض: false).

       rest-port
              درگاه (پورت) سرور REST (عدد صحیح، پیش‌فرض: 8088).

       rest-passwd
              گذرواژه برای احراز هویت در سرور REST (رشته؛ در صورت عدم تنظیم،
              یک مقدار تصادفی تولید و استفاده می‌شود).

       rest-static-root
              مسیر ریشه برای ارائه محتوای ایستا HTML. اگر با «/» شروع شود، به
              عنوان مسیر مطلق تفسیر می‌شود؛ در غیر این صورت، نسبت به
              /usr/share/pdfpc سنجیده خواهد شد (رشته، پیش‌فرض: "www").

       spotlight-opacity
              تنظیم کدر بودن ناحیه خارج از کانون نور (Spotlight) بر حسب درصد
              (عدد صحیح، پیش‌فرض: 50).

       spotlight-size
              تنظیم اندازه اولیه کانون نور (Spotlight) بر حسب پیکسل (عدد صحیح،
              پیش‌فرض: 100).

       status-height
              درصد ارتفاع صفحه نمایش ارائه‌دهنده که به ناحیه وضعیت (زمان‌سنج،
              نوار پیشرفت، آیکون‌ها) اختصاص می‌یابد، به طوری که (100 -
              status_height)% برای ناحیه «اصلی» باقی بماند (عدد صحیح، پیش‌فرض:
              10).

       switch-screens
              جابجایی صفحه ارائه و صفحه ارائه‌دهنده با یکدیگر (بولی، پیش‌فرض:
              false).

       time-of-day
              نمایش ساعت جاری به جای زمان‌سنج.

       timer-pace-color
              فعال‌سازی نشانه‌های رنگی زمان‌سنج برای مشخص کردن مداوم این‌که آیا
              ارائه مطابق با سرعت مورد انتظار پیش می‌رود یا خیر (بولی، پیش‌فرض:
              true). توضیحات عملکرد زمان‌سنج را در pdfpc(1) ببینید.

       toolbox
              نمایش جعبه‌ابزار هنگام راه‌اندازی (بولی، پیش‌فرض: false).

       toolbox-direction
              تنظیم جهت جعبه‌ابزار. مقادیر LtoR،‏ RtoL،‏ TtoB یا BtoT به ترتیب
              برای چپ‌به‌راست، راست‌به‌چپ، بالا‌به‌پایین یا پایین‌به‌بالا (پیش‌فرض:
              LtoR).

       toolbox-minimized
              تنظیم وضعیت اولیه جعبه‌ابزار به صورت کمینه‌شده (بولی، پیش‌فرض:
              false).

       transition-fps
              تعداد فریم بر ثانیه برای گذار اسلایدها (عدد صحیح، پیش‌فرض: 25).
              برای غیرفعال کردن تمامی گذارها روی 0 تنظیم کنید.

       windowed-mode
              تنظیم حالت پنجره‌ای اولیه: none،‏ presenter،‏ presentation یا both
              (پیش‌فرض: presenter).


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

              bind S+KP_1    setPenColor  red
              bind S+KP_2    setPenColor  green
              bind S+KP_3    setPenColor  blue


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

              option black-on-end true


فایل‌ها (FILES)
       /etc/pdfpcrc
           پرونده پیکربندی سراسری سیستم

       $XDG_CONFIG_HOME/pdfpc/pdfpcrc
           پرونده پیکربندی کاربر (در صورتی که $XDG_CONFIG_HOME تنظیم نشده
           باشد، $HOME/.config استفاده خواهد شد).



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

                                                                    PDFPCRC(5)