| PDFOPEN(1) | PDFOPEN(1) |
نام (NAME)
pdfopen, pdfclose - باز کردن یا بستن یک نمایش‌دهنده فایل PDF
خلاصه دستور (SYNOPSIS)
pdfopen [
گزینه‌ها
] [ --file ] file.pdf
pdfclose [ --file ] file.pdf
گزینه‌ها (OPTIONS)
- -h, --help, -?
- نمایش راهنما و خروج.
- -v, --version, -V
- نمایش شماره نسخه و خروج.
- -p <n>, --page <n>
- هنگام راه‌اندازی نمایش‌دهنده، صفحه <n> از سند را نمایش می‌دهد (یادداشت: همه نمایش‌دهنده‌ها از این قابلیت پشتیبانی نمی‌کنند و حتی در آن موارد نیز این گزینه تنها در زمان بارگذاری اولیه سند اثر دارد). این گزینه توسط -g نادیده گرفته می‌شود.
- -g <named destination>, --goto <named destination>
- هنگام راه‌اندازی نمایش‌دهنده، صفحه‌ای از سند که حاوی مقصد نام‌گذاری‌شده است را نمایش می‌دهد (یادداشت: همه نمایش‌دهنده‌ها از این قابلیت پشتیبانی نمی‌کنند و حتی در آن موارد نیز این گزینه تنها در زمان بارگذاری اولیه سند اثر دارد).
- -r, --reset_focus
- پس از ارسال دستورها به نمایش‌دهنده PDF، تلاش می‌کند تا تمرکز ورودی را به پنجره‌ای که پیش از ارسال دستورها فعال بود، بازگرداند.
- -viewer, --viewer <ar9|ar9-tab|ar8|ar7|ar5|xpdf|evince>
- استفاده (به‌ترتیب) از Adobe Reader 9 (در یک پنجره جدید)، Adobe Reader 9 (در یک برگه جدید از یک AR9 در حال اجرا، در صورت وجود)، Adobe Reader 8، Adobe Reader 7، Adobe Reader 5، xpdf یا evince به عنوان برنامه نمایش‌دهنده PDF. پیش‌فرض، Adobe Reader 9 (در یک پنجره جدید) است.
علت پیدایش (RATIONALE)
در مراحلی از آماده‌سازی اسناد TeX، بسیاری از افراد چرخه «ویرایش-کامپایل-مشاهده» را تکرار می‌کنند. از آنجا که نمایش‌دهنده‌های PDF مانند Acrobat Reader ادوبی («acroread») با تغییر فایل PDF، تصویر را به‌طور خودکار تازه‌سازی (refresh) نمی‌کنند، این چرخه می‌تواند خسته‌کننده‌تر از حد انتظار شود. برنامه pdfopen قابلیت بارگذاری مجدد و خودکار سند PDF را به هنگام تغییر یافتن آن فراهم می‌کند.
یادداشت: به نظر می‌رسد نیاز چندانی به pdfclose در GNU/Linux وجود ندارد، چرا که (برخلاف وضعیت موجود در MS windows) برنامه acroread فایل PDF را قفل نمی‌کند؛ قفلی که مانع از ایجاد نسخه جدیدی از فایل خروجی PDF توسط pdftex (یا یک مبدل DVI به PDF) شود. با این حال، pdfclose برای مواردی که ممکن است فردی آن را مفید بیابد، ارائه شده است.
توضیحات (DESCRIPTION)
دستور pdfopen به دنبال نمونه‌ای از نمایش‌دهنده PDF مشخص‌شده (یا پیش‌فرض) می‌گردد که فایل PDF مشخص‌شده را نمایش می‌دهد. اگر در حال حاضر نمونه‌ای از نمایش‌دهنده داده‌شده در حال نمایش این فایل باشد، به نمایش‌دهنده دستور داده می‌شود که فایل را دوباره بارگذاری کند. اگر چنین نمونه‌ای یافت نشود، pdfopen تلاش می‌کند نمایش‌دهنده مشخص‌شده را روی سند داده‌شده اجرا کند.
نمایش‌دهنده پیش‌فرض «acroread» است که بسته به آنچه روی سیستم شما نصب شده است، می‌تواند هر یک از نسخه‌های مختلف Acrobat Reader را اجرا کند. با این حال، دستورات بارگذاری مجدد سند جاری از یک نسخه acroread به نسخه دیگر متفاوت است؛ بنابراین، چنانچه از نسخه‌ای از acroread غیر از AR9 استفاده می‌کنید، باید برنامه نمایش‌دهنده را به‌طور صریح مشخص کنید.
این نسخه
از pdfopen
گزینه‌های
نمایش‌دهنده
زیر را
می‌پذیرد:
ar9، ar9-tab، ar8،
ar7، ar5، xpdf و evince.
تفاوت بین ar9
و ar9-tab زمانی
چشمگیر است
که هیچ
نمونه‌ای
از AR9 سند
درخواستی
را نمایش
ندهد. در این
وضعیت، در
حالی که ar9
با استفاده
از آرگومان
-openInNewInstance از acroread
می‌خواهد
که یک نمونه
جدید از acroread
ایجاد کند (و
در نتیجه
پنجره
جدیدی باز
کند)، ar9-tab
برنامه acroread
را بدون این
آرگومان
اجرا
می‌کند؛
چنانچه
نمونه‌ای
از acroread از پیش
در حال اجرا
باشد، یک
برگه (tab) جدید
در پنجره
موجود باز
خواهد شد.
دستور pdfclose به دنبال یکی از نمایش‌دهنده‌های PDF فوق که فایل داده‌شده را نمایش می‌دهد می‌گردد و به نمایش‌دهنده دستور می‌دهد که پنجره را «ببندد». در بیشتر موارد، نمایش‌دهنده PDF به اجرای خود ادامه می‌دهد و احتمالاً تنها یک پنجره خالی را نمایش خواهد داد. (این رفتار از یک نمایش‌دهنده PDF به دیگری تا حدودی متفاوت است).
سازگاری و در دسترس بودن (PORTABILITY AND AVAILABILITY)
این برنامه‌ها روی Slackware64 نسخه 14.1 و چند نسخه/توزیع دیگر GNU/Linux آزمایش شده‌اند. کد برنامه تا حد معقولی عمومی است و باید در اکثر پیاده‌سازی‌های اخیر X11 بی‌درنگ و بدون دستکاری کار کند. (گزارش‌های خلاف این موضوع مورد استقبال قرار می‌گیرد، به‌ویژه اگر همراه با راه‌حل‌های پایدار باشند).
این برنامه‌ها برای سیستم‌های مبتنی بر X11 طراحی شده‌اند. چنانچه به طریقی نسخه‌های کامپایل‌شده این برنامه‌ها را روی سیستمی پیدا کردید که از سیستم پنجره‌ای دیگری استفاده می‌کند، بسیار بعید است که برای شما کاربردی داشته باشند.
کد منبع و باینری‌های این برنامه‌ها را می‌توان از مسیر زیر دریافت کرد: CTAN://support/xpdfopen (به‌عنوان نمونه، http://mirror.ctan.org/support/xpdfopen).
هشدارها (CAVEATS)
اگر از ar9-tab برای بارگذاری دوباره سند PDF استفاده کنید و نمونه‌ای از acroread که سند داده‌شده در آن باز است در حال حاضر سند دیگری را نمایش دهد، این دستور باعث می‌شود که سند شما نمایش داده شود، اما دوباره بارگذاری نشود.
دستور pdfopen با جستجو برای پنجره‌ای کار می‌کند که عنوان آن با عنوان مورد انتظار برای نمایش‌دهنده و سند داده‌شده مطابقت داشته باشد. اگر به هر دلیلی عنوان پنجره نمایش‌دهنده شما مطابق انتظار نباشد، ممکن است pdfopen برای شما کار نکند.
حداقل در مورد AR9 و برخی از مدیران پنجره، استفاده از pdfopen برای بارگذاری دوباره سند، تمرکز (focus) را به پنجره acroread می‌دهد، حتی اگر نشانگر ماوس لزوماً در آن پنجره نباشد. این موضوع می‌تواند آزاردهنده باشد. برای برطرف کردن این مشکل می‌توان از گزینه -reset_focus استفاده کرد.
نویسندگان (AUTHORS)
این صفحه راهنما توسط Jim Diamond <Jim.Diamond@acadiau.ca> نوشته شده است. من نگه‌دارنده فعلی نسخه‌های X11 برنامه‌های pdfopen و pdfclose هستم. هر باگی که می‌یابید را به من گزارش دهید. درخواست‌های افزودن قابلیت‌ها مورد استقبال است، و بهبودهایی که کد آن‌ها نوشته شده باشد حتی بیشتر.
نویسندگان پیشین: Fabrice Popineau نسخه‌های MS-windows برنامه‌های pdfopen و pdfclose را نوشت که این برنامه‌ها در ابتدا بر پایه آن‌ها شکل گرفتند. Taco Hoekwater نسخه‌های GNU/Linux را تا نسخه 0.61 توسعه داد (شامل برخی مستندات که بخش‌هایی از این صفحه راهنما از آن‌ها الهام گرفته است). Peter Breitenlohner در نسخه‌های پس از 0.61 هم با کدنویسی و هم با ارائه پیشنهادها مشارکت داشته است.
| 2014-05-24 | pdfopen 0.86 |