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                      ZATHURARC(5)