نام (NAME)

pdftk - ابزاری کارآمد برای دستکاری و مدیریت اسناد PDF

خلاصه دستور (SYNOPSIS)

pdftk <فایل‌های PDF ورودی | - | PROMPT>
[ input_pw <گذرواژه‌های مالک PDF ورودی | PROMPT> ]
[ <عملیات> <آرگومان‌های عملیات> ]
[ output <نام فایل خروجی | - | PROMPT> ]
[ encrypt_40bit | encrypt_128bit | encrypt_aes128 ]
[ allow <مجوزها> ]
[ owner_pw <گذرواژه مالک | PROMPT> ]
[ user_pw <گذرواژه کاربر | PROMPT> ]
[ flatten ] [ need_appearances ]
[ compress | uncompress ]
[ keep_first_id | keep_final_id ] [ drop_xfa ] [ drop_xmp ]
[ replacement_font <نام قلم> ]
[ verbose ] [ dont_ask | do_ask ]
که در آن:
<عملیات> می‌تواند خالی باشد یا شامل موارد زیر:
[ cat | shuffle | burst | rotate |
generate_fdf | fill_form |
background | multibackground |
stamp | multistamp |
dump_data | dump_data_utf8 |
dump_data_fields | dump_data_fields_utf8 |
dump_data_annots |
update_info | update_info_utf8 |
attach_files | unpack_files ]

برای راهنمای کامل: pdftk --help

توضیحات (DESCRIPTION)

اگر PDF را کاغذ الکترونیکی در نظر بگیریم، آن‌گاه pdftk برای آن حکم منگنه‌کش، دستگاه پانچ، شیرازه‌بند، ابزار رمزگشایی و عینک اشعهٔ ایکس الکترونیکی را دارد. ابزار pdftk برنامه‌ای ساده برای انجام کارهای روزمره با اسناد PDF است. از آن برای موارد زیر استفاده کنید:

* ادغام اسناد PDF یا مرتب‌سازی صفحات اسکن‌شدهٔ PDF
* جداسازی و استخراج صفحات PDF در یک سند جدید
* چرخاندن اسناد یا صفحات PDF
* رمزگشایی ورودی در صورت نیاز (نیازمند گذرواژه)
* رمزگذاری خروجی بر اساس نیاز
* پر کردن فرم‌های PDF با داده‌های X/FDF و/یا ایستا کردن (Flatten) فرم‌ها
* تولید قالب داده‌های FDF از روی فرم‌های PDF
* اعمال واترمارک در پس‌زمینه یا مُهر در پیش‌زمینه
* گزارش مشخصات فنی، نشانک‌ها (Bookmarks) و فراداده‌های سند PDF
* افزودن یا به‌روزرسانی مشخصات، نشانک‌ها یا فراداده‌های PDF
* پیوست کردن فایل‌ها به صفحات PDF یا به کل سند PDF
* استخراج پیوست‌های موجود در PDF
* تفکیک یک سند PDF به صفحات تک‌برگی (Burst)
* خارج کردن از حالت فشرده و فشرده‌سازی مجدد جریان‌های دادهٔ صفحات
* ترمیم فایل‌های آسیب‌دیدهٔ PDF (تا حد امکان).SH "گزینه‌ها (OPTIONS)" خلاصه‌ای از گزینه‌ها در زیر آمده است.

--help, -h

نمایش این خلاصه از گزینه‌ها.

<input PDF files | - | PROMPT>

فهرستی از فایل‌های PDF ورودی. اگر قصد دارید این PDFها را ترکیب کنید (بدون استفاده از دستگیره‌ها)، فایل‌ها را به همان ترتیبی که می‌خواهید ترکیب شوند فهرست کنید. از - برای فرستادن یک PDF منفرد به pdftk از طریق stdin استفاده کنید. فایل‌های ورودی می‌توانند با دستگیره‌ها (handles) مرتبط شوند، که در آن یک دستگیره شامل یک یا چند حرف بزرگ انگلیسی است:

<input PDF handle>=<input PDF filename>

دستگیره‌ها اغلب حذف می‌شوند. آن‌ها هنگام تعیین گذرواژه‌های PDF یا محدوده‌های صفحات در مراحل بعد مفید هستند.

برای مثال: A=input1.pdf QT=input2.pdf M=input3.pdf

[input_pw <input PDF owner passwords | PROMPT>]

گذرواژه‌های مالک (owner) برای PDFهای ورودی، در صورت نیاز، با استفاده از دستگیره‌های آن‌ها به فایل‌ها متصل می‌شوند:

<input PDF handle>=<input PDF file owner password>

