.\" Copyright 1999-2011 Glyph & Cog, LLC
.TH pdfinfo 1 "15 August 2011"
.SH "نام (NAME)"
pdfinfo \- استخراج‌کنندهٔ اطلاعات سند در قالب سند قابل‌حمل (PDF) (نسخه ۳.۰۳)
.SH "خلاصه دستور (SYNOPSIS)"
.B pdfinfo
[گزینه‌ها]
.RI [ PDF-file ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pdfinfo
محتوای واژه‌نامهٔ «Info» (به‌همراه برخی اطلاعات مفید دیگر) را از یک فایل در قالب سند قابل‌حمل (PDF) چاپ می‌کند.
.PP
اگر
.I PDF-file
برابر با «\-» باشد، فایل PDF را از ورودی استاندارد (stdin) می‌خواند.
.PP
واژه‌نامهٔ «Info» شامل مقادیر زیر است:
.PP
.RS
عنوان (title)
.RE
.RS
موضوع (subject)
.RE
.RS
کلیدواژه‌ها (keywords)
.RE
.RS
نویسنده (author)
.RE
.RS
سازنده (creator)
.RE
.RS
تولیدکننده (producer)
.RE
.RS
تاریخ ایجاد (creation date)
.RE
.RS
تاریخ ویرایش (modification date)
.RE
.PP
علاوه بر این، اطلاعات زیر نیز چاپ می‌شوند:
.PP
.RS
فرادادهٔ سفارشی (بله/خیر)
.RE
.RS
جریان فراداده (بله/خیر)
.RE
.RS
نشانه‌دار (tagged) (بله/خیر)
.RE
.RS
ویژگی‌های کاربر (userproperties) (بله/خیر)
.RE
.RS
موارد مشکوک (suspects) (بله/خیر)
.RE
.RS
فرم (AcroForm / XFA / هیچ‌کدام)
.RE
.RS
جاوااسکریپت (بله/خیر)
.RE
.RS
تعداد صفحات
.RE
.RS
پرچم رمزگذاری (بله/خیر)
.RE
.RS
مجوزهای چاپ و رونوشت (در صورت رمزگذاری بودن)
.RE
.RS
اندازهٔ صفحه
.RE
.RS
اندازهٔ فایل
.RE
.RS
خطی‌شده (linearized) (بله/خیر)
.RE
.RS
نسخهٔ PDF
.RE
.RS
فراداده (تنها در صورت درخواست)
.RE
.PP
گزینه‌های \-listenc، \-meta، \-js، \-struct و \-struct-text تنها اطلاعات درخواست‌شده را چاپ می‌کنند. واژه‌نامهٔ «Info» و داده‌های مرتبطِ فهرست‌شده در بالا چاپ نمی‌شوند. حداکثر می‌توان از یکی از این پنج گزینه استفاده کرد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-f " number"
نخستین صفحه‌ای را که باید بررسی شود مشخص می‌کند. اگر با استفاده از گزینه‌های «\-f» و «\-l» چندین صفحه درخواست شود، اندازهٔ هر صفحهٔ درخواستی (و در صورت تمایل، کادرهای احاطه‌کننده برای هر صفحهٔ درخواستی) چاپ می‌شود. در غیر این صورت، تنها صفحهٔ یک بررسی می‌شود.
.TP
.BI \-l " number"
آخرین صفحه‌ای را که باید بررسی شود مشخص می‌کند.
.TP
.B \-box
کادرهای احاطه‌کنندهٔ صفحه را چاپ می‌کند: MediaBox، CropBox، BleedBox، TrimBox و ArtBox.
.TP
.B \-meta
فراداده‌های سطح سند را چاپ می‌کند. (این همان جریان «Metadata» از شیء Catalog فایل PDF است.)
.TP
.B \-custom
فراداده‌های سفارشی و استاندارد را چاپ می‌کند.
.TP
.B \-js
تمام کدهای JavaScript موجود در PDF را چاپ می‌کند.
.TP
.B \-struct
ساختار منطقی سند را برای یک فایل Tagged-PDF چاپ می‌کند.
.TP
.B \-struct-text
محتوای متنی را همراه با ساختار سند در یک فایل Tagged-PDF چاپ می‌کند. توجه داشته باشید که استخراج متن از این طریق ممکن است برای فایل‌های بزرگ PDF کُند باشد. (مستلزم
.BR \-struct
است.)
.TP
.B \-url
تمام URLهای موجود در PDF را چاپ می‌کند. تنها نوع‌هایی از URL که توسط Poppler پشتیبانی می‌شوند فهرست می‌گردند. در حال حاضر، این مورد محدود به یادداشت‌ها (Annotations) است. نکته: تنها URLهایی که اشیاء PDF مانند Link Annotations به آن‌ها ارجاع داده‌اند فهرست می‌شوند. pdfinfo تلاشی برای استخراج رشته‌های مطابق با http://... از محتوای متنی نمی‌کند.
.TP
.B \-isodates
تاریخ‌ها را در قالب ISO-8601 (شامل منطقهٔ زمانی) چاپ می‌کند.
.TP
.B \-rawdates
رشته‌های خام (رمزگشایی‌نشده) تاریخ را مستقیماً از فایل PDF چاپ می‌کند.
.TP
.B \-dests
فهرستی از تمام مقصدهای نام‌گذاری‌شده (named destinations) را چاپ می‌کند. اگر محدودهٔ صفحه‌ای با استفاده از «\-f» و «\-l» مشخص شده باشد، تنها مقصدهای درون آن محدوده فهرست می‌شوند.
.TP
.BI \-enc " encoding-name"
رمزگذاری مورد استفاده برای خروجی متن را تعیین می‌کند. مقدار پیش‌فرض «UTF-8» است.
.TP
.B \-listenc
رمزگذاری‌های موجود را فهرست می‌کند.
.TP
.BI \-opw " password"
گذرواژهٔ مالک (owner password) را برای فایل PDF تعیین می‌کند. ارائهٔ این گذرواژه تمامی محدودیت‌های امنیتی را دور می‌زند.
.TP
.BI \-upw " password"
گذرواژهٔ کاربر (user password) را برای فایل PDF تعیین می‌کند.
.TP
.B \-v
اطلاعات نسخه و کپی‌رایت را چاپ می‌کند.
.TP
.B \-h
اطلاعات نحوهٔ استفاده را چاپ می‌کند.
.RB ( \-help
و
.B \-\-help
معادل یکدیگرند.)
.SH "وضعیت خروج (EXIT STATUS)"
ابزارهای Xpdf از کدهای خروج زیر استفاده می‌کنند:
.TP
0
بدون خطا.
.TP
1
خطا در باز کردن فایل PDF.
.TP
2
خطا در باز کردن فایل خروجی.
.TP
3
خطای مربوط به مجوزهای PDF.
.TP
99
خطاهای دیگر.
.SH "نویسنده (AUTHOR)"
نرم‌افزار pdfinfo و مستندات آن تحت کپی‌رایت سال‌های ۱۹۹۶\-۲۰۱۱ متعلق به Glyph & Cog, LLC است.
.SH "همچنین ببینید (SEE ALSO)"
.BR pdfdetach (1),
.BR pdffonts (1),
.BR pdfimages (1),
.BR pdftocairo (1),
.BR pdftohtml (1),
.BR pdftoppm (1),
.BR pdftops (1),
.BR pdftotext (1)
.BR pdfseparate (1),
.BR pdfsig (1),
.BR pdfunite (1)