.TH MUPDF 1 "June 3, 2026"
.\" Please adjust this date whenever revising the manpage.
.\" no hyphenation
.nh
.\" adjust left
.ad l
.
.SH "نام (NAME)"
mupdf \- یک نمایشگر کم‌حجم PDF نوشته‌شده به زبان C پرتابل
.
.SH "خلاصه دستور (SYNOPSIS)"
.SY mupdf
.RI [ options ]
.I file
.RI [ page-number ]
.
.SH "توضیحات (DESCRIPTION)"
.B MuPDF
یک نمایشگر سند است که می‌تواند قالب‌های
.BR PDF ،
.BR XPS ،
.BR EPUB ،
.BR XHTML ،
.BR CBZ
و قالب‌های تصویری مختلفی مانند
.BR PNG ،
.BR JPEG ،
.BR GIF
و
.BR TIFF
را نمایش دهد.
.
.SH "گزینه‌ها (OPTIONS)"
توضیحات مربوط به هر یک از گزینه‌های پشتیبانی‌شده در زیر آمده است.
.
.TP
.BI \-b\~ box-name
استفاده از جعبه صفحه مشخص‌شده (MediaBox، CropBox، BleedBox، TrimBox یا ArtBox).
.TP
.BI \-c\~ profile-filename
تنظیم نمایه رنگی ICC نمایشگر بر اساس فایل مشخص‌شده.
.TP
.BI \-p\~ password
استفاده از گذرواژه ارائه‌شده برای باز کردن فایل رمزگذاری‌شده PDF.
گذرواژه هم به عنوان گذرواژه کاربر و هم گذرواژه مالک آزموده می‌شود.
.TP
.BI \-r\~ resolution
تغییر سطح بزرگ‌نمایی اولیه، مشخص‌شده بر حسب وضوح در واحد dpi.
مقدار پیش‌فرض 72 است.
.TP
.BI \-A\~ bits
تغییر کیفیت هموارسازی لبه‌ها (anti-aliasing)، مشخص‌شده با تعداد بیت بین 0
(خاموش) و 8 (بهترین کیفیت).
مقدار پیش‌فرض 8 است.
.TP
.BI \-B\~ RRGGBB
تنظیم ته‌رنگ سیاه تمام‌صفحه با استفاده از ساختار رنگی هگزادسیمال.
مقدار پیش‌فرض 303030 است.
.TP
.BI \-C\~ RRGGBB
تنظیم ته‌رنگ سفید تمام‌صفحه با استفاده از ساختار رنگی هگزادسیمال.
مقدار پیش‌فرض FFFFF0 است.
.TP
.BI \-H\~ height
ارتفاع صفحه بر حسب پوینت برای چیدمان EPUB.
.TP
.B \-I
معکوس کردن رنگ‌ها.
.TP
.B \-J
غیرفعال کردن جاوااسکریپت‌ها در فرم‌های PDF.
.TP
.BI \-R\~ extraction-options
فعال کردن بازآرایی متن (reflow) و تنظیم گزینه‌های استخراج متن.
.TP
.BI \-S\~ size
اندازه قلم بر حسب پوینت برای چیدمان EPUB.
.TP
.BI \-U\~ CSS-file
شیوه‌نامه کاربر برای چیدمان EPUB.
.TP
.BI \-W\~ width
عرض صفحه بر حسب پوینت برای چیدمان EPUB.
.TP
.B \-X
غیرفعال کردن شیوه‌های سند برای چیدمان EPUB.
.TP
.BI \-Y\~ factor
تنظیم ضریب مقیاس‌بندی رابط کاربری.
.
.SH "رفتار ماوس (MOUSE BEHAVIOR)"
.
.TP
.B کلیک با دکمه چپ ماوس
کلیک چپ روی یک فرابرچسب پیوند را دنبال می‌کند.
در حالت ارائه‌دهی به صفحه بعدی می‌رود.
.TP
.B کلیک با دکمه راست ماوس
در حالت ارائه‌دهی به صفحه قبلی بازمی‌گردد.
.TP
.B کشیدن با دکمه چپ ماوس
صفحه را جابه‌جا می‌کند (Pan).
جابه‌جایی فراتر از لبه‌های بالایی یا پایینی
به صفحه بعدی یا قبلی خواهد رفت.
.TP
.B کشیدن با دکمه راست ماوس
متن را در یک ناحیه انتخاب می‌کند.
در X11، متن انتخاب‌شده می‌تواند با کلیک وسط در برنامه‌ای دیگر جای‌گذاری شود.
کلیدهای
.B Ctrl+C
را برای رونوشت متن انتخاب‌شده در کلیپ‌بورد بفشارید.
در ویندوز، متن انتخاب‌شده به طور خودکار در کلیپ‌بورد
رونوشت می‌شود.
.TP
.B چرخ ماوس
صفحه را به بالا یا پایین جابه‌جا می‌کند.
با رسیدن به لبه بالایی یا پایینی، صفحه تغییر نمی‌کند.
.TP
.B Shift + چرخ ماوس
صفحه را به چپ یا راست جابه‌جا می‌کند.
.TP
.B Control + چرخ ماوس
بزرگ‌نمایی یا کوچک‌نمایی می‌کند.
.
.SH "کلیدهای میانبر (KEY BINDINGS)"
.SS "پیمایش صفحه (Page navigation)"
.TP
.B . pgdn space
رفتن به صفحه بعدی.
.TP
.B , pgup b
رفتن به صفحه قبلی.
.TP
.B 123g
رفتن به صفحه 123.
.TP
.BR g ,\~ G
رفتن به صفحه نخست یا پایانی.
.TP
.B m
نشانه‌گذاری صفحه فعلی برای بازگشت سریع.
تا 256 صفحه می‌توانند نشانه‌گذاری شوند.
.TP
.B t
رفتن به اندازه یک گام به عقب در تاریخچه نشانه‌ها.
.TP
.B T
رفتن به اندازه یک گام به جلو در تاریخچه نشانه‌ها.
.TP
.RI [ 0\(en9 ]\c
.B m
ذخیره شماره صفحه فعلی در ثبات شماره‌دار.
.TP
.RI [ 0\(en9 ]\c
.B t
رفتن به صفحه ذخیره‌شده در ثبات شماره‌دار.
.
.SS "بزرگ‌نمایی و چرخش (Zooming and rotating)"
.TP
.BR + ,\~ \-
بزرگ‌نمایی یا کوچک‌نمایی.
.TP
.BR W ,\~ H
بزرگ‌نمایی صفحه برای تطبیق دقیق با عرض/ارتفاع پنجره.
.TP
.B Z
بزرگ‌نمایی صفحه برای تطبیق با عرض یا ارتفاع پنجره.
.TP
.B z
بازنشانی سطح بزرگ‌نمایی.
.TP
.BR [ ,\~ ]
چرخش صفحه به چپ (پادساعت‌گرد) یا راست (ساعت‌گرد).
.TP
.B w
هم‌اندازه کردن پنجره برای تطبیق با صفحه (Shrinkwrap).
.TP
.B f
تغییر وضعیت حالت تمام‌صفحه.
.
.SS "جابه‌جایی (Panning)"
.TP
.BR h ,\~ left ,\~ j ,\~ k ,\~ l ,\~ right
جابه‌جایی صفحه به چپ، پایین، بالا یا راست.
.
.SS "جست‌وجو (Searching)"
.TP
.BR / ,\~ ?
جست‌وجوی متن رو به جلو یا رو به عقب.
.TP
.BR n ,\~ N
یافتن نتیجه جست‌وجوی بعدی/قبلی.
.
.SS "متفرقه (Miscellaneous)"
.TP
.B F1
نمایش راهنمای کلیدهای میانبر.
.TP
.B Escape
توقف جست‌وجو و/یا حذف تمرکز از یادداشت/ابزارک.
.TP
.BR < ,\~ >
افزایش/کاهش اندازه قلم EPUB/XHTML.
.TP
.B r
بارگذاری مجدد فایل.
.TP
.B p
تغییر وضعیت حالت ارائه‌دهی (تنها در mupdf-x11).
.TP
.B c
تغییر وضعیت رندر بین رنگی و مقیاس خاکستری (تنها در mupdf-x11).
.TP
.B C
تغییر وضعیت ته‌رنگ تمام‌صفحه.
.TP
.B I
تغییر وضعیت بین رندر رنگی عادی و معکوس.
.TP
.B E
تغییر وضعیت حالت رنگی ICC.
.TP
.B e
تغییر وضعیت حالت رنگ تفکیکی (spot color).
.TP
.B A
تنظیم بیت مورد استفاده برای هموارسازی لبه‌ها (anti-aliasing). مقدار پیش‌فرض 8 است.
0 به معنای عدم هموارسازی،
9 به معنای عدم هموارسازی با قاعده مرکز پیکسل،
10 به معنای عدم هموارسازی با قاعده هر بخشی از پیکسل.
.TP
.B P
نمایش شماره صفحه و تعداد کل صفحات.
.TP
.B i
نمایش کادر محاوره‌ای حاوی اطلاعات سند بازشده.
.TP
.B B
تغییر جعبه صفحه مورداستفاده (MediaBox، CropBox، BleedBox، TrimBox یا ArtBox).
جعبه صفحه فعال در کادر محاوره‌ای اطلاعات سند ذکر شده است.
.TP
.B o
نمایش/پنهان‌سازی پانل نمای کلی سند (outline).
.TP
.B a
نمایش/پنهان‌سازی پانل یادداشت‌ها (annotations).
.TP
.B R
نمایش/پنهان‌سازی پانل بازبینی و پوشاندن متن (redaction).
.TP
.B u
نمایش/پنهان‌سازی پانل واگرد/ازنو (undo/redo).
.TP
.B Y
نمایش/پنهان‌سازی فهرست لایه‌ها.
.TP
.B o
آغاز/پایان برجسته‌سازی پیوندها.
.TP
.B F
آغاز/پایان برجسته‌سازی ابزارک‌های فرم.
.TP
.BR ` ,\~ F12
نمایش کنسول JS.
.TP
.B S
ذخیره فایل سند به‌روزشده.
.TP
.B q
خروج.
.
.SH "سیگنال‌ها (SIGNALS)"
.
.TP
.B SIGHUP
ارسال سیگنال
.B SIGHUP
به فرایند mupdf سبب بارگذاری مجدد خودکار فایل در حال نمایش خواهد شد؛ برای نمونه جهت استفاده در اسکریپت‌های ساخت.
.
.SH "همچنین ببینید (SEE ALSO)"
.BR mutool (1).
.
.SH "نویسندگان (AUTHORS)"
حق نشر MuPDF متعلق به Artifex Software, Inc. در سال‌های 2006\(en2026 است.