اگر دستگیره‌ها مشخص نشوند، گذرواژه‌ها به ترتیب با فایل‌های ورودی مرتبط می‌شوند.

بیشتر قابلیت‌های pdftk نیازمند این هستند که PDF ورودیِ رمزگذاری‌شده با گذرواژهٔ ~مالک~ (~owner~) همراه باشد. اگر PDF ورودی گذرواژهٔ مالک ندارد، در عوض باید گذرواژهٔ کاربر (user) ارائه شود. اگر PDF ورودی هیچ گذرواژه‌ای ندارد، نباید گذرواژه‌ای داده شود.

هنگام اجرا در حالت do_ask، چنانچه گذرواژهٔ ارائه‌شده نادرست باشد یا هیچ گذرواژه‌ای وارد نشده باشد، pdftk برای دریافت گذرواژه از شما درخواست خواهد کرد.

[<operation> <operation arguments>]

عملیات‌های موجود عبارتند از: cat، shuffle، burst، rotate، generate_fdf، fill_form، background، multibackground، stamp، multistamp، dump_data، dump_data_utf8، dump_data_fields، dump_data_fields_utf8، dump_data_annots، update_info، update_info_utf8، attach_files، unpack_files. برخی از عملیات‌ها آرگومان‌های اضافی می‌گیرند که در ادامه توضیح داده شده‌اند.

اگر این آرگومان اختیاری حذف شود، pdftk در حالت «فیلتر» ('filter') اجرا می‌شود. حالت فیلتر تنها یک ورودی PDF می‌گیرد و پس از اعمال تمام گزینه‌های خروجی، مانند رمزگذاری و فشرده‌سازی، یک PDF جدید می‌سازد.

[output <output filename | - | PROMPT>]

نام فایل PDF خروجی نباید برابر با نام یکی از فایل‌های ورودی باشد. برای ارسال خروجی به stdout از - استفاده کنید. هنگام استفاده از عملیات dump_data، از output برای تعیین نام فایل داده خروجی استفاده کنید. هنگام استفاده از عملیات unpack_files، از output برای تعیین نام دایرکتوری خروجی استفاده کنید. هنگام استفاده از عملیات burst، می‌توانید از output برای کنترل نام فایل‌های صفحات PDF حاصل استفاده کنید (در بالا شرح داده شده است).

[encrypt_40bit | encrypt_128bit | encrypt_aes128]

اگر برای PDF خروجی یک گذرواژه کاربر یا مالک مشخص شود، الگوریتم رمزنگاری PDF خروجی به‌طور پیش‌فرض بر روی AES-128 تنظیم می‌شود. الگوریتم‌های ضعیف‌تر RC4 40-bit و RC4 128-bit را می‌توان با مشخص کردن encrypt_40bit یا encrypt_128bit انتخاب کرد (توصیه نمی‌شود).

[allow <permissions>]

مجوزها (Permissions) تنها در صورتی بر روی PDF خروجی اعمال می‌شوند که یک سطح رمزنگاری مشخص شده باشد یا گذرواژه مالک یا کاربر ارائه شده باشد. اگر دسترسی‌ها مشخص نشوند، مقدار پیش‌فرض آنها 'none' خواهد بود که به معنای غیرفعال بودن تمام قابلیت‌های زیر است.

بخش permissions می‌تواند شامل یک یا چند مورد از قابلیت‌های زیر باشد:

[owner_pw <owner password | PROMPT>]

[user_pw <user password | PROMPT>]

اگر سطح رمزنگاری تعیین شود اما هیچ گذرواژه‌ای داده نشود، گذرواژه‌های مالک و کاربر خالی باقی می‌مانند؛ این بدان معناست که هر کسی می‌تواند PDF حاصل را باز کند و پارامترهای امنیتی آن را تغییر دهد.

[compress | uncompress]

این گزینه‌ها فقط زمانی مفید هستند که بخواهید کد PDF را در یک ویرایشگر متن مانند vim یا emacs ویرایش کنید. با اعمال فیلتر uncompress، فشرده‌سازی جریان (stream) صفحه PDF را حذف کنید. برای بازگرداندن فشرده‌سازی از فیلتر compress استفاده نمایید.

[flatten]

از این گزینه برای ادغام فیلدهای فرم تعاملی PDF ورودی (و داده‌های آنها) با صفحات PDF استفاده کنید. تنها یک PDF ورودی را می‌توان مشخص کرد. گاهی اوقات همراه با عملیات fill_form استفاده می‌شود.

[need_appearances]

