| ZATHURARC(5) | zathura | ZATHURARC(5) |
نام (NAME)
zathurarc - فایل پیکربندی نمایشگر اسناد zathura
خلاصه دستور (SYNOPSIS)
/etc/zathurarc, $XDG_CONFIG_HOME/zathura/zathurarc
توضیحات (DESCRIPTION)
فایل zathurarc یک فایل متنی ساده است که می‌تواند با دستورات مختلفی برای تغییر رفتار و ظاهر zathura پر شود؛ مواردی که در زیربخش‌های بعدی به شرح آن‌ها خواهیم پرداخت. هر خط (به‌جز خطوط خالی و توضیحات که با علامت # آغاز می‌شوند) به‌طور مستقل ارزیابی می‌شود، بنابراین نوشتن چندین دستور در یک خط امکان‌پذیر نیست.
دستورات (COMMANDS)
دستور set - تغییر گزینه‌ها (Changing options)
علاوه بر دستور درونی :set، برنامه zathura گزینه‌های بیشتری برای تغییر ارائه می‌دهد و این تغییرات را دائمی می‌سازد. برای بازنویسی و تنظیم یک گزینه کافی است خطی با ساختار زیر اضافه کنید:
set <option> <new value>
فیلد option باید با نام گزینه‌ای که قرار است تغییر کند، و فیلد new value با مقدار جدیدی که گزینه باید دریافت کند جایگزین شود. نوع مقدار می‌تواند یکی از موارد زیر باشد:
- INT - یک عدد صحیح
- FLOAT - یک عدد اعشاری (ممیز شناور)
- STRING - یک رشته متنی از نویسه‌ها
- BOOL - یک مقدار بولی ("true" برای درست، "false" برای نادرست)
علاوه بر این توصیه می‌کنیم بخش گزینه‌ها را بررسی کنید تا دید دقیق‌تری از گزینه‌های قابل تغییر و مقادیری که می‌توانند تنظیم شوند به دست آورید.
مثال زیر دید عمیق‌تری درباره نحوه استفاده از دستور set ارائه می‌دهد:
set option1 5 set option2 2.0 set option3 hello set option4 hello\ world set option5 "hello world"
به‌ویژه برای گزینه‌های دارای مقادیر رشته‌ای، توجه داشته باشید که اسکیپ کردن نویسه‌های خاص و فاصله‌ها ضروری است. در مثال بالا، option4 و option5 هر دو روی hello world تنظیم می‌شوند، اما دستور set option6 hello world تنها مقدار hello را برای option6 تعیین خواهد کرد.
برای رنگ‌ها، zathura از کدهای رنگی HTML و مقادیر سبک CSS3 یعنی rgb(r,g,b) و rgba(r,g,b,a) پشتیبانی می‌کند. اگر می‌خواهید برای برخی گزینه‌ها از کدهای رنگی استفاده کنید، حتماً آن‌ها را به‌درستی درون نقل‌قول قرار دهید یا علامت هشتگ (#) را اسکیپ کنید.
set default-fg "#CCBBCC" set default-fg \#CCBBCC
برای rgba، توجه داشته باشید که مؤلفه‌های رنگ را به‌عنوان اعداد صحیح بین 0 تا 255 و مؤلفه آلفا (شفافیت) را به‌عنوان عدد اعشاری بین 0 تا 1 پردازش می‌کند.
دستور include - گنجاندن فایل پیکربندی دیگر (Including another config file)
این دستور امکان گنجاندن سایر فایل‌های پیکربندی را فراهم می‌آورد. در صورت مشخص شدن یک مسیر نسبی، مسیر نسبت به فایل پیکربندی که در حال حاضر پردازش می‌شود، سنجیده خواهد شد.
include another-config
دستور map - نگاشت کلید میانبر (Mapping a shortcut)
امکان نگاشت یا نگاشت مجدد کلیدهای جدید به عملکردهای میانبر وجود دارد که امکان سفارشی‌سازی بالایی را فراهم می‌سازد. دستور :map همچنین می‌تواند در فایل zathurarc استفاده شود تا این تغییرات دائمی شوند:
map [mode] <binding> <shortcut function> <argument>
- حالت (Mode)
- دستور map چندین آرگومان دریافت می‌کند که در آن‌ها تنها آرگومان binding و همچنین آرگومان shortcut-function اجباری هستند. از آنجا که zathura از چندین حالت استفاده می‌کند، می‌توان کلیدها را تنها برای یک حالت خاص با ارسال آرگومان mode نگاشت کرد که می‌تواند یکی از مقادیر زیر را دریافت کند:
- normal (پیش‌فرض)
- fullscreen
- presentation
- index
کروشه‌های اطراف مقدار الزامی هستند.
- نگاشت تک‌کلید (Single key binding)
- آرگومان دوم (احتمالی) کلید مورد استفاده را که باید به عملکرد میانبر نگاشت شود مشخص می‌کند و ساختاری مانند زیر دارد. از یک سو می‌توان صرفاً حروف، اعداد یا نشانه‌های منفرد را به آن اختصاص داد:
map a shortcut_function optional_argument map b shortcut_function optional_argument map c shortcut_function optional_argument map 1 shortcut_function optional_argument map 2 shortcut_function optional_argument map 3 shortcut_function optional_argument map ! shortcut_function optional_argument map ? shortcut_function optional_argument
- استفاده از کلیدهای تغییردهنده (Using modifiers)
- همچنین می‌توان از کلیدهای تغییردهنده مانند کلیدهای Control یا Alt روی صفحه‌کلید استفاده کرد. استفاده از کلیدهای تغییردهنده زیر امکان‌پذیر است:
- A - Alt
- C - Control
- S - Shift
اگر بخواهید از هر یک از کلیدهای تغییردهنده برای یک نگاشت استفاده کنید، لازم است binding با ساختار زیر تعریف شود:
map <A-a> shortcut_function map <C-a> shortcut_function
- کلیدهای ویژه (Special keys)
- برنامه zathura همچنین اجازه می‌دهد کلیدهایی مانند فاصله (space bar) یا تب (tab button) را اختصاص دهید که آن‌ها نیز باید میان علامت‌های بزرگ‌تر و کوچک‌تر قرار گیرند. کلیدهای ویژه زیر در حال حاضر در دسترس هستند:
Identifier Description BackSpace Back space CapsLock Caps lock NumLock Num Lock ScrollLock Scroll Lock Esc Escape Down Arrow down Up Arrow up Left Arrow left Right Arrow right F1 F1 F2 F2 F3 F3 F4 F4 F5 F5 F6 F6 F7 F7 F8 F8 F9 F9 F10 F10 F11 F11 F12 F12 PageDown Page Down PageUp Page Up Return Return Space Space Super Windows key Tab Tab Print Print key KPUp Numpad Up (where the number 8 is) KPDown Numpad Down (where the number 2 is) KPLeft Numpad Left (where the number 4 is) KPRight Numpad Right (where the number 6 is) KPBegin Numpad Center button (where the number 5 is) KPPrior Numpad PageUp (where the number 9 is) KPPageUp Numpad PageUp (where the number 9 is) KPNext Numpad PageDown (where the number 3 is) KPPageDown Numpad PageDown (where the number 3 is) KPHome Numpad Home (where the number 7 is) KPEnd Numpad End (where the number 1 is) KPInsert Numpad Insert (where the number 0 is) KPDelete Numpad Delete (where the numpad period is) KPMultiply Numpad Asterisk KPAdd Numpad Plus sign KPSubtract Numpad Minus sign KPDivide Numpad Slash sign
البته امکان ترکیب این کلیدهای ویژه با یک کلید تغییردهنده وجود دارد. نحوه استفاده از این کلیدها در مثال‌های زیر توضیح داده شده است:
map <Space> shortcut_function map <C-Space> shortcut_function
- دکمه‌های ماوس (Mouse buttons)
- همچنین می‌توان با استفاده از کلیدهای ویژه زیر، دکمه‌های ماوس را به میانبرها نگاشت کرد:
Identifier Description Button1 Mouse button 1 (left) Button2 Mouse button 2 (middle) Button3 Mouse button 3 (right) Button4 Mouse button 4 Button5 Mouse button 5
آن‌ها را می‌توان با کلیدهای تغییردهنده نیز ترکیب کرد:
map <Button1> shortcut_function map <C-Button1> shortcut_function
- دستورات بافر (Buffer commands)
- اگر یک نگاشت با تعاریف قبلی همخوانی نداشته باشد اما همچنان یک نگاشت معتبر باشد، به‌عنوان یک دستور بافر نگاشت خواهد شد:
map abc quit map test quit
- عملکردهای میانبر (Shortcut functions)
- عملکردهای میانبر زیر را می‌توان نگاشت کرد:
- abort
بازگشت به حالت عادی (normal).
- adjust_window
تنظیم عرض صفحه. آرگومان‌های ممکن شامل best-fit و width هستند.
- change_mode
تغییر حالت جاری. حالت مورد نظر را به‌عنوان آرگومان ارسال کنید.
- copy_filepath
کپی مسیر کامل سند بازشده فعلی در کلیپ‌بورد.
- copy_link
کپی مقصد پیوند در کلیپ‌بورد.
- cycle_first_column
در چیدمان چندصفحه‌ای، چرخش ستونی که صفحه نخست در آن نمایش داده می‌شود.
- display_link:
نمایش مقصد پیوند.
- exec:
اجرای یک دستور خارجی. مقدار $FILE به مسیر سند فعلی، $PAGE به شماره صفحه جاری، و $DBUS به نام گذرگاه واسط D-Bus گسترش می‌یابد.
- file_chooser:
باز کردن کادر گفتگوی انتخاب فایل. از انتخابگر فایل بومی سیستم در ویندوز و مک‌اواس، پورتال‌های دسکتاپ در صورت موجود بودن و در غیر این صورت از GtkFileChooser استفاده می‌کند.
- focus_inputbar
بردن فوکوس به نوار ورودی.
- follow
دنبال کردن پیوند.
- goto
رفتن به یک صفحه مشخص.
- jumplist
حرکت به جلو/عقب در فهرست پرش (jumplist). ارسال forward به‌عنوان آرگومان برای رفتن به ورودی بعدی و backward برای رفتن به ورودی قبلی.
- navigate
پیمایش به صفحه بعدی/قبلی.
- navigate_index
پیمایش درون نمایه (فهرست مطالب).
- print
نمایش کادر گفتگوی چاپ.
- page_mode
تنظیم حالت اندازه‌بندی صفحه. پیش‌فرض equal_none است که اندازه صفحات جداگانه را تغییر نمی‌دهد. مقادیر equal_width و equal_height به ترتیب هر صفحه را تغییر اندازه می‌دهند تا دارای عرض و ارتفاع یکسانی باشند.
- quit
خروج از zathura.
- recolor
رنگ‌آمیزی مجدد صفحات.
- reload
بارگذاری مجدد سند.
- rotate
چرخاندن صفحه. ارسال rotate-ccw به‌عنوان آرگومان برای چرخش پادساعت‌گرد و rotate-cw برای چرخش ساعت‌گرد.
- scroll
پیمایش و اسکرول صفحه.
- search
جستجوی مورد بعدی/قبلی. ارسال forward به‌عنوان آرگومان برای جستجوی نتیجه بعدی و backward برای جستجوی نتیجه قبلی.
- set
تنظیم یک گزینه.
- snap_to_page
پرش و قفل شدن روی صفحه جاری. معادل با goto <current_page>
- toggle_fullscreen
جابجایی بین حالت تمام‌صفحه و عادی.
- toggle_index
نمایش یا پنهان‌سازی نمایه.
- toggle_inputbar
نمایش یا پنهان‌سازی نوار ورودی.
- toggle_page_mode
جابجایی میان حالت تک‌صفحه‌ای و چندصفحه‌ای در هر ردیف.
- toggle_single_page_mode
جابجایی میان نمایش شبکه‌ای صفحات و حالت تک‌صفحه‌ای.
- toggle_statusbar
نمایش یا پنهان‌سازی نوار وضعیت.
- zoom
بزرگ‌نمایی یا کوچک‌نمایی.
- zoom_page
بزرگ‌نمایی یا کوچک‌نمایی صفحه جاری.
- mark_add
تنظیم یک نشانه‌گذاری سریع (quickmark).
- mark_evaluate
رفتن به یک نشانه‌گذاری سریع (quickmark).
- feedkeys
شبیه‌سازی فشردن کلیدها. توجه داشته باشید که تمام کلیدها به‌گونه‌ای تفسیر می‌شوند که گویی کلیدی روی صفحه‌کلید فشرده شده است. برای وارد کردن حروف بزرگ، همان قواعد مربوط به نگاشت کلیدها را رعایت کنید؛ برای مثال برای X از <S-X> استفاده کنید.
- ارسال آرگومان‌ها (Pass arguments)
- برخی از عملکردهای میانبر نیاز به آرگومان دارند یا دارای آرگومان‌های اختیاری هستند که رفتار آن‌ها را تحت تأثیر قرار می‌دهد. این آرگومان‌ها را می‌توان به‌عنوان آخرین آرگومان ارسال کرد:
map <C-i> zoom in map <C-o> zoom out
آرگومان‌های ممکن عبارتند از:
- best-fit
- bottom
- backward
- collapse
- collapse-recursive
- collapse-all
- default
- down
- expand
- expand-recursive
- expand-all
- forward
- full-down
- full-up
- half-down
- half-up
- smooth-down
- smooth-up
- in
- left
- next
- out
- page-bottom
- page-top
- previous
- right
- rotate-ccw
- rotate-cw
- select
- specific
- toggle
- top
- up
- width
- equal_none
- equal_width
- equal_height
دستور unmap - حذف یک کلید میانبر (Removing a shortcut)
علاوه بر نگاشت یا نگاشت مجدد کلیدهای سفارشی، امکان حذف کلیدهای موجود با استفاده از دستور :unmap وجود دارد. این دستور به روش زیر استفاده می‌شود (توضیح پارامترها در بخش map این سند شرح داده شده است):
unmap [mode] <binding>
گزینه‌ها (OPTIONS)
این بخش تنظیمات مربوط به رفتار zathura را شرح می‌دهد. تنظیمات ذکر شده در اینجا را می‌توان با set تغییر داد.
- n-completion-items
- حداکثر تعداد موارد پیشنهادی تکمیل خودکار را که نمایش داده می‌شوند تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 15
- completion-bg
- رنگ پس‌زمینه مورد استفاده برای ورودی‌های تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #232323
- completion-fg
- رنگ پیش‌زمینه مورد استفاده برای ورودی‌های تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #DDDDDD
- completion-group-bg
- رنگ پس‌زمینه مورد استفاده برای عناصر گروه‌بندی تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- completion-group-fg
- رنگ پیش‌زمینه مورد استفاده برای عناصر گروه‌بندی تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #DEDEDE
- completion-highlight-bg
- رنگ پس‌زمینه مورد استفاده برای عنصر انتخاب‌شده فعلی در تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #9FBC00
- completion-highlight-fg
- رنگ پیش‌زمینه مورد استفاده برای عنصر انتخاب‌شده فعلی در تکمیل خودکار خط فرمان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #232323
- default-bg
- رنگ پس‌زمینه پیش‌فرض را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- default-fg
- رنگ پیش‌زمینه پیش‌فرض را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #DDDDDD
- exec-command
- دستوری را تعیین می‌کند که باید به ابتدای هر دستور اجراشده با exec اضافه شود.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض:
- font
- فونت مورد استفاده را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: monospace normal 9
- guioptions
- عناصر رابط کاربری گرافیکی (GUI) را نشان می‌دهد یا پنهان می‌کند. اگر حاوی 'c' باشد، خط فرمان نمایش داده می‌شود. اگر حاوی 's' باشد، نوار وضعیت نمایش داده می‌شود. اگر حاوی 'h' باشد، نوار پیمایش افقی نمایش داده می‌شود. اگر حاوی 'v' باشد، نوار پیمایش عمودی نمایش داده می‌شود.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: s
- inputbar-bg
- رنگ پس‌زمینه نوار ورودی را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #131313
- inputbar-fg
- رنگ پیش‌زمینه نوار ورودی را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #9FBC00
- notification-bg
- رنگ پس‌زمینه یک اعلان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- notification-fg
- رنگ پیش‌زمینه یک اعلان را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- notification-error-bg
- رنگ پس‌زمینه یک اعلان خطا را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FF1212
- notification-error-fg
- رنگ پیش‌زمینه یک اعلان خطا را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- notification-warning-bg
- رنگ پس‌زمینه یک اعلان هشدار را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFF712
- notification-warning-fg
- رنگ پیش‌زمینه یک اعلان هشدار را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- statusbar-bg
- رنگ پس‌زمینه نوار وضعیت را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- statusbar-fg
- رنگ پیش‌زمینه نوار وضعیت را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- statusbar-h-padding
- فاصله درونی افقی نوار وضعیت و نوار اعلان را تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 8
- statusbar-v-padding
- فاصله درونی عمودی نوار وضعیت و نوار اعلان را تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 2
- window-height
- ارتفاع پنجره را در هنگام شروع برنامه تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 600
- window-width
- عرض پنجره را در هنگام شروع برنامه تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 800
- abort-clear-search
- تعیین می‌کند که آیا نتایج جستجو هنگام لغو (abort) پاک شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- adjust-open
- تعیین می‌کند هنگام بارگذاری سند از چه حالت تنظیم خودکاری استفاده شود. گزینه‌های ممکن عبارتند از "best-fit" (بهترین تناسب) و "width" (تناسب با عرض).
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: best-fit
- page-mode
- حالت پیش‌فرض اندازه‌بندی صفحه را هنگام باز کردن یک سند تعیین می‌کند. گزینه‌های ممکن عبارتند از "none"، "equal_width" و "equal_height". هنگامی که روی "equal_width" تنظیم شود، تمام صفحات متناسب با عرض صفحه جاری مقیاس‌بندی می‌شوند. هنگامی که روی "equal_height" تنظیم شود، تمام صفحات متناسب با ارتفاع صفحه جاری مقیاس‌بندی می‌شوند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: none
- advance-pages-per-row
- تعیین می‌کند که آیا هنگام جلو بردن صفحه، تعداد صفحات در هر ردیف رعایت شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- continuous-hist-save
- به zathura مشخص می‌کند که تاریخچه سند در هر تغییر صفحه ذخیره شود یا تنها هنگام بستن سند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- database
- موتور پایگاه‌داده مورد استفاده برای نشانک‌ها و تاریخچه ورودی را تعیین می‌کند. مقادیر ممکن عبارتند از "sqlite" و "null". در صورت استفاده از "null"، نشانک‌ها و تاریخچه ورودی ذخیره نخواهند شد.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: sqlite
- dbus-raise-window
- تعیین می‌کند که آیا پنجره zathura هنگام دریافت برخی دستورات از طریق D-Bus بالا آورده شود (رو به جلو بیاید) یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- dbus-service
- سرویس D-Bus را فعال یا غیرفعال می‌کند. در صورت غیرفعال بودن سرویس، همگام‌سازی رو به جلوی SyncTeX در دسترس نخواهد بود.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- double-click-follow
- تعیین می‌کند که آیا دوبار کلیک یا یک‌بار کلیک روی یک پیوند باید موجب دنبال کردن آن شود.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- filemonitor
- موتور پایش فایل را برای بررسی تغییرات فایل‌ها تعیین می‌کند. مقادیر ممکن عبارتند از "glib"، "signal" (در صورت پشتیبانی از مدیریت سیگنال)، و "noop". پایشگر فایل "noop" بارگذاری‌های مجدد را آغاز نمی‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: glib
- first-page-column
- ستونی را که
نخستین
صفحه در آن
نمایش داده
خواهد شد
تعیین
می‌کند. این
تنظیم برای
هر مقدار pages-per-row
طبق الگوی
زیر به‌طور
جداگانه
ذخیره
می‌شود: <1 page per
row>:[<2 pages per row>[: ...]]. در
صورتی که
به‌صراحت
تنظیم نشده
باشد،
آخرین
مقدار در
فهرست برای
تمام تعداد
دیگر صفحات
در هر ردیف
استفاده
خواهد شد.
به‌طور پیش‌فرض، ستون اول برای چیدمان دوصفحه‌ای روی ۲ تنظیم شده است، یعنی مقدار آن 1:2 است. مقدار 1:1:3 صفحه نخست را در چیدمان دوصفحه‌ای در ستون اول قرار می‌دهد، و برای چیدمان‌هایی با ستون‌های بیشتر، صفحه اول در ستون سوم قرار داده خواهد شد.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: 1:2
- highlight-active-color
- رنگی را که برای نمایش عنصر برجسته‌شده انتخابی فعلی استفاده می‌شود تعیین می‌کند (برای مثال: نتیجه جستجوی جاری).
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(0,188,0,0.5)
- highlight-color
- رنگی را که برای برجسته‌سازی بخش‌هایی از سند استفاده می‌شود تعیین می‌کند (برای مثال: نمایش نتایج جستجو).
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(159,251,0,0.5)
- highlight-fg
- رنگی را که برای متن هنگام برجسته‌سازی بخش‌هایی از سند استفاده می‌شود تعیین می‌کند (برای مثال: شماره پیوندها).
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(0,0,0,0.5)
- highlighter-modifier
- کلید تغییردهنده‌ای را که باید همراه با دکمه چپ ماوس فشرده شود تا هایلایتر کشیده شود تعیین می‌کند. مقادیر ممکن عبارتند از "shift"، "ctrl" و "alt".
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: shift
- incremental-search
- جستجوی افزایشی (جستجو هم‌زمان با تایپ کردن) را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- index-active-bg
- رنگ پس‌زمینه عنصر انتخاب‌شده در حالت نمایه (فهرست مطالب) را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #9FBC00
- index-active-fg
- رنگ پیش‌زمینه عنصر انتخاب‌شده در حالت نمایه (فهرست مطالب) را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #232323
- index-bg
- رنگ پس‌زمینه حالت نمایه (فهرست مطالب) را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #232323
- index-fg
- رنگ پیش‌زمینه حالت نمایه (فهرست مطالب) را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #DDDDDD
- jumplist-size
- حداکثر تعداد موقعیت‌ها برای به‌خاطرسپاری در فهرست پرش (jumplist).
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 2000
- link-hadjust
- تراز کردن چپ‌چین مقصدهای پیوند داخلی را (برای مثال از طریق نمایه) فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- link-zoom
- امکان تغییر بزرگ‌نمایی هنگام دنبال کردن پیوندها را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- nohlsearch
- برجسته‌سازی نتایج جستجو را غیرفعال یا فعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- open-first-page
- همیشه اسناد را در صفحه نخست باز می‌کند. در صورت غیرفعال بودن، zathura به آخرین موقعیت به‌خاطرسپرده‌شده پرش خواهد کرد.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- page-cache-size
- حداکثر تعداد صفحاتی را که می‌توان در حافظه نهان (کش) صفحه نگه داشت تعیین می‌کند. هنگامی که حافظه نهان پر است و صفحه جدیدی که کش نشده است نمایان می‌شود، صفحه‌ای در کش که کمترین میزان بازدید اخیر را داشته بیرون انداخته می‌شود تا جایی برای صفحه جدید باز شود. مقادیر بزرگ برای این متغیر توصیه **نمی‌شود**، زیرا منجر به مصرف بخش عمده‌ای از حافظه سیستم خواهد شد.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 15
- page-v-padding
- فاصله درونی عمودی صفحه، شکاف عمودی را بر حسب پیکسل بین هر صفحه رندرشده تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 1
- page-h-padding
- فاصله درونی افقی صفحه، شکاف افقی را بر حسب پیکسل بین هر صفحه رندرشده تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 1
- page-right-to-left
- تعیین می‌کند که آیا صفحات در نمای چندستونی باید از سمت راست شروع شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- page-thumbnail-size
- حداکثر اندازه بندانگشتی را بر حسب پیکسل که می‌تواند در حافظه نهان بندانگشتی به‌ازای هر صفحه نگهداری شود تعیین می‌کند. بندانگشتی برای پیش‌نمایش سریع در هنگام بزرگ‌نمایی، پیش از رندر شدن صفحه مقیاس‌بندی می‌شود. هنگامی که صفحه رندر شد، نتیجه تنها در صورتی به‌عنوان تصویر بندانگشتی ذخیره می‌شود که اندازه آن از این مقدار بیشتر نباشد. یک مقدار بزرگ‌تر کیفیت را افزایش می‌دهد اما باعث ایجاد تأخیر بیشتر در بزرگ‌نمایی شده و حافظه بیشتری از سیستم مصرف می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 4194304 (4M)
- pages-per-row
- تعداد صفحاتی را که در کنار یکدیگر در یک ردیف رندر می‌شوند تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 1
- recolor
- رنگ‌آمیزی مجدد (Recoloring) را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- recolor-adjust-lightness
- تنظیم روشنایی هنگام رنگ‌آمیزی مجدد را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- recolor-darkcolor
- مقدار رنگی را که برای نمایش رنگ‌های تیره در حالت رنگ‌آمیزی مجدد استفاده می‌شود تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- recolor-keephue
- حفظ رنگ‌مایه اصلی را هنگام رنگ‌آمیزی مجدد فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- recolor-lightcolor
- مقدار رنگی را که برای نمایش رنگ‌های روشن در حالت رنگ‌آمیزی مجدد استفاده می‌شود تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- recolor-reverse-video
- تعیین می‌کند که آیا رنگ‌های اصلی تصویر هنگام رنگ‌آمیزی مجدد حفظ شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- render-loading
- تعیین می‌کند که آیا متن "Loading..." (در حال بارگذاری...) هنگام رندر شدن صفحه نمایش داده شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- render-loading-bg
- رنگ پس‌زمینه مورد استفاده برای متن "Loading..." را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #FFFFFF
- render-loading-fg
- رنگ پیش‌زمینه مورد استفاده برای متن "Loading..." را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: #000000
- scroll-full-overlap
- نسبتی از ناحیه مشاهده فعلی را که باید پس از پیمایش یک صفحه کامل قابل مشاهده باشد تعیین می‌کند.
- نوع مقدار: عدد اعشاری (Float)
- مقدار پیش‌فرض: 0
- scroll-hstep
- اندازه گام افقی پیمایش را با یک‌بار فراخوانی دستور scroll تعیین می‌کند.
- نوع مقدار: عدد اعشاری (Float)
- مقدار پیش‌فرض: -1
- scroll-step
- اندازه گام پیمایش را با یک‌بار فراخوانی دستور scroll تعیین می‌کند.
- نوع مقدار: عدد اعشاری (Float)
- مقدار پیش‌فرض: 40
- scroll-page-aware
- تعیین می‌کند که آیا پیمایش بر اساس نصف یا یک صفحه کامل در مرزهای صفحه متوقف شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- scroll-wrap
- تعیین می‌کند که آیا آخرین/اولین صفحه پیوسته چرخشی پیمایش شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- search-hadjust
- نمایش افقی متمرکز در مرکز نتایج جستجو را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- selection-clipboard
- کلیپ‌بورد سامانه‌ی پنجره‌ای X را که داده‌های انتخاب‌شده با ماوس در آن نوشته می‌شوند تعیین می‌کند. هنگامی که روی "clipboard" باشد، داده‌های انتخاب‌شده در کلیپ‌بورد CLIPBOARD نوشته می‌شوند و می‌توان آن‌ها را با ترکیب کلیدهای Ctrl+v الصاق کرد. هنگامی که روی "primary" باشد، داده‌های انتخاب‌شده در کلیپ‌بورد PRIMARY نوشته می‌شوند و می‌توان با استفاده از کلیک وسط ماوس یا ترکیب کلیدهای Shift-Insert آن‌ها را الصاق کرد. مقدار "false" می‌تواند برای غیرفعال کردن کپی در کلیپ‌بورد استفاده شود.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: primary
- selection-notification
- تعیین می‌کند که آیا پس از انتخاب متن، یک اعلان نمایش داده شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- signature-error-color
- رنگ پس‌زمینه را هنگام نمایش اطلاعات تکمیلی برای امضاهای دارای خطا تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(92%,11%,14%,0.9)
- signature-success-color
- رنگ پس‌زمینه را هنگام نمایش اطلاعات تکمیلی برای امضاهای معتبر تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(18%,80%,33%,0.9)
- signature-warning-color
- رنگ پس‌زمینه را هنگام نمایش اطلاعات تکمیلی برای امضاهای دارای هشدار تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: rgba(100%,84%,0%,0.9)
- single-page-mode
- تعیین می‌کند که آیا اسناد در حالت نمای تک‌صفحه‌ای باز شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- show-directories
- تعیین می‌کند که آیا پوشه‌ها (دایرکتوری‌ها) در تکمیل خودکار نمایش داده شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- show-hidden
- تعیین می‌کند که آیا فایل‌ها و پوشه‌های مخفی در تکمیل خودکار نمایش داده شوند یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- show-recent
- تعداد فایل‌های اخیری را که باید در تکمیل خودکار نمایش داده شوند تعیین می‌کند. اگر مقدار منفی باشد، هیچ سقف بالایی اعمال نمی‌شود. اگر مقدار 0 باشد، هیچ فایل اخیری نمایش داده نخواهد شد.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 10
- show-signature-information
- تعیین می‌کند که آیا اطلاعات تکمیلی درباره امضاهای تعبیه‌شده در اسناد نمایش داده شود یا خیر.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- statusbar-basename
- استفاده از نام پایه فایل (بدون مسیر) در نوار وضعیت.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- statusbar-home-tilde
- نمایش نگارش کوتاهی از مسیر فایل که در آن HOME$ با ~ در نوار وضعیت جایگزین می‌شود.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- statusbar-page-percent
- نمایش (صفحه فعلی / کل صفحات) به‌صورت درصد در نوار وضعیت.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- synctex
- پشتیبانی از همگام‌سازی رو به عقب SyncTeX را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: true
- synctex-edit-modifier
- کلید تغییردهنده‌ای را که باید به همراه کلیک چپ ماوس فشرده شود تا همگام‌سازی رو به عقب SyncTeX اجرا شود تعیین می‌کند. مقادیر ممکن عبارتند از "shift"، "ctrl" و "alt".
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض: ctrl
- synctex-editor-command
- دستور اجراشده برای همگام‌سازی رو به عقب SyncTeX را تعیین می‌کند.
- نوع مقدار: رشته (String)
- مقدار پیش‌فرض:
- vertical-center
- مرکز کردن صفحه در نقطه میانی عمودی صفحه نمایش به‌صورت پیش‌فرض.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- window-title-basename
- استفاده از نام پایه فایل (بدون مسیر) در عنوان پنجره.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- window-title-home-tilde
- نمایش نگارش کوتاهی از مسیر فایل که در آن HOME$ با ~ در عنوان پنجره جایگزین می‌شود.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- window-title-page
- نمایش شماره صفحه در عنوان پنجره.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- zoom-center
- بزرگ‌نمایی متمرکز در مرکز به‌صورت افقی را فعال یا غیرفعال می‌کند.
- نوع مقدار: بولی (Boolean)
- مقدار پیش‌فرض: false
- zoom-max
- حداکثر درصد مجازی را که سطح بزرگ‌نمایی می‌تواند داشته باشد تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 1000
- zoom-min
- حداقل درصد مجازی را که سطح بزرگ‌نمایی می‌تواند داشته باشد تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 10
- zoom-step
- میزان درصدی را که در هر دستور، بزرگ‌نمایی یا کوچک‌نمایی انجام می‌شود تعیین می‌کند.
- نوع مقدار: عدد صحیح (Integer)
- مقدار پیش‌فرض: 10
همچنین ببینید (SEE ALSO)
zathura(1)
نویسندگان (AUTHORS)
pwmt.org
حق نشر (COPYRIGHT)
2009-2026, pwmt.org
| 2026-07-18 | 2026.07.18 |