| 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_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_2 setPenColor green
bind S+KP_3 setPenColor blue
برای فعالسازی همیشگی گزینه black-on-end، میتوان خط زیر را به پرونده پیکربندی افزود:
فایلها (FILES)
/etc/pdfpcrc
$XDG_CONFIG_HOME/pdfpc/pdfpcrc