پرچمی را تنظیم می‌کند که به Reader/Acrobat اشاره می‌کند تا بر اساس مقادیر فیلدهای فرم، ظاهر جدیدی برای فیلدها ایجاد کند. هنگام پر کردن فرم با متن غیر ASCII، از این گزینه برای اطمینان از بهترین نحوه نمایش در Adobe Reader یا Acrobat استفاده کنید. این گزینه در صورت ترکیب با گزینه flatten کار نخواهد کرد.

[replacement_font <font name>]

از قلم مشخص‌شده برای نمایش متن در فیلدهای فرم استفاده می‌کند. این گزینه زمانی مفید است که فرمی را با متنی غیر ASCII پر می‌کنید که توسط قلم‌های موجود در PDF ورودی پشتیبانی نمی‌شود. font name می‌تواند نام فایل یا نام خانواده قلم باشد، اما استفاده از نام فایل قابل اطمینان‌تر است. در حال حاضر فقط قلم‌های TrueType با متن Unicode پشتیبانی می‌شوند.

[keep_first_id | keep_final_id]

هنگام ترکیب صفحات از چندین فایل PDF، از یکی از این گزینه‌ها برای رونوشت شناسه سند (document ID) از سند ورودی نخست یا پایانی به PDF خروجی جدید استفاده کنید. در غیر این صورت pdftk یک شناسه سند جدید برای PDF خروجی ایجاد می‌کند. هنگامی که هیچ عملیاتی مشخص نشده باشد، pdftk همیشه از شناسه سند ورودی (تکی) استفاده می‌کند.

[drop_xfa]

اگر PDF ورودی شما فرمی است که با استفاده از Acrobat 7 یا Adobe Designer ایجاد شده است، احتمالاً دارای داده‌های XFA است. پر کردن چنین فرمی با استفاده از pdftk باعث تولید یک PDF با داده‌هایی می‌شود که در Acrobat 7 (و احتمالاً 6؟) نمایش داده نمی‌شوند. راهکار این است که داده‌های XFA فرم را پیش از پر کردن فرم با pdftk یا در هنگام پر کردن آن حذف کنید. استفاده از این گزینه باعث می‌شود pdftk داده‌های XFA را از فرم PDF خروجی حذف کند.

این گزینه فقط هنگام اجرای pdftk بر روی یک فایل PDF ورودی تکی مفید است. هنگام سرهم‌بندی یک PDF از چندین فایل ورودی با استفاده از pdftk، هرگونه داده XFA موجود در ورودی به‌طور خودکار حذف می‌شود.

[drop_xmp]

بسیاری از فایل‌های PDF، فراداده‌های سند را هم با استفاده از دیکشنری Info (شیوه قدیمی) و هم جریان XMP (شیوه جدید) ذخیره می‌کنند. عملیات update_info در pdftk می‌تواند دیکشنری Info را به‌روز کند، اما جریان XMP را خیر. راهکار مناسب برای این موضوع، قرار دادن یک مدخل ModDate با تاریخ/زمان جاری در اطلاعات به‌روزرسانی‌شده شما است. قالب تاریخ/زمان عبارت است از: D:YYYYMMDDHHmmSS، برای مثال D:201307241346 – داده‌های حذف‌شده پس از YYYY به مقادیر پیش‌فرض بازمی‌گردند. این ModDate جدیدتر باید به نمایشگرهای PDF نشان دهد که فراداده‌های Info به‌روزتر از داده‌های XMP هستند.

همچنین، ممکن است ترجیح دهید جریان XMP را به‌کلی از PDF حذف کنید – این دقیقاً کاری است که این گزینه انجام می‌دهد. توجه داشته باشید که اشیاء درون PDF ممکن است جریان‌های فراداده XMP مجزا و مخصوص به خود داشته باشند و drop_xmp آنها را حذف نمی‌کند؛ این گزینه تنها جریان XMP در سطح سندِ PDF را حذف می‌کند.

[verbose]

به‌طور پیش‌فرض، pdftk بدون پیام اجرا می‌شود. افزودن verbose به انتها باعث می‌شود اطلاعات و جزئیات بیشتری نمایش داده شود.

[dont_ask | do_ask]

بسته به تنظیمات زمان کامپایل (نگاه کنید به ASK_ABOUT_WARNINGS)، در صورت بروز مشکل مانند یک گذرواژه نادرست، pdftk ممکن است از شما ورودی بیشتری درخواست کند. با افزودن dont_ask (تا pdftk از شما نپرسد چه باید کرد) یا do_ask (تا pdftk از شما بپرسد چه کاری انجام دهد)، این رفتار پیش‌فرض را بازنویسی کنید.

