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