نام (NAME)

zathura - یک نمایشگر اسناد

خلاصه دستور (SYNOPSIS)

zathura [-c PATH] [-d PATH] [-p PATH] [-w PASSWORD] [-P NUMBER] [--fork] [-l LEVEL] [-s] [-x CMD] [--synctex-forward INPUT] [--synctex-pid PID] [-find STRING] <files>

توضیحات (DESCRIPTION)

zathura یک نمایشگر اسناد با قابلیت شخصی‌سازی بالا و بسیار کاربردی است. این برنامه یک رابط کاربری کمینه‌گرا و کم‌جا را فراهم می‌کند و استفاده آسان از آن عمدتاً بر تعامل با صفحه‌کلید تمرکز دارد.

zathura فایل‌های ارائه‌شده را نمایش می‌دهد. اگر یک خط تیره منفرد (-) به‌عنوان نام فایل داده شود، محتوا از ورودی استاندارد خوانده خواهد شد. اگر هیچ فایلی داده نشود، یک نمونه خالی از zathura اجرا می‌شود.

گزینه‌ها (OPTIONS)

-c,--config-dir=path: مسیر دایرکتوری پیکربندی
-d,--data-dir=path: مسیر دایرکتوری داده‌ها
-p,--plugins-dir=path: مسیر دایرکتوری حاوی پلاگین‌ها
-w,--password=password: گذرواژه اسناد. اگر چندین سند به‌طور هم‌زمان باز شوند، این گذرواژه برای اولین سند استفاده خواهد شد و zathura در صورت نیاز گذرواژه سایر فایل‌ها را درخواست خواهد کرد.
-P,--page=number: سند را در شماره صفحه مشخص‌شده باز می‌کند. شماره‌گذاری صفحات از ۱ آغاز می‌شود و اعداد منفی نشان‌دهنده شماره صفحات از انتهای سند هستند، که -1 آخرین صفحه است.
-f,--find=string: سند را باز کرده و رشته مشخص‌شده را جستجو می‌کند.
-l,--log-level=level: تنظیم سطح گزارش‌گیری (debug، info، warning، error)
-x,--synctex-editor-command=command: تنظیم دستور ویرایشگر SyncTeX. مقدار تنظیم synctex-editor-command را بازنویسی می‌کند.
--synctex-forward=input: پرش به موقعیت مشخص‌شده. این گزینه همان قالبی را انتظار دارد که برای synctex's view -i تعیین شده است. اگر هیچ نمونه‌ای برای سند مشخص‌شده در حال اجرا نباشد، یک نمونه جدید راه‌اندازی خواهد شد (تنها در صورتی که --synctex-pid مشخص نشده باشد).
--synctex-pid=pid: به‌جای جستجوی نمونه‌ای که فایل صحیح در آن باز باشد، تنها نمونه با PID ارائه‌شده را امتحان می‌کند. توجه داشته باشید که اگر PID ارائه‌شده فایل صحیح را باز نداشته باشد یا وجود نداشته باشد، هیچ نمونه جدیدی راه‌اندازی نخواهد شد.
--mode=mode: راه‌اندازی در یک حالت غیرپیش‌فرض
--fork: انشعاب (fork) به پس‌زمینه
--version: نمایش رشته نسخه و خروج
--help: نمایش راهنما و خروج
عمومی

J, PgDn: رفتن به صفحه بعد
K, PgUp: رفتن به صفحه قبل
h, k, j, l: پیمایش به جهت‌های چپ، پایین، بالا یا راست
Left, Down, Up, Right: پیمایش به جهت‌های چپ، پایین، بالا یا راست
^t, ^d, ^u, ^y: پیمایش نیم‌صفحه به چپ، پایین، بالا یا راست
t, ^f, ^b, space, <S-space>, y: پیمایش یک صفحه کامل به چپ، پایین، بالا یا راست
gg, G, nG: رفتن به صفحه نخست، پایانی یا صفحه‌ی nام
P: تراز شدن روی صفحه فعلی
H, L: رفتن به بالا یا پایین صفحه فعلی
^o, ^i: حرکت به عقب و جلو در فهرست جهش‌ها
^j, ^k: تنصیف به جلو و عقب میان دو نقطه جهش اخیر
^c, Escape: لغو
a, s: تنظیم پنجره در حالت بهترین برازش یا برازش عرض
/, ?: جستجوی متن
n, N: جستجو برای نتیجه بعدی یا قبلی
o, O: باز کردن سند
f: دنبال کردن پیوندها
F: نمایش مقصد پیوند
c: رونوشت از مقصد پیوند در تخته‌گیره
:: ورود دستور
r: چرخش ۹۰ درجه
^r: رنگ‌آمیزی مجدد (سیاه‌وسفید کردن و معکوس‌سازی رنگ‌ها)
R: بارگذاری مجدد سند
Tab: نمایش فهرست و رفتن به حالت فهرست
d: تغییر وضعیت نمای دوصفحه‌ای
D: چرخش ستون بازشونده در نمای دوصفحه‌ای
F5: رفتن به حالت ارائه
F11: رفتن به حالت تمام‌صفحه
^m: تغییر وضعیت نوار ورودی
^n: تغییر وضعیت نوار وضعیت
Escape: پنهان‌سازی نوار اعلان
+, -, =: بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی
zI, zO, z0: بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی
n=: بزرگ‌نمایی به اندازه n
mX: تنظیم یک نشانک سریع روی حرف یا عدد X (ممکن است با عملکرد پیش‌فرض X تداخل داشته باشد، مانند 'O' یا 'P')
'X: رفتن به نشانک سریع ذخیره‌شده روی حرف یا عدد X
q: خروج
w: تغییر وضعیت حالت تک‌صفحه‌ای

