.\" Copyright 1996-2025 Glyph & Cog, LLC .TH xpdf 1 "14 Nov 2025" .SH "نام (NAME)" xpdf \- نمایشگر فایل‌های قالب سند قابل‌حمل (PDF) (نسخهٔ 4.06) .SH "خلاصه دستور (SYNOPSIS)" .B xpdf [options] .RI [ PDF-file .RI [: page " | +" dest "]] ..." .PP .B xpdf [options] .B -remote .IR remote-name " [" command " ...]" .PP .B xpdf [options] .B -open .RI "[" PDF-file "]" .SH "توضیحات (DESCRIPTION)" برنامهٔ .B Xpdf یک نمایشگر برای فایل‌های «قالب سند قابل‌حمل» (PDF) است. (این فایل‌ها گاهی به‌خاطر نام نرم‌افزار PDF شرکت Adobe، فایل‌های «Acrobat» نیز نامیده می‌شوند.) .B Xpdf از جعبه‌ابزار گرافیکی Qt استفاده می‌کند و روی Unix، OS X و Windows اجرا می‌شود. .PP برای اجرای xpdf، دستور زیر را وارد کنید: .PP .RS xpdf file.pdf .RE .PP که در آن .I file.pdf فایل PDF شما است. نام فایل می‌تواند با یک شماره صفحه برای نمایش همراه باشد که با یک دونقطه (:) پیشوند می‌گیرد: .PP .RS xpdf file.pdf :18 .RE .PP یا با یک مقصد نام‌گذاری‌شده، همراه با پیشوند \'+' (این قابلیت تنها برای فایل‌های PDF دارای مقصدهای نام‌گذاری‌شده کاربرد دارد): .PP .RS xpdf file.pdf +destinationA .RE .PP اگر چند فایل را مشخص کنید، هر کدام در یک زبانهٔ جداگانه باز خواهند شد: .PP .RS xpdf file1.pdf file2.pdf :18 file3.pdf .RE .PP شما همچنین می‌توانید xpdf را بدون باز کردن هیچ فایلی اجرا کنید: .PP .RS xpdf .RE .SH "فایل پیکربندی (CONFIGURATION FILE)" برنامهٔ Xpdf هنگام راه‌اندازی یک فایل پیکربندی را می‌خواند. ابتدا تلاش می‌کند فایل پیکربندی اختصاصی کاربر، یعنی ~/.xpdfrc را بیابد. اگر آن فایل وجود نداشته باشد، به‌دنبال فایل پیکربندی سراسری سیستم می‌گردد که معمولاً /etc/xpdfrc است (البته این مسیر هنگام ساخت xpdf قابل تغییر است). برای جزئیات بیشتر به صفحهٔ راهنمای .BR xpdfrc (5) مراجعه کنید. .SH "گزینه‌ها (OPTIONS)" گزینه‌های خط فرمان زیر در دسترس هستند. تمام گزینه‌های خط فرمان باید پیش از هر فایل PDF که قرار است باز شود، قرار گیرند. .PP بسیاری از گزینه‌ها را می‌توان از طریق دستورهای فایل پیکربندی نیز تنظیم کرد. این موارد در کروشه‌ها همراه با توضیحات گزینهٔ خط فرمان مربوطه مشخص شده‌اند. .TP .BI \-geometry " geometry" تنظیم ابعاد و موقعیت اولیهٔ پنجره (geometry). .TP .BI \-title " title" تنظیم عنوان پنجره. به‌طور پیش‌فرض، عنوان "xpdf: foo.pdf" خواهد بود. .TP .BI \-open " \fR[\fPPDF-file\fR]\fP" این گزینه یک کارساز راه دور پیش‌فرض برپا می‌کند. اگر Xpdf از قبل در حال اجرا باشد (با سوئیچ "-open")، فایل PDF (در صورت مشخص شدن) در یک زبانهٔ جدید باز می‌شود. اگر Xpdf (با سوئیچ "-open") در حال اجرا نباشد، Xpdf را راه‌اندازی کرده و فایل PDF (در صورت وجود) را باز می‌کند. این قابلیت برای محیط‌های گرافیکی دسکتاپ (مانند سناریوی متداول دوبار کلیک روی یک فایل PDF) مفید است. .TP .B \-rv تنظیم حالت تصویر معکوس (reverse video). این حالت رنگ همه چیز را به جز تصاویر معکوس می‌کند. ممکن است برای فایل‌های PDF که استفادهٔ غیرمعمولی از رنگ‌ها دارند نتیجهٔ مطلوبی نداشته باشد. این گزینه همچنین باعث می‌شود رنگ پیش‌فرض کاغذ به سیاه تغییر یابد. .TP .BI \-papercolor " color" تنظیم «رنگ کاغذ»، یعنی پس‌زمینهٔ نمایش صفحه. رنگ می‌تواند به‌صورت #RRGGBB (مبنای ۱۶) یا نام یک رنگ باشد. این گزینه با فایل‌های PDF که رفتارهایی مانند پر کردن رنگ سفید در پشت متن انجام می‌دهند به‌خوبی کار نخواهد کرد. .RB "[فایل پیکربندی: " paperColor ] .TP .BI \-mattecolor " color" تنظیم رنگ حاشیه (matte)، یعنی رنگی که برای پس‌زمینهٔ خارج از محدودهٔ واقعی صفحه استفاده می‌شود. رنگ می‌تواند به‌صورت #RRGGBB (مبنای ۱۶) یا نام یک رنگ باشد. .RB "[فایل پیکربندی: " matteColor ] .TP .BI \-fsmattecolor " color" تنظیم رنگ حاشیه برای حالت تمام‌صفحه. رنگ می‌تواند به‌صورت #RRGGBB (مبنای ۱۶) یا نام یک رنگ باشد. .RB "[فایل پیکربندی: " fullScreenMatteColor ] .TP .BI \-z " zoom" تنظیم ضریب بزرگ‌نمایی اولیه. یک عدد بیانگر درصد بزرگ‌نمایی است، که در آن 100 به معنای 72 dpi است. همچنین می‌توانید از \'page\' برای جا دادن صفحه در اندازهٔ پنجره، یا \'width\' برای منطبق کردن عرض صفحه با عرض پنجره استفاده کنید. .RB "[فایل پیکربندی: " initialZoom ] .TP .BI \-rot " angle" چرخش صفحه‌ها به میزان 0 (پیش‌فرض)، 90، 180 یا 270 درجه. .TP .BI \-aa " yes | no" فعال یا غیرفعال کردن صاف‌سازی لبهٔ قلم (anti-aliasing). مقدار پیش‌فرض "yes" است. .RB "[فایل پیکربندی: " antialias ] .TP .BI \-aaVector " yes | no" فعال یا غیرفعال کردن صاف‌سازی برداری (vector anti-aliasing). مقدار پیش‌فرض "yes" است. .RB "[فایل پیکربندی: " vectorAntialias ] .TP .BI \-enc " encoding-name" تنظیم کدگذاری مورد استفاده برای خروجی متن. مقدار .I encoding\-name باید با دستور unicodeMap تعریف شده باشد (به .BR xpdfrc (5) مراجعه کنید). مقدار پیش‌فرض "Latin1" است (که یک کدگذاری داخلی محسوب می‌شود). .RB "[فایل پیکربندی: " textEncoding ] .TP .BI \-pw " password" تعیین گذرواژه برای فایل PDF. این می‌تواند گذرواژهٔ مالک (که تمام محدودیت‌های امنیتی را دور می‌زند) یا گذرواژهٔ کاربر باشد. .TP .B \-fullscreen باز کردن xpdf در حالت تمام‌صفحه، مناسب برای ارائه مطالب. .TP .BI \-remote " remote-name" اجرای Xpdf در حالت کارساز راه دور (remote server). بخش REMOTE SERVER MODE را ببینید. .TP .BI \-display " display" تنظیم نمایشگر X (تنها در X11 در دسترس است). .TP .B \-cmd چاپ دستورها هنگام اجرا شدن آن‌ها (کاربردی برای اشکال‌زدایی). .RB "[فایل پیکربندی: " printCommands ] .TP .BI \-tabstate " tabstate-file" تنظیم فایل مورد استفاده توسط دستورهای loadTabState و saveTabState. .RB "[فایل پیکربندی: " tabStateFile ] .TP .BI \-cfg " config-file" خواندن .I config-file به جای ~/.xpdfrc یا فایل پیکربندی سراسری سیستم. .TP .B \-v چاپ اطلاعات نسخه و حق نشر. .TP .B \-h چاپ اطلاعات نحوهٔ استفاده. .RB ( \-help و .B \-\-help معادل هستند.) .PP.SH "کنترل‌ها (CONTROLS)" .SS "نوار ابزار (Toolbar)" .TP .B "دکمه تغییر وضعیت نوار کناری (toggle sidebar button)" وضعیت نوار کناری را تغییر می‌دهد (یعنی آن را نمایش داده یا پنهان می‌کند). .TP .B "نشانگر وضعیت (status indicator)" این آیکون در زمان رندر کردن صفحه توسط Xpdf متحرک است. در صورت صدور خطا یا هشدار، به رنگ قرمز تغییر می‌یابد. کلیک کردن روی آن، پنجرهٔ گفتگوی خطا را باز می‌کند. .TP .B "حالت انتخاب (selection mode)" این آیکون در حالت انتخاب خطی به شکل نماد مکان‌نما (\(lqI-beam\(rq) و در حالت انتخاب بلوکی به شکل یک پیکان است. کلیک کردن روی آن، حالت انتخاب را بین این دو جابه‌جا می‌کند. .TP .B "جعبه ورودی شماره صفحه (page number entry box)" رفتن به یک شماره صفحهٔ مشخص. برای فعال‌سازی درون جعبه کلیک کنید، شماره صفحه را تایپ کرده و سپس کلید return را بزنید. اگر گزینهٔ منوی \(lqview - page labels\(rq علامت خورده باشد، به جای آن برچسب‌های صفحه نمایش داده شده و پذیرفته می‌شوند. .TP .B "دکمه‌های پیکان چپ/راست (left/right arrow buttons)" حرکت به عقب یا جلو در طول مسیر تاریخچه. .TP .B "دکمه‌های کوچک‌نمایی/بزرگ‌نمایی (zoom out/in buttons)" بزرگ‌نمایی یا کوچک‌نمایی تدریجی (یعنی تغییر میزان بزرگ‌نمایی به‌صورت گام‌به‌گام). .TP .B "منوی بازشوی بزرگ‌نمایی (zoom popup menu)" تغییر ضریب بزرگ‌نمایی (توضیحات گزینهٔ \-z در بالا را ببینید). .TP .B "دکمه برازش با عرض (fit width button)" تغییر ضریب بزرگ‌نمایی برای هماهنگ کردن عرض صفحه با عرض پنجره. .TP .B "دکمه برازش با صفحه (fit page button)" تغییر ضریب بزرگ‌نمایی برای هماهنگ کردن اندازه صفحه با اندازه پنجره. .TP .B "جعبه ورودی جستجو (find entry box)" یافتن یک رشته متنی. برای فعال‌سازی درون جعبه کلیک کنید، رشتهٔ مورد نظر برای جستجو را تایپ کرده و سپس کلید return را بزنید. .TP .B "دکمه جستجوی بعدی (find next button)" یافتن مورد بعدی از رشته جستجو. .TP .B "دکمه جستجوی قبلی (find previous button)" یافتن مورد قبلی از رشته جستجو. .TP .B "دکمه تنظیمات جستجو (find settings button)" نمایش تنظیمات فعلی جستجو: غیرحساس به بزرگی و کوچکی حروف (case insensitive)، حساس به بزرگی و کوچکی حروف (case sensitive)، حالت هوشمند (smart case: حساس به بزرگی و کوچکی فقط در صورتی که رشته جستجو شامل حروف بزرگ باشد)، و یافتن کل کلمات (find whole words). .PP .SS "نوار منو (Menu bar)" نوار منو بالای نوار ابزار قرار دارد. گزینه‌های منو واضح و بی‌نیاز از توضیح هستند. .PP .SS "فهرست زبانه‌ها (Tab list)" فهرست زبانه‌ها در سمت چپ، درست در زیر نوار ابزار قرار دارد. این بخش تمام زبانه‌های باز را فهرست می‌کند. .PP .SS "قاب طرح کلی/لایه‌ها/پیوست‌ها (Outline/layers/attachments pane)" این قاب در سمت چپ و در زیر فهرست زبانه‌ها قرار دارد. منوی بازشو به شما امکان می‌دهد از میان طرح کلی (outline)، لایه‌ها (layers) یا پیوست‌ها (attachments) انتخاب کنید. .PP طرح کلی (outline) یک ساختار درخت‌مانند از نشانک‌ها (bookmarks) است که امکان حرکت در فایل PDF را فراهم می‌سازد. همهٔ فایل‌های PDF دارای طرح کلی نیستند. .PP لایه‌ها (که با نام محتوای اختیاری یا optional content نیز شناخته می‌شوند) امکان نمایش یا پنهان‌سازی بخش‌هایی از محتوای PDF را فراهم می‌کنند. همهٔ فایل‌های PDF دارای لایه نیستند. .PP پیوست‌ها (attachments) فایل‌های دیگری هستند که درون فایل PDF جاسازی شده‌اند. برای هر فایل پیوست‌شده یک دکمهٔ \(aqsave\(aq (ذخیره) وجود دارد. همهٔ فایل‌های PDF دارای پیوست نیستند. .PP .SS "انتخاب متن (Text selection)" در حالت انتخاب بلوکی، کشیدن ماوس در حالی که دکمهٔ چپ آن فشرده نگه داشته شده است، یک مستطیل دلخواه را برجسته (highlight) می‌کند. کلیک همراه با کلید Shift، ناحیهٔ انتخاب‌شده را گسترش می‌دهد. .PP در حالت انتخاب خطی، کشیدن با دکمهٔ چپ ماوس، متن را به ترتیب خواندن برجسته می‌کند. دو بار کلیک کردن یا سه بار کلیک کردن به ترتیب یک کلمه یا یک خط را انتخاب می‌کند. کلیک همراه با کلید Shift، ناحیهٔ انتخاب‌شده را گسترش می‌دهد. .PP متن انتخاب‌شده را می‌توان در کلیپ‌بورد کپی کرد (با استفاده از گزینهٔ منوی edit/copy). در X11، متن انتخاب‌شده در بافر انتخاب X (موسوم به X selection buffer) در دسترس خواهد بود. .PP.SS پیوندها (Links) هنگامی که موشواره روی یک پیوند (hyperlink) قرار می‌گیرد، مقصد پیوند در پنجره‌ای بازشو (popup) نزدیک پایین پنجره نمایش داده می‌شود. .PP کلیک کردن روی یک پیوند به مقصد آن پیوند پرش می‌کند. پیوند به یک سند PDF دیگر باعث می‌شود xpdf آن سند را بارگذاری کند. یک پیوند \'launch\' به یک برنامه اجرایی یک کادر محاوره‌ای نمایش می‌دهد و اگر روی \'ok\' کلیک کنید، برنامه را اجرا می‌کند. پیوندهای URL به شیوه‌ای وابسته به سیستم باز می‌شوند. (در UNIX، کیوت Qt از متغیر محیطی $BROWSER استفاده می‌کند.) .PP .SS کلیدهای موشواره (Mouse bindings) دکمه چپ موشواره برای انتخاب متن استفاده می‌شود (بالا را ببینید). .PP کلیک کردن روی یک پیوند با دکمه میانی، پیوند را در یک برگه (tab) جدید باز می‌کند. .PP کشیدن موشواره در حالی که دکمه میانی پایین نگه داشته شده است، نمای پنجره را جابه‌جا می‌کند (pan). .PP دکمه راست موشواره یک منوی بازشو را باز می‌کند (ببینید: .BR popupMenuCmd " در " xpdfrc (5)). .PP .SS کلیدهای میان‌بر (Key bindings) این بخش فهرست کلیدهای میان‌بر پیش‌فرض را نشان می‌دهد. میان‌برها را می‌توان با استفاده از فایل پیکربندی تغییر داد (ببینید: .BR xpdfrc (5)). .TP .B control-o باز کردن یک فایل PDF جدید از طریق پنجره انتخاب فایل. .TP .B control-r بارگذاری مجدد فایل PDF کنونی. توجه داشته باشید که Xpdf در صورتی که فایل از زمان آخرین بارگذاری تغییر کرده باشد، آن را به طور خودکار (هنگام تغییر صفحه یا رسم مجدد) دوباره بارگذاری خواهد کرد. .TP .B control-f جستجوی یک رشته متنی. این کار تمرکز صفحه‌کلید را روی جعبه \'find\' قرار می‌دهد. .TP .B control-G یافتن مورد بعدی. .TP .B control-C کپی کردن متن انتخاب‌شده در کلیپ‌بورد. .TP .B control-P چاپ. .TP .BR control-0 " (control-zero)" تنظیم ضریب بزرگ‌نمایی روی ۱۲۵٪. .TP .BR control-+ " (control-plus)" بزرگ‌نمایی (افزایش ضریب بزرگ‌نمایی به اندازه ۱ واحد). .TP .BR control-- " (control-minus)" کوچک‌نمایی (کاهش ضریب بزرگ‌نمایی به اندازه ۱ واحد). .TP .B control-s ذخیره PDF از طریق پنجره انتخاب فایل. .TP .B control-t باز کردن یک برگه جدید. .TP .B control-n باز کردن یک پنجره جدید. .TP .B control-w بستن برگه کنونی. اگر این آخرین برگه باز باشد، پنجره را می‌بندد. اگر این آخرین پنجره باز باشد، از برنامه خارج می‌شود. .TP .B control-l تغییر حالت بین حالت تمام‌صفحه و پنجره‌ای. .TP .B control-q خروج. .TP .B control- برگه بعدی. .TP .B control-shift- برگه قبلی. .TP .B control-? راهنما. .TP .B alt- بازگشت به عقب در مسیر تاریخچه. .TP .B alt- رفتن به جلو در مسیر تاریخچه. .TP .B home رفتن به بالا-چپ صفحه کنونی. .TP .B control- رفتن به صفحه نخست. .TP .B end رفتن به پایین-راست صفحه کنونی. .TP .B control- رفتن به صفحه آخر. .TP .BR " یا " پیمایش به پایین در صفحه کنونی؛ اگر در انتهای صفحه باشد، رفتن به صفحه بعدی. .TP .BR control- " یا " control- رفتن به صفحه بعدی. اگر فعال باشد، این کار موقعیت نسبی در صفحه را حفظ می‌کند. .TP .B پیمایش به بالا در صفحه کنونی؛ اگر در ابتدای صفحه باشد، رفتن به صفحه قبلی. .TP .BR control- " یا " control- رفتن به صفحه قبلی. اگر فعال باشد، این کار موقعیت نسبی در صفحه را حفظ می‌کند. .TP .B خروج از حالت تمام‌صفحه. .TP .B arrows پیمایش در صفحه کنونی. .TP .B g قرار دادن تمرکز صفحه‌کلید روی جعبه ورودی شماره صفحه. .TP .B z تنظیم ضریب بزرگ‌نمایی روی \'page\' (هم‌اندازه کردن صفحه با پنجره). .TP .B w تنظیم ضریب بزرگ‌نمایی روی \'width\' (هم‌اندازه کردن عرض صفحه با پنجره)..SH "حالت تمام‌صفحه (Full-screen mode)" برنامه Xpdf می‌تواند از طریق گزینه خط فرمان .B \-fullscreen ، مورد منوی \'full screen\'، یا با انتساب به دستور .B fullScreenMode یا .B toggleFullScreenMode به حالت تمام‌صفحه برود. .PP ورود به حالت تمام‌صفحه به‌طور خودکار حالت نمایش را به تک‌صفحه‌ای و بزرگ‌نمایی را به برازش صفحه (fit-page) تغییر می‌دهد. .PP خروج از حالت تمام‌صفحه از طریق کلید پیش‌فرض یا با انتساب به دستور .B windowMode یا دستور .B toggleFullScreenMode امکان‌پذیر است. .SH "دستورها (COMMANDS)" انتساب‌های کلید و ماوس در Xpdf توسط کاربر و با استفاده از دستورهای bind و unbind در فایل پیکربندی قابل تنظیم هستند (ببینید: .BR xpdfrc (5)). دستور bind به شما امکان می‌دهد یک کلید یا دکمه ماوس را به توالی‌ای از یک یا چند دستور متصل کنید. .PP در دستورهایی که آرگومان می‌پذیرند (درون پرانتزها)، نویسه‌های خاص (به‌ویژه \(aq(\(aq، \(aq)\(aq، \(aq,\(aq و \(aq\ex01\(aq) را می‌توان با قرار دادن یک نویسه \(aq\ex01\(aq پیش از آن‌ها گریزدهی کرد. این قابلیت بیشتر در مواردی مانند اسکریپت‌هایی کاربرد دارد که باید بتوانند با استفاده از دستور \'openFile\' فایل‌های PDF دلخواه را باز کنند. .PP دستورهای زیر پشتیبانی می‌شوند: .TP .B about باز کردن کادر گفتگوی \'about\'. .TP .B blockSelectMode تنظیم حالت انتخاب بلوکی. در این حالت، انتخاب به‌صورت یک مستطیل ساده است. هر بخشی از صفحه، صرف‌نظر از محتوای روی صفحه، می‌تواند انتخاب شود. .TP .BI checkOpenFile( file ) بررسی اینکه آیا .I file در زبانه جاری باز است یا خیر، و باز کردن آن در غیر این صورت. .TP .BI checkOpenFileAtDest( file, dest ) بررسی اینکه آیا .I file در زبانه جاری باز است یا خیر، و باز کردن آن در غیر این صورت. در هر دو حالت، رفتن به مقصد نام‌گذاری‌شده مشخص‌شده. .TP .BI checkOpenFileAtPage( file, page ) بررسی اینکه آیا .I file در زبانه جاری باز است یا خیر، و باز کردن آن در غیر این صورت. در هر دو حالت، رفتن به صفحه مشخص‌شده. .TP .B closeSidebar بستن نوار کناری. .TP .B closeSidebarMoveResizeWin بستن نوار کناری، تغییر اندازه پنجره به‌گونه‌ای که اندازه سند تغییر نکند، و جابه‌جایی پنجره تا سند در همان نقطه از صفحه نمایش باقی بماند. .TP .B closeSidebarResizeWin بستن نوار کناری، همراه با تغییر اندازه پنجره به‌گونه‌ای که اندازه سند تغییر نکند. .TP .B closeTabOrQuit بستن زبانه. اگر این آخرین زبانه باز باشد، پنجره بسته می‌شود. اگر این آخرین پنجره باز باشد، از برنامه خارج می‌شود. .TP .B closeWindowOrQuit بستن پنجره. اگر این آخرین پنجره باز باشد، از برنامه خارج می‌شود. .TP .B continuousMode تغییر به حالت نمایش پیوسته. .TP .B copy رونوشت متن انتخاب‌شده به کلیپ‌بورد. .TP .B copyLinkTarget رونوشت مقصد پیوندِ زیر نشانگر ماوس به کلیپ‌بورد. .TP .B endPan پایان دادن به عملیات پیمایش صفحه (pan). .TP .B endSelection پایان دادن به انتخاب. .TP .BI expandSidebar( n ) گسترش نوار کناری به میزان .I n پیکسل. در صورتی که نوار کناری بسته باشد، آن را باز می‌کند. .TP .B find قرار دادن تمرکز صفحه‌کلید روی جعبه متن \'find\'. .TP .B findFirst یافتن اولین رخداد رشته جستجو. .TP .B findNext یافتن رخداد بعدی رشته جستجو. .TP .B findPrevious یافتن رخداد قبلی رشته جستجو. .TP .B focusToDocWin قرار دادن تمرکز صفحه‌کلید روی پنجره اصلی سند. .TP .B focusToPageNum قرار دادن تمرکز صفحه‌کلید روی جعبه متن شماره صفحه. .TP .B followLink دنبال کردن یک پیوند (اگر ماوس روی پیوندی نباشد، کاری انجام نمی‌دهد). .TP .B followLinkInNewTab دنبال کردن پیوند و باز کردن فایل‌های PDF در یک زبانه جدید (اگر ماوس روی پیوندی نباشد، کاری انجام نمی‌دهد). برای پیوندها به فایل‌های غیر PDF، این دستور هم‌ارز با followLink است. .TP .B followLinkInNewTabNoSel مشابه با followLinkInNewTab، اما در صورتی که انتخابی غیرخالی وجود داشته باشد، کاری انجام نمی‌دهد. (این ویژگی برای انتساب به دکمه‌های ماوس کاربردی است.) .TP .B followLinkInNewWin دنبال کردن پیوند و باز کردن فایل‌های PDF در یک پنجره جدید (اگر ماوس روی پیوندی نباشد، کاری انجام نمی‌دهد). برای پیوندها به فایل‌های غیر PDF، این دستور هم‌ارز با followLink است. .TP .B followLinkInNewWinNoSel مشابه با followLinkInNewWin، اما در صورتی که انتخابی غیرخالی وجود داشته باشد، کاری انجام نمی‌دهد. (این ویژگی برای انتساب به دکمه‌های ماوس کاربردی است.) .TP .B followLinkNoSel مشابه با followLink، اما در صورتی که انتخابی غیرخالی وجود داشته باشد، کاری انجام نمی‌دهد. (این ویژگی برای انتساب به دکمه‌های ماوس کاربردی است.) .TP .B fullScreenMode رفتن به حالت تمام‌صفحه. .TP .B goBackward حرکت به عقب در مسیر تاریخچه. .TP .B goForward حرکت به جلو در مسیر تاریخچه. .TP .BI gotoDest( dest ) رفتن به یک مقصد نام‌گذاری‌شده. .TP .B gotoLastPage رفتن به آخرین صفحه در فایل PDF. .TP .BI gotoPage( page ) رفتن به صفحه مشخص‌شده. .TP .BI help باز کردن نشانی اینترنتی (URL) راهنما. .TP .B hideMenuBar پنهان کردن نوار منو. .TP .B hideToolbar پنهان کردن نوار ابزار. .TP .B horizontalContinuousMode تغییر به حالت نمایش پیوسته افقی. .TP .B linearSelectMode تنظیم حالت انتخاب خطی. در این حالت، انتخاب از متن پیروی می‌کند. نواحی غیرمتنی قابل انتخاب نیستند. .TP .B loadSession بارگذاری نشست از فایل ذخیره نشست. مسیر فایل نشست با تنظیم sessionFile مشخص می‌شود (ببینید: .BR xpdfrc (5)). .TP .BI loadTabState بارگذاری فایل وضعیت زبانه‌ها (که از طریق دستور saveTabState ذخیره شده است) و بازیابی زبانه‌های فهرست‌شده در آن فایل. مسیر فایل وضعیت زبانه‌ها با تنظیم tabStateFile مشخص می‌شود (ببینید: .BR xpdfrc (5))..TP .B newTab باز کردن یک برگهٔ جدید خالی. .TP .B newWindow باز کردن یک پنجرهٔ جدید خالی. .TP .B nextPage رفتن به صفحهٔ بعدی. .TP .B nextPageNoScroll رفتن به صفحهٔ بعدی، با حفظ موقعیت نسبی پیمایش فعلی. .TP .B nextTab جابه‌جایی به برگهٔ بعدی. .TP .B normalVideoMode تغییر به حالت ویدئویی عادی (نقطهٔ مقابل حالت ویدئویی معکوس). .TP .B open باز کردن یک فایل PDF در برگهٔ فعلی، با استفاده از کادر محاوره‌ای باز کردن. .TP .B openErrorWindow باز کردن پنجرهٔ خطا. .TP .BI openFile( file ) باز کردن فایل مشخص‌شده در برگهٔ فعلی. .TP .BI openFile2( file, page, dest, passwd, location ) باز کردن فایل مشخص‌شده. اگر .I dest خالی نباشد، به مقصد نام‌گذاری‌شدهٔ مشخص می‌رود. در غیر این صورت، اگر .I page خالی نباشد، به شماره صفحهٔ مشخص‌شده می‌رود. اگر .I password خالی نباشد، به عنوان گذرواژهٔ PDF استفاده می‌شود. اگر .I location برابر "win" باشد، فایل در یک پنجرهٔ جدید باز می‌شود؛ اگر "tab" باشد، در یک برگهٔ جدید باز می‌شود؛ اگر "check" باشد، در برگهٔ فعلی باز می‌شود، اما تنها در صورتی که فایل PDF مشخص‌شده از قبل باز نشده باشد؛ در غیر این صورت در برگهٔ فعلی باز می‌شود. هر یک یا تمام آرگومان‌ها، به‌جز .IR file ، می‌توانند رشته‌های خالی باشند. برای نمونه: .nf openFile2(test.pdf,7,,,tab) .fi .TP .BI openFileAtDest( file, dest ) باز کردن فایل مشخص‌شده در برگهٔ فعلی، در مقصد نام‌گذاری‌شدهٔ مشخص. .TP .BI openFileAtDestIn( file, dest, location ) باز کردن فایل مشخص‌شده در مقصد نام‌گذاری‌شدهٔ مشخص. آرگومان location باید برای یک پنجرهٔ جدید "win" یا برای یک برگهٔ جدید "tab" باشد. .TP .BI openFileAtPage( file, page ) باز کردن فایل مشخص‌شده در برگهٔ فعلی، در صفحهٔ مشخص‌شده. .TP .BI openFileAtPageIn( file, page, location ) باز کردن فایل مشخص‌شده در صفحهٔ مشخص‌شده. آرگومان location باید برای یک پنجرهٔ جدید "win" یا برای یک برگهٔ جدید "tab" باشد. .TP .BI openFileIn( file, location ) باز کردن فایل مشخص‌شده. آرگومان location باید برای یک پنجرهٔ جدید "win" یا برای یک برگهٔ جدید "tab" باشد. .TP .BI openIn( location ) باز کردن یک فایل PDF با استفاده از کادر محاوره‌ای باز کردن. آرگومان location باید برای یک پنجرهٔ جدید "win" یا برای یک برگهٔ جدید "tab" باشد. .TP .B openSidebar باز کردن نوار کناری. .TP .B openSidebarMoveResizeWin باز کردن نوار کناری، تغییر اندازهٔ پنجره به‌گونه‌ای که اندازهٔ سند تغییر نکند، و جابه‌جا کردن پنجره به‌طوری که سند در همان مکان صفحه نمایش باقی بماند. .TP .B openSidebarResizeWin باز کردن نوار کناری، با تغییر اندازهٔ پنجره به‌گونه‌ای که اندازهٔ سند تغییر نکند. .TP .B pageDown پیمایش به پایین به اندازهٔ یک صفحه نمایش. .TP .B pageUp پیمایش به بالا به اندازهٔ یک صفحه نمایش. .TP .B postPopupMenu نمایش منوی پاپ‌آپ (popup). .TP .B prevPage رفتن به صفحهٔ قبلی. .TP .B prevPageNoScroll رفتن به صفحهٔ قبلی، با حفظ موقعیت نسبی پیمایش فعلی. .TP .B prevTab جابه‌جایی به برگهٔ قبلی. .TP .B print باز کردن کادر محاوره‌ای \'print\'. .TP .B quit خروج از xpdf. .TP .B raise آوردن پنجرهٔ xpdf به جلو. .TP .B reload بارگذاری مجدد فایل PDF فعلی. .TP .B reverseVideoMode تغییر به حالت ویدئویی معکوس. .TP .B rotateCCW چرخاندن صفحه ۹۰ درجه در خلاف جهت عقربه‌های ساعت. .TP .B rotateCW چرخاندن صفحه ۹۰ درجه در جهت عقربه‌های ساعت. .TP .BI run( external-command-string ) اجرای یک دستور خارجی. کاراکترهای گریز (escape) زیر در رشتهٔ دستور مجاز هستند: .nf %f => نام فایل PDF (یا یک رشتهٔ خالی اگر هیچ فایلی باز نباشد) %b => نام پایهٔ فایل PDF، یعنی نام فایل منهای پسوند (یا یک رشتهٔ خالی اگر هیچ فایلی باز نباشد) %u => نشانی URL پیوند (یا یک رشتهٔ خالی اگر روی پیوند قرار نداشته باشد) %p => شماره صفحهٔ فعلی (یا یک رشتهٔ خالی اگر هیچ فایلی باز نباشد) %x => مختصات x گوشهٔ بالا-چپ ناحیهٔ انتخابی (یا 0 در صورت نبود انتخاب) %y => مختصات y گوشهٔ بالا-چپ ناحیهٔ انتخابی (یا 0 در صورت نبود انتخاب) %X => مختصات x گوشهٔ پایین-راست ناحیهٔ انتخابی (یا 0 در صورت نبود انتخاب) %Y => مختصات y گوشهٔ پایین-راست ناحیهٔ انتخابی (یا 0 در صورت نبود انتخاب) %t => متن انتخاب‌شده (محدود به ۵۰۰ نویسه) %i => صفحهٔ حاوی اشاره‌گر ماوس %j => مختصات x اشاره‌گر ماوس %k => مختصات y اشاره‌گر ماوس %% => % .fi رشتهٔ دستور خارجی اغلب حاوی فاصله خواهد بود، بنابراین کل دستور باید در فایل xpdfrc درون گیومه قرار گیرد: .nf bind x "run(ls -l)" .fi رشتهٔ دستور ممکن است از طریق پوسته اجرا نشود. توصیه می‌شود که دستور ساده نگه داشته شود تا وابسته به قابلیت‌های خاص پوسته نباشد. برای موارد پیچیده، می‌توانید ترتیبی دهید که رشتهٔ دستور یک اسکریپت پوسته را اجرا کند. .TP .B saveAs ذخیرهٔ PDF از طریق پنجرهٔ انتخاب فایل. .TP .B saveImage باز کردن کادر محاوره‌ای \'save image\'. .TP .B saveSession ذخیرهٔ نشست فعلی، شامل تمامی پنجره‌ها و برگه‌های باز، در فایل ذخیرهٔ نشست. این فایل را می‌توان بعداً با دستور loadSession بارگذاری کرد. مسیر فایل نشست با تنظیم sessionFile مشخص می‌شود (ببینید: .BR xpdfrc (5)). .TP .BI saveTabState ذخیرهٔ فهرستی از تمام برگه‌های باز در این پنجره در فایل وضعیت برگه. برای هر برگه، این دستور نام فایل PDF و شماره صفحه را (در خطوط جداگانه) می‌نویسد. این فایل را می‌توان بعداً با دستور loadTabState بارگذاری کرد. مسیر فایل وضعیت برگه با تنظیم tabStateFile مشخص می‌شود (ببینید: .BR xpdfrc (5))..TP .BI scrollDown( n ) پیمایش به پایین به اندازه .I n پیکسل. .TP .BI scrollDownNextPage( n ) پیمایش به پایین به اندازه .I n پیکسل، و در صورت نیاز انتقال به صفحه بعدی. .TP .BI scrollLeft( n ) پیمایش به چپ به اندازه .I n پیکسل. .TP .BI scrollOutlineDown( n ) پیمایش طرح کلی سند به پایین به اندازه .I n گام. .TP .BI scrollOutlineUp( n ) پیمایش طرح کلی سند به بالا به اندازه .I n گام. .TP .BI scrollRight( n ) پیمایش به راست به اندازه .I n پیکسل. .TP .B scrollToBottomEdge پیمایش به لبه پایینی آخرین صفحه نمایش داده‌شده، بدون حرکت افقی. .TP .B scrollToBottomRight پیمایش به گوشه پایین-راست آخرین صفحه نمایش داده‌شده. .TP .B scrollToLeftEdge پیمایش به لبه چپ صفحه فعلی، بدون حرکت عمودی. .TP .B scrollToRightEdge پیمایش به لبه راست صفحه فعلی، بدون حرکت عمودی. .TP .B scrollToTopEdge پیمایش به لبه بالایی اولین صفحه نمایش داده‌شده، بدون حرکت افقی. .TP .B scrollToTopLeft پیمایش به گوشه بالا-چپ اولین صفحه نمایش داده‌شده. .TP .BI scrollUp( n ) پیمایش به بالا به اندازه .I n پیکسل. .TP .BI scrollUpPrevPage( n ) پیمایش به بالا به اندازه .I n پیکسل، و در صورت نیاز انتقال به صفحه قبلی. .TP .B selectLine انتخاب سطر واقع در موقعیت فعلی موشواره. .TP .B selectWord انتخاب کلمه واقع در موقعیت فعلی موشواره. .TP .BI setSelection( pg , ulx , uly , lrx , lry ) تنظیم محدوده انتخاب روی مختصات مشخص‌شده در صفحه تعیین‌شده. .TP .B showAttachmentsPane نمایش پیوست‌ها در قاب طرح‌کلی/لایه‌ها/پیوست‌ها. .TP .B showDocumentInfo باز کردن پنجره محاوره‌ای اطلاعات سند. .TP .B showKeyBindings باز کردن پنجره محاوره‌ای کلیدهای میانبر. .TP .B showLayersPane نمایش لایه‌ها در قاب طرح‌کلی/لایه‌ها/پیوست‌ها. .TP .B showMenuBar نمایش نوار منو. .TP .B showOutlinePane نمایش طرح کلی در قاب طرح‌کلی/لایه‌ها/پیوست‌ها. .TP .B showToolbar نمایش نوار ابزار. .TP .BI shrinkSidebar( n ) کوچک کردن نوار کناری به اندازه .I n پیکسل. در صورتی که با این کار اندازه از حداقل مجاز کمتر شود، نوار کناری بسته خواهد شد. .TP .B sideBySideContinuousMode تغییر حالت به نمای پیوسته دوصفحه‌ای (کنار هم). .TP .B sideBySideSingleMode تغییر حالت به نمای دوصفحه‌ای (کنار هم). .TP .B singlePageMode تغییر حالت به نمای تک‌صفحه‌ای. .TP .B startExtendedSelection گسترش انتخاب تا موقعیت فعلی موشواره، و ادامه دادن گسترش همگام با حرکت موشواره. .TP .B startPan شروع عملیات جابجایی صفحه (pan) در موقعیت فعلی موشواره، که همگام با حرکت موشواره سند را پیمایش می‌کند. .TP .B startSelection شروع یک انتخاب در موقعیت فعلی موشواره، که همگام با حرکت موشواره گسترش می‌یابد. .TP .B toggleContinuousMode تغییر وضعیت بین حالت نمایشی پیوسته و تک‌صفحه‌ای. .TP .B toggleFullScreenMode تغییر وضعیت بین حالت تمام‌صفحه و پنجره‌ای. .TP .B toggleMenuBar تغییر وضعیت نوار منو بین حالت آشکار و پنهان. .TP .B toggleReverseVideoMode تغییر وضعیت بین حالت تصویر معکوس (نگاتیو) و عادی. .TP .B toggleSelectMode تغییر وضعیت بین حالت انتخاب بلوکی و خطی. .TP .B toggleSidebar تغییر وضعیت نوار کناری بین باز و بسته. .TP .B toggleSidebarMoveResizeWin تغییر وضعیت نوار کناری بین باز و بسته، همراه با تغییر اندازه پنجره به‌گونه‌ای که اندازه سند تغییر نکند، و جابجایی پنجره به‌گونه‌ای که سند در همان موقعیت قبلی روی صفحه نمایش باقی بماند. .TP .B toggleSidebarResizeWin تغییر وضعیت نوار کناری بین باز و بسته، همراه با تغییر اندازه پنجره به‌گونه‌ای که اندازه سند تغییر نکند. .TP .B toggleToolbar تغییر وضعیت نوار ابزار بین حالت آشکار و پنهان. .TP .B viewPageLabels نمایش برچسب صفحات (در صورتی که فایل PDF دارای آن‌ها باشد) به جای شماره صفحات. .TP .B viewPageNumbers نمایش شماره صفحات به جای برچسب صفحات. .TP .B windowMode رفتن به حالت پنجره‌ای (غیر تمام‌صفحه). .TP .B zoomFitPage تنظیم ضریب بزرگ‌نمایی روی اندازه کل صفحه (fit-page). .TP .B zoomFitWidth تنظیم ضریب بزرگ‌نمایی روی برازش با عرض صفحه (fit-width). .TP .B zoomIn بزرگ‌نمایی \- رفتن به ضریب بزرگ‌نمایی بیشترِ بعدی. .TP .B zoomOut کوچک‌نمایی \- رفتن به ضریب بزرگ‌نمایی کمترِ بعدی. .TP .BI zoomPercent( z ) تنظیم ضریب بزرگ‌نمایی روی .IR z %. .TP .B zoomToSelection بزرگ‌نمایی روی محدوده انتخابی فعلی..SH "حالت کارساز دوردست (REMOTE SERVER MODE)" اجرای xpdf با سوییچ «\-remote» آن را در حالت کارساز دوردست قرار می‌دهد. تمام گزینه‌های باقی‌ماندهٔ خط فرمان، دستور هستند (بخش دستورها (COMMANDS) را ببینید). فراخوانی‌های بعدی «xpdf \-remote» با همان نام کارساز دوردست، دستورها را به نمونهٔ در حال اجرای xpdf ارسال خواهند کرد. دستورهای «checkOpenFile» در اینجا برای مواردی همچون تغییر صفحه‌ها سودمند هستند. برای نمونه: .PP .RS # راه‌اندازی xpdf و باز کردن something.pdf. xpdf -remote foo 'openFile(something.pdf)' # رفتن به صفحهٔ ۷ در something.pdf که از پیش باز است. اگر کاربر # در این فاصله xpdf را بسته باشد، این دستور آن را مجدداً راه‌اندازی کرده و # فایل را باز می‌کند. xpdf -remote foo 'checkOpenFileAtPage(something.pdf, 7)' # ارسال دو دستور به نمونهٔ دوردست: (۱) باز کردن something.pdf # و سپس (۲) بالا آوردن پنجرهٔ xpdf. xpdf -remote foo 'openFile(something.pdf)' raise .RE .PP .SH "کدهای خروج (EXIT CODES)" ابزارهای Xpdf از کدهای خروج زیر استفاده می‌کنند: .TP 0 بدون خطا. .TP 1 خطا در باز کردن فایل PDF. .TP 2 خطا در باز کردن فایل خروجی. .TP 3 خطای مربوط به مجوزهای PDF. .TP 99 خطای دیگر. .SH "نویسندگان (AUTHORS)" حق نشر نرم‌افزار و مستندات xpdf متعلق به Glyph & Cog, LLC بین سال‌های 1996-2025 است. .SH "همچنین ببینید (SEE ALSO)" .BR pdftops (1), .BR pdftotext (1), .BR pdftohtml (1), .BR pdfinfo (1), .BR pdffonts (1), .BR pdfdetach (1), .BR pdftoppm (1), .BR pdftopng (1), .BR pdfimages (1), .BR xpdfrc (5) .br .B http://www.xpdfreader.com