هنگام اجرا در حالت dont_ask، برنامه pdftk فایل‌ها را بدون اطلاع قبلی با خروجی خود بازنویسی (over-write) خواهد کرد..SH "مثال‌ها (EXAMPLES)"

تلفیق صفحات اسکن‌شده

pdftk A=even.pdf B=odd.pdf shuffle A B output collated.pdf
یا اگر odd.pdf دارای ترتیب معکوس است:
pdftk A=even.pdf B=odd.pdf shuffle A Bend-1 output collated.pdf

مثال‌های زیر از گذرواژه‌های واقعی به عنوان پارامترهای خط فرمان استفاده می‌کنند، که این کار توصیه نمی‌شود (بخش «ملاحظات امنیتی (SECURITY CONSIDERATIONS)» را ببینید).

رمزگشایی یک PDF

pdftk secured.pdf input_pw foopass output unsecured.pdf

رمزنگاری یک PDF با استفاده از AES-128 (پیش‌فرض) و سلب تمام مجوزها (پیش‌فرض)

pdftk 1.pdf output 1.128.pdf owner_pw foopass

مانند بالا، به جز اینکه گذرواژه 'baz' نیز باید برای باز کردن PDF خروجی استفاده شود

pdftk 1.pdf output 1.128.pdf owner_pw foo user_pw baz

مانند بالا، به جز اینکه چاپ کردن مجاز است (پس از باز شدن PDF)

pdftk 1.pdf output 1.128.pdf owner_pw foo user_pw baz allow printing

اعمال رمزنگاری ۴۰ بیتی RCA روی خروجی و لغو تمام مجوزها (پیش‌فرض). تنظیم گذرواژه مالک به 'foopass'.

pdftk 1.pdf 2.pdf cat output 3.pdf encrypt_40bit owner_pw foopass

پیوند زدن دو فایل که یکی از آن‌ها نیازمند گذرواژه 'foopass' است. خروجی رمزنگاری نمی‌شود.

pdftk A=secured.pdf 2.pdf input_pw A=foopass cat output 3.pdf

پیوند زدن in1.pdf و in2.pdf در یک PDF جدید به نام out1.pdf

pdftk in1.pdf in2.pdf cat output out1.pdf
یا (با استفاده از دسته‌ها):
pdftk A=in1.pdf B=in2.pdf cat A B output out1.pdf
یا (با استفاده از نویسه‌های عام):
pdftk *.pdf cat output combined.pdf

حذف صفحه ۱۳ از in1.pdf برای ایجاد out1.pdf

pdftk in.pdf cat 1-12 14-end output out1.pdf
یا:
pdftk A=in1.pdf cat A1-12 A14-end output out1.pdf

فشرده‌زدایی از جریان‌های صفحه PDF برای ویرایش PDF در یک ویرایشگر متن (مانند vim یا emacs)

pdftk doc.pdf output doc.unc.pdf uncompress

بازسازی جدول آسیب‌دیده XREF و طول جریان‌های PDF، در صورت امکان

pdftk broken.pdf output fixed.pdf

تجزیه یک سند تک‌فایل PDF به صفحات مجزا و تخلیه داده‌های آن در doc_data.txt

pdftk in.pdf burst

تجزیه یک سند PDF به صفحات رمزنگاری‌شده و مجاز کردن چاپ با کیفیت پایین

pdftk in.pdf burst owner_pw foopass allow DegradedPrinting

نوشتن گزارش از فراداده‌ها و نشانک‌های سند PDF در report.txt

pdftk in.pdf dump_data output report.txt

چرخاندن اولین صفحه PDF به اندازه ۹۰ درجه در جهت عقربه‌های ساعت

pdftk in.pdf cat 1east 2-end output out.pdf

چرخاندن کل یک سند PDF به اندازه ۱۸۰ درجه

pdftk in.pdf cat 1-endsouth output out.pdf

نکات (NOTES)

این یک پورت از pdftk به جاوا است. ببینید:
https://gitlab.com/pdftk-java/pdftk
برنامه اصلی را می‌توان در www.pdftk.com یافت.

نویسنده (AUTHOR)

نویسنده اصلی pdftk، Sid Steward (sid.steward at pdflabs dot com) است.

ملاحظات امنیتی (SECURITY CONSIDERATIONS)

ارسال گذرواژه به عنوان پارامتر خط فرمان ناامن است زیرا می‌تواند در تاریخچه پوسته ذخیره شده و از طریق /proc برای سایر کاربران قابل دسترسی باشد. در عوض، از کلمه کلیدی PROMPT استفاده کرده و گذرواژه‌ها را از طریق ورودی استاندارد وارد کنید.