حالت تمام‌صفحه

J, K: رفتن به صفحه بعد یا قبل
space, <S-space>, <BackSpace>: پیمایش یک صفحه کامل به پایین یا بالا
gg, G, nG: رفتن به صفحه نخست، پایانی یا صفحه‌ی nام
^c, Escape: لغو
F11: بازگشت به حالت عادی
+, -, =: بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی
zI, zO, z0: بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی
n=: بزرگ‌نمایی به اندازه n
q: خروج

حالت ارائه

space, <S-space>, <BackSpace>: پیمایش یک صفحه کامل به پایین یا بالا
^c, Escape: لغو
F5: بازگشت به حالت عادی
q: خروج

حالت فهرست

k, j حرکت به مدخل بالایی یا پایینی

Up, Down: حرکت به مدخل بالایی یا پایینی
^u, ^d: پیمایش و حرکت به بالا یا پایین به اندازهٔ نصف صفحه
l, Right, zo: گسترش مدخل
zO: گسترش بازگشتی مدخل
L, zR: گسترش تمام مدخل‌ها
h, Left, zc: جمع کردن مدخل
zC: جمع کردن بازگشتی مدخل
H, zM: جمع کردن تمام مدخل‌ها
space, Return, ^j: گزینش و باز کردن مدخل
gg, G: رفتن به اولین یا آخرین مدخل
Tab, Escape, ^[, ^c: پنهان کردن فهرست و رفتن به حالت عادی (normal mode)

کلیدهای موشواره

Scroll: پیمایش به بالا یا پایین
^Scroll: بزرگ‌نمایی یا کوچک‌نمایی
Drag Button2 (middle button drag): حرکت آزادانه روی صفحه (Pan)
Button1 (left click): دنبال کردن پیوند
Drag Button1: گزینش متن
Drag S-Button1: برجسته‌سازی محدوده
Button3 (right click): باز کردن منوی بازشو برای رونوشت/ذخیره تصویر (برای تصاویری فعال می‌شود که توسط دستور export شناسایی شوند)

دستورها (COMMANDS)

bmark: ذخیره یک نشانک.
bdelete: حذف یک نشانک.
blist: فهرست کردن نشانک‌ها.
bjump: پرش به نشانک داده‌شده.
jumplist: نمایش پرش‌های اخیر در فهرست پرش (به‌طور پیش‌فرض ۵ تای آخر). آرگومان اختیاری تعداد مدخل‌های نمایش داده‌شده را تعیین می‌کند. مقدار منفی "-N" همه را به‌جز "N" مدخل اول نشان می‌دهد.
mark: تنظیم یک نشانک سریع (quickmark).
delmarks: حذف یک نشانک سریع. کوتاه‌نوشت: delm.
close: بستن سند.
quit: خروج از zathura. کوتاه‌نوشت: q.
exec: اجرای یک دستور خارجی. $FILE به مسیر سند جاری، $PAGE به شماره صفحهٔ جاری و $DBUS به نام گذرگاه واسط D-Bus گسترش می‌یابند. نام مستعار: ! (هنوز پس از آن به فاصله نیاز است).
info: نمایش اطلاعات سند.
open: باز کردن یک سند. کوتاه‌نوشت: o.
offset: تنظیم آفست (انحراف) صفحه.
print: چاپ سند.
write(!): ذخیره سند (و تحمیل رونویسی). نام مستعار: save(!).
export: برون‌ریزی پیوست‌ها. آرگومان اول شناسهٔ پیوست را مشخص می‌کند (استفاده از تکمیل خودکار با Tab)، آرگومان دوم نام فایل مقصد را مشخص می‌کند (نسبت به پوشهٔ کاری فعلی).
dump: نوشتن مقادیر، توضیحات و غیره مربوط به تمام تنظیمات جاری در یک فایل.
source: بارگذاری یک فایل پیکربندی. تغییر پوشهٔ پیکربندی با ارسال یک آرگومان امکان‌پذیر است.
hlsearch: برجسته‌سازی نتایج جستجوی جاری.
nohlsearch: حذف برجسته‌سازی نتایج جستجوی جاری. کوتاه‌نوشت: nohl.
version: نمایش اطلاعات نسخه.
ظاهر و رفتار پیش‌فرض zathura را می‌توان با تغییر دادن فایل zathurarc (مسیر پیش‌فرض: ~/.config/zathura/zathurarc) بازنویسی کرد. برای توضیحات دقیق‌تر لطفاً به zathurarc(5) مراجعه کنید.

پشتیبانی از SYNCTEX (SYNCTEX SUPPORT)

هر دو نوع همگام‌سازی رو‌به‌جلو و رو‌به‌عقب SyncTeX توسط zathura پشتیبانی می‌شوند. برای فعال‌سازی همگام‌سازی رو‌به‌جلوی SyncTeX، لطفاً به گزینه‌های --synctex-forward و --synctex-editor مراجعه کنید. zathura همچنین یک سیگنال از طریق رابط D-Bus ارسال خواهد کرد. برای پشتیبانی از همگام‌سازی رو‌به‌عقب synctex،‏ zathura یک رابط D-Bus ارائه می‌دهد که توسط ویرایشگر قابل فراخوانی است. برای راحتی بیشتر، zathura همچنین نحوهٔ تجزیهٔ خروجی دستور synctex view را می‌داند. کافی است آرگومان‌های گزینهٔ -i در دستور synctex view را از طریق --synctex-forward به zathura پاس دهید تا zathura اطلاعات را به نمونهٔ صحیح منتقل کند.

برای gvim پشتیبانی از همگام‌سازی رو‌به‌جلو و رو‌به‌عقب می‌تواند به صورت زیر تنظیم شود: ابتدا موارد زیر را به پیکربندی vim اضافه کنید:

function! Synctex()
  execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
  redraw!
endfunction
map <C-enter> :call Synctex()<cr>

سپس zathura را با این دستور اجرا کنید:

zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file

برخی ویرایشگرها به‌طور پیش‌فرض و بدون نیاز به پیکربندی اضافه از zathura به عنوان نمایشگر پشتیبانی می‌کنند:

LaTeXTools برای SublimeText (https://latextools.readthedocs.io/en/latest/available-viewers/#zathura)
LaTeX برای Atom (https://atom.io/packages/latex)

متغیرهای محیطی (ENVIRONMENT VARIABLES)

ZATHURA_PLUGINS_PATH: مسیر دایرکتوری حاوی افزونه‌ها. این دایرکتوری تنها در صورتی در نظر گرفته می‌شود که دایرکتوری دیگری با استفاده از --plugins-dir مشخص نشده باشد.

سندباکس (SANDBOX)

فایل باینری zathura-sandbox برنامهٔ zathura را با یک سندباکس فعال مبتنی بر seccomp و/یا landlock اجرا می‌کند. برخی قابلیت‌ها هنگام استفاده از حالت سندباکس غیرفعال می‌شوند:

ذخیره/نوشتن فایل‌ها
استفاده از روش‌های ورودی مانند ibus
چاپ
نشانک‌ها و تاریخچه
یکپارچه‌سازی با D-Bus
پشتیبانی از SyncTeX

حالت سندباکس هنوز با برخی از پیاده‌سازی‌های libc آزمایشی است. در حال حاضر پیاده‌سازی پشتیبانی‌شده و آزمایش‌شدهٔ libc،‏ glibc است.

باگ‌های شناخته‌شده (KNOWN BUGS)

اگر GDK_NATIVE_WINDOWS فعال باشد، با اسناد حجیم دچار مشکل خواهید شد. در این حالت ممکن است zathura با خطا بسته شود یا صفحات به درستی رندر نشوند. غیرفعال کردن GDK_NATIVE_WINDOWS این مشکل را برطرف می‌کند. همین مشکل ممکن است در صورت فعال بودن overlay-scrollbar در GTK_MODULES نیز رخ دهد..SH "همچنین ببینید (SEE ALSO)"

zathurarc(5)

نویسندگان (AUTHORS)

pwmt.org

کپی‌رایت و تکثیر (COPYRIGHT)

2009-2026, pwmt.org