.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "ZATHURA" "1" "2026-07-18" "2026.07.18" "zathura" .SH "نام (NAME)" zathura \- یک نمایشگر اسناد .SH "خلاصه دستور (SYNOPSIS)" .sp 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] .SH "توضیحات (DESCRIPTION)" .sp \fBzathura\fP یک نمایشگر اسناد با قابلیت شخصی‌سازی بالا و بسیار کاربردی است. این برنامه یک رابط کاربری کمینه‌گرا و کم‌جا را فراهم می‌کند و استفاده آسان از آن عمدتاً بر تعامل با صفحه‌کلید تمرکز دارد. .sp \fBzathura\fP فایل‌های ارائه‌شده را نمایش می‌دهد. اگر یک خط تیره منفرد (\-) به‌عنوان نام فایل داده شود، محتوا از ورودی استاندارد خوانده خواهد شد. اگر هیچ فایلی داده نشود، یک نمونه خالی از \fBzathura\fP اجرا می‌شود. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .BI \-c\fP,\fB \-\-config\-dir\fB= path مسیر دایرکتوری پیکربندی .TP .BI \-d\fP,\fB \-\-data\-dir\fB= path مسیر دایرکتوری داده‌ها .TP .BI \-p\fP,\fB \-\-plugins\-dir\fB= path مسیر دایرکتوری حاوی پلاگین‌ها .TP .BI \-w\fP,\fB \-\-password\fB= password گذرواژه اسناد. اگر چندین سند به‌طور هم‌زمان باز شوند، این گذرواژه برای اولین سند استفاده خواهد شد و zathura در صورت نیاز گذرواژه سایر فایل‌ها را درخواست خواهد کرد. .TP .BI \-P\fP,\fB \-\-page\fB= number سند را در شماره صفحه مشخص‌شده باز می‌کند. شماره‌گذاری صفحات از ۱ آغاز می‌شود و اعداد منفی نشان‌دهنده شماره صفحات از انتهای سند هستند، که \-1 آخرین صفحه است. .TP .BI \-f\fP,\fB \-\-find\fB= string سند را باز کرده و رشته مشخص‌شده را جستجو می‌کند. .TP .BI \-l\fP,\fB \-\-log\-level\fB= level تنظیم سطح گزارش‌گیری (debug، info، warning، error) .TP .BI \-x\fP,\fB \-\-synctex\-editor\-command\fB= command تنظیم دستور ویرایشگر SyncTeX. مقدار تنظیم synctex\-editor\-command را بازنویسی می‌کند. .TP .BI \-\-synctex\-forward\fB= input پرش به موقعیت مشخص‌شده. این گزینه همان قالبی را انتظار دارد که برای synctex\(aqs view \-i تعیین شده است. اگر هیچ نمونه‌ای برای سند مشخص‌شده در حال اجرا نباشد، یک نمونه جدید راه‌اندازی خواهد شد (تنها در صورتی که \-\-synctex\-pid مشخص نشده باشد). .TP .BI \-\-synctex\-pid\fB= pid به‌جای جستجوی نمونه‌ای که فایل صحیح در آن باز باشد، تنها نمونه با PID ارائه‌شده را امتحان می‌کند. توجه داشته باشید که اگر PID ارائه‌شده فایل صحیح را باز نداشته باشد یا وجود نداشته باشد، هیچ نمونه جدیدی راه‌اندازی نخواهد شد. .TP .BI \-\-mode\fB= mode راه‌اندازی در یک حالت غیرپیش‌فرض .TP .B \-\-fork انشعاب (fork) به پس‌زمینه .TP .B \-\-version نمایش رشته نسخه و خروج .TP .B \-\-help نمایش راهنما و خروج .UNINDENT.SH "کلیدها و عملکردهای موشواره (MOUSE AND KEY BINDINGS)" .sp عمومی .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B J, PgDn رفتن به صفحه بعد .TP .B K, PgUp رفتن به صفحه قبل .TP .B h, k, j, l پیمایش به جهت‌های چپ، پایین، بالا یا راست .TP .B Left, Down, Up, Right پیمایش به جهت‌های چپ، پایین، بالا یا راست .TP .B ^t, ^d, ^u, ^y پیمایش نیم‌صفحه به چپ، پایین، بالا یا راست .TP .B t, ^f, ^b, space, , y پیمایش یک صفحه کامل به چپ، پایین، بالا یا راست .TP .B gg, G, nG رفتن به صفحه نخست، پایانی یا صفحه‌ی nام .TP .B P تراز شدن روی صفحه فعلی .TP .B H, L رفتن به بالا یا پایین صفحه فعلی .TP .B ^o, ^i حرکت به عقب و جلو در فهرست جهش‌ها .TP .B ^j, ^k تنصیف به جلو و عقب میان دو نقطه جهش اخیر .TP .B ^c, Escape لغو .TP .B a, s تنظیم پنجره در حالت بهترین برازش یا برازش عرض .TP .B /, ? جستجوی متن .TP .B n, N جستجو برای نتیجه بعدی یا قبلی .TP .B o, O باز کردن سند .TP .B f دنبال کردن پیوندها .TP .B F نمایش مقصد پیوند .TP .B c رونوشت از مقصد پیوند در تخته‌گیره .TP .B : ورود دستور .TP .B r چرخش ۹۰ درجه .TP .B ^r رنگ‌آمیزی مجدد (سیاه‌وسفید کردن و معکوس‌سازی رنگ‌ها) .TP .B R بارگذاری مجدد سند .TP .B Tab نمایش فهرست و رفتن به \fBحالت فهرست\fP .TP .B d تغییر وضعیت نمای دوصفحه‌ای .TP .B D چرخش ستون بازشونده در نمای دوصفحه‌ای .TP .B F5 رفتن به حالت ارائه .TP .B F11 رفتن به حالت تمام‌صفحه .TP .B ^m تغییر وضعیت نوار ورودی .TP .B ^n تغییر وضعیت نوار وضعیت .TP .B Escape پنهان‌سازی نوار اعلان .TP .B +, \-, = بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی .TP .B zI, zO, z0 بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی .TP .B n= بزرگ‌نمایی به اندازه n .TP .B mX تنظیم یک نشانک سریع روی حرف یا عدد X (ممکن است با عملکرد پیش‌فرض X تداخل داشته باشد، مانند \(aqO\(aq یا \(aqP\(aq) .TP .B \(aqX رفتن به نشانک سریع ذخیره‌شده روی حرف یا عدد X .TP .B q خروج .TP .B w تغییر وضعیت حالت تک‌صفحه‌ای .UNINDENT .UNINDENT .UNINDENT .sp حالت تمام‌صفحه .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B J, K رفتن به صفحه بعد یا قبل .TP .B space, , پیمایش یک صفحه کامل به پایین یا بالا .TP .B gg, G, nG رفتن به صفحه نخست، پایانی یا صفحه‌ی nام .TP .B ^c, Escape لغو .TP .B F11 بازگشت به حالت عادی .TP .B +, \-, = بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی .TP .B zI, zO, z0 بزرگ‌نمایی، کوچک‌نمایی یا بازگشت به اندازه اصلی .TP .B n= بزرگ‌نمایی به اندازه n .TP .B q خروج .UNINDENT .UNINDENT .UNINDENT .sp حالت ارائه .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B space, , پیمایش یک صفحه کامل به پایین یا بالا .TP .B ^c, Escape لغو .TP .B F5 بازگشت به حالت عادی .TP .B q خروج .UNINDENT .UNINDENT .UNINDENT .sp حالت فهرست .INDENT 0.0 .INDENT 3.5 .INDENT 0.0.TP .B k, j حرکت به مدخل بالایی یا پایینی .TP .B Up, Down حرکت به مدخل بالایی یا پایینی .TP .B ^u, ^d پیمایش و حرکت به بالا یا پایین به اندازهٔ نصف صفحه .TP .B l, Right, zo گسترش مدخل .TP .B zO گسترش بازگشتی مدخل .TP .B L, zR گسترش تمام مدخل‌ها .TP .B h, Left, zc جمع کردن مدخل .TP .B zC جمع کردن بازگشتی مدخل .TP .B H, zM جمع کردن تمام مدخل‌ها .TP .B space, Return, ^j گزینش و باز کردن مدخل .TP .B gg, G رفتن به اولین یا آخرین مدخل .TP .B Tab, Escape, ^[, ^c پنهان کردن فهرست و رفتن به حالت عادی (normal mode) .UNINDENT .UNINDENT .UNINDENT .sp کلیدهای موشواره .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B Scroll پیمایش به بالا یا پایین .TP .B ^Scroll بزرگ‌نمایی یا کوچک‌نمایی .TP .B Drag Button2 (middle button drag) حرکت آزادانه روی صفحه (Pan) .TP .B Button1 (left click) دنبال کردن پیوند .TP .B Drag Button1 گزینش متن .TP .B Drag S\-Button1 برجسته‌سازی محدوده .TP .B Button3 (right click) باز کردن منوی بازشو برای رونوشت/ذخیره تصویر (برای تصاویری فعال می‌شود که توسط دستور \fBexport\fP شناسایی شوند) .UNINDENT .UNINDENT .UNINDENT .SH "دستورها (COMMANDS)" .INDENT 0.0 .TP .B bmark ذخیره یک نشانک. .TP .B bdelete حذف یک نشانک. .TP .B blist فهرست کردن نشانک‌ها. .TP .B bjump پرش به نشانک داده‌شده. .TP .B jumplist نمایش پرش‌های اخیر در فهرست پرش (به‌طور پیش‌فرض ۵ تای آخر). آرگومان اختیاری تعداد مدخل‌های نمایش داده‌شده را تعیین می‌کند. مقدار منفی \(dq\-N\(dq همه را به‌جز \(dqN\(dq مدخل اول نشان می‌دهد. .TP .B mark تنظیم یک نشانک سریع (quickmark). .TP .B delmarks حذف یک نشانک سریع. کوتاه‌نوشت: \fBdelm\fP\&. .TP .B close بستن سند. .TP .B quit خروج از zathura. کوتاه‌نوشت: \fBq\fP\&. .TP .B exec اجرای یک دستور خارجی. \fB$FILE\fP به مسیر سند جاری، \fB$PAGE\fP به شماره صفحهٔ جاری و \fB$DBUS\fP به نام گذرگاه واسط D\-Bus گسترش می‌یابند. نام مستعار: \fB!\fP (هنوز پس از آن به فاصله نیاز است). .TP .B info نمایش اطلاعات سند. .TP .B open باز کردن یک سند. کوتاه‌نوشت: \fBo\fP\&. .TP .B offset تنظیم آفست (انحراف) صفحه. .TP .B print چاپ سند. .TP .B write(!) ذخیره سند (و تحمیل رونویسی). نام مستعار: \fBsave(!)\fP\&. .TP .B export برون‌ریزی پیوست‌ها. آرگومان اول شناسهٔ پیوست را مشخص می‌کند (استفاده از تکمیل خودکار با \fBTab\fP)، آرگومان دوم نام فایل مقصد را مشخص می‌کند (نسبت به پوشهٔ کاری فعلی). .TP .B dump نوشتن مقادیر، توضیحات و غیره مربوط به تمام تنظیمات جاری در یک فایل. .TP .B source بارگذاری یک فایل پیکربندی. تغییر پوشهٔ پیکربندی با ارسال یک آرگومان امکان‌پذیر است. .TP .B hlsearch برجسته‌سازی نتایج جستجوی جاری. .TP .B nohlsearch حذف برجسته‌سازی نتایج جستجوی جاری. کوتاه‌نوشت: \fBnohl\fP\&. .TP .B version نمایش اطلاعات نسخه. .UNINDENT.SH "پیکربندی (CONFIGURATION)" .sp ظاهر و رفتار پیش‌فرض zathura را می‌توان با تغییر دادن فایل \fIzathurarc\fP (مسیر پیش‌فرض: ~/.config/zathura/zathurarc) بازنویسی کرد. برای توضیحات دقیق‌تر لطفاً به zathurarc(5) مراجعه کنید. .SH "پشتیبانی از SYNCTEX (SYNCTEX SUPPORT)" .sp هر دو نوع همگام‌سازی رو‌به‌جلو و رو‌به‌عقب SyncTeX توسط zathura پشتیبانی می‌شوند. برای فعال‌سازی همگام‌سازی رو‌به‌جلوی SyncTeX، لطفاً به گزینه‌های \fI\-\-synctex\-forward\fP و \fI\-\-synctex\-editor\fP مراجعه کنید. zathura همچنین یک سیگنال از طریق رابط D\-Bus ارسال خواهد کرد. برای پشتیبانی از همگام‌سازی رو‌به‌عقب synctex،‏ zathura یک رابط D\-Bus ارائه می‌دهد که توسط ویرایشگر قابل فراخوانی است. برای راحتی بیشتر، zathura همچنین نحوهٔ تجزیهٔ خروجی دستور \fIsynctex view\fP را می‌داند. کافی است آرگومان‌های گزینهٔ \fI\-i\fP در دستور \fIsynctex view\fP را از طریق \fI\-\-synctex\-forward\fP به zathura پاس دهید تا zathura اطلاعات را به نمونهٔ صحیح منتقل کند. .sp برای gvim پشتیبانی از همگام‌سازی رو‌به‌جلو و رو‌به‌عقب می‌تواند به صورت زیر تنظیم شود: ابتدا موارد زیر را به پیکربندی vim اضافه کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX function! Synctex() execute \(dqsilent !zathura \-\-synctex\-forward \(dq . line(\(aq.\(aq) . \(dq:\(dq . col(\(aq.\(aq) . \(dq:\(dq . bufname(\(aq%\(aq) . \(dq \(dq . g:syncpdf redraw! endfunction map :call Synctex() .EE .UNINDENT .UNINDENT .sp سپس \fIzathura\fP را با این دستور اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX zathura \-x \(dqgvim \-\-servername vim \-c \e\(dqlet g:syncpdf=\(aq$1\(aq\e\(dq \-\-remote +%{line} %{input}\(dq $file .EE .UNINDENT .UNINDENT .sp برخی ویرایشگرها به‌طور پیش‌فرض و بدون نیاز به پیکربندی اضافه از zathura به عنوان نمایشگر پشتیبانی می‌کنند: .INDENT 0.0 .IP \(bu 2 LaTeXTools برای SublimeText (\%) .IP \(bu 2 LaTeX برای Atom (\%) .UNINDENT .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" .INDENT 0.0 .TP .B ZATHURA_PLUGINS_PATH مسیر دایرکتوری حاوی افزونه‌ها. این دایرکتوری تنها در صورتی در نظر گرفته می‌شود که دایرکتوری دیگری با استفاده از \-\-plugins\-dir مشخص نشده باشد. .UNINDENT .SH "سندباکس (SANDBOX)" .sp فایل باینری \fBzathura\-sandbox\fP برنامهٔ zathura را با یک سندباکس فعال مبتنی بر seccomp و/یا landlock اجرا می‌کند. برخی قابلیت‌ها هنگام استفاده از حالت سندباکس غیرفعال می‌شوند: .INDENT 0.0 .IP \(bu 2 ذخیره/نوشتن فایل‌ها .IP \(bu 2 استفاده از روش‌های ورودی مانند ibus .IP \(bu 2 چاپ .IP \(bu 2 نشانک‌ها و تاریخچه .IP \(bu 2 یکپارچه‌سازی با D\-Bus .IP \(bu 2 پشتیبانی از SyncTeX .UNINDENT .sp حالت سندباکس هنوز با برخی از پیاده‌سازی‌های libc آزمایشی است. در حال حاضر پیاده‌سازی پشتیبانی‌شده و آزمایش‌شدهٔ libc،‏ glibc است. .SH "باگ‌های شناخته‌شده (KNOWN BUGS)" .sp اگر GDK_NATIVE_WINDOWS فعال باشد، با اسناد حجیم دچار مشکل خواهید شد. در این حالت ممکن است zathura با خطا بسته شود یا صفحات به درستی رندر نشوند. غیرفعال کردن GDK_NATIVE_WINDOWS این مشکل را برطرف می‌کند. همین مشکل ممکن است در صورت فعال بودن overlay\-scrollbar در GTK_MODULES نیز رخ دهد..SH "همچنین ببینید (SEE ALSO)" .sp \fIzathurarc(5)\fP .SH "نویسندگان (AUTHORS)" pwmt.org .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2009-2026, pwmt.org .\" End of generated man page.