.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "POD2PDF 1" .TH POD2PDF 1 2025-12-14 "perl v5.42.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" pod2pdf \- تبدیل مستندات Pod به قالب PDF .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور .B pod2pdf اسناد نوشته‌شده به قالب .BR POD " (" "Plain Old Documentation" ")" پرل را به پرونده‌های PDF تبدیل می‌کند. .SS "نحوه استفاده (Usage)" .IX Subsection "Usage" .Vb 1 \& pod2pdf [options] input.pod >output.pdf .Ve .PP اگر نام پرونده ورودی مشخص نشود، .B pod2pdf از ورودی استاندارد (STDIN) داده‌ها را می‌خواند؛ مانند: .PP .Vb 1 \& perldoc \-u File::Find | pod2pdf [options] >File\-Find.pdf .Ve .SS "گزینه‌ها (Options)" .IX Subsection "Options" دستور .B pod2pdf گزینه‌های خط فرمان زیر را می‌پذیرد: .ie n .IP """\-\-output\-file""" 4 .el .IP \f(CW\-\-output\-file\fR 4 .IX Item "--output-file" نام پرونده خروجی را برای فایل PDF تولیدشده تعیین می‌کند. به‌طور پیش‌فرض، .B pod2pdf خروجی را به خروجی استاندارد (STDOUT) می‌فرستد. .ie n .IP """\-\-page\-size""" 4 .el .IP \f(CW\-\-page\-size\fR 4 .IX Item "--page-size" اندازه صفحه را برای استفاده در پرونده PDF تنظیم می‌کند؛ می‌تواند روی هر یک از اندازه‌های استاندارد کاغذ (A4، A5، Letter و غیره) تنظیم شود. مقدار پیش‌فرض A4 است. .ie n .IP """\-\-page\-orientation""" 4 .el .IP \f(CW\-\-page\-orientation\fR 4 .IX Item "--page-orientation" جهت صفحات را به‌صورت افقی (landscape) یا عمودی (portrait) کنترل می‌کند. مقدار پیش‌فرض \*(Aqportrait\*(Aq است. .ie n .IP """\-\-page\-width"", ""\-\-page\-height""" 4 .el .IP "\f(CW\-\-page\-width\fR, \f(CW\-\-page\-height\fR" 4 .IX Item "--page-width, --page-height" عرض و ارتفاع صفحات تولیدشده را بر حسب پوینت (point) برای استفاده از اندازه‌های غیراستاندارد کاغذ تعیین می‌کند. .ie n .IP """\-\-left\-margin"", ""\-\-right\-margin"", ""\-\-top\-margin"", ""\-\-bottom\-margin""" 4 .el .IP "\f(CW\-\-left\-margin\fR, \f(CW\-\-right\-margin\fR, \f(CW\-\-top\-margin\fR, \f(CW\-\-bottom\-margin\fR" 4 .IX Item "--left-margin, --right-margin, --top-margin, --bottom-margin" امکان تنظیم جداگانه هر یک از حاشیه‌های صفحه (بالا، پایین، چپ و راست) را بر حسب پوینت فراهم می‌کند. .ie n .IP """\-\-margins""" 4 .el .IP \f(CW\-\-margins\fR 4 .IX Item "--margins" تمام حاشیه‌های صفحه را روی یک اندازه یکسان (مشخص‌شده بر حسب پوینت) تنظیم می‌کند. .ie n .IP """\-\-header"", ""\-\-noheader""" 4 .el .IP "\f(CW\-\-header\fR, \f(CW\-\-noheader\fR" 4 .IX Item "--header, --noheader" درج سرصفحه (شامل عنوان صفحه و برچسب زمانی و نشان اختیاری) در هر صفحه را کنترل می‌کند. این گزینه به‌طور پیش‌فرض فعال است، بنابراین برای غیرفعال کردن از \f(CW\*(C`\-\-noheader\*(C'\fR استفاده کنید. .ie n .IP """\-\-title""" 4 .el .IP \f(CW\-\-title\fR 4 .IX Item "--title" عنوان صفحه را تنظیم می‌کند (به‌طور پیش‌فرض نام پرونده ورودی است). .ie n .IP """\-\-timestamp""" 4 .el .IP \f(CW\-\-timestamp\fR 4 .IX Item "--timestamp" گزینه دودویی (بولی) \- در صورت تعیین، برچسب زمانی «آخرین تغییر» پرونده ورودی را در سرصفحه قرار می‌دهد. .ie n .IP """\-\-icon""" 4 .el .IP \f(CW\-\-icon\fR 4 .IX Item "--icon" نام پرونده نشانی که باید در گوشه بالا سمت چپ هر صفحه نمایش داده شود. .ie n .IP """\-\-icon\-scale""" 4 .el .IP \f(CW\-\-icon\-scale\fR 4 .IX Item "--icon-scale" مقدار مقیاس‌بندی برای نشان سرصفحه (پیش‌فرض 0.25 است). .ie n .IP """\-\-footer"", ""\-\-nofooter""" 4 .el .IP "\f(CW\-\-footer\fR, \f(CW\-\-nofooter\fR" 4 .IX Item "--footer, --nofooter" درج پانویس (شامل شماره صفحه فعلی و رشته متنی اختیاری) در هر صفحه را کنترل می‌کند. به‌طور پیش‌فرض پانویس درج می‌شود، بنابراین برای غیرفعال کردن از \&\f(CW\*(C`\-\-nofooter\*(C'\fR استفاده کنید. .ie n .IP """\-\-footer\-text""" 4 .el .IP \f(CW\-\-footer\-text\fR 4 .IX Item "--footer-text" یک رشته متنی اختیاری برای پانویس تعیین می‌کند که در گوشه پایین سمت چپ هر صفحه قرار می‌گیرد. .ie n .IP """\-\-version""" 4 .el .IP \f(CW\-\-version\fR 4 .IX Item "--version" شماره نسخه را چاپ کرده و خارج می‌شود. .SS "فایل‌های پیکربندی (Configuration files)" .IX Subsection "Configuration files" می‌توان مجموعه‌ای از گزینه‌های خط فرمان را در فایل‌های پیکربندی ذخیره کرد. .PP یک فایل پیکربندی شامل گزینه‌هایی با همان فرمت مورد استفاده توسط .B pod2pdf در خط فرمان است، به‌طوری که در هر خط فایل یک گزینه قرار می‌گیرد؛ مانند: .PP .Vb 2 \& \-\-page\-size A5 \& \-\-page\-orientation landscape .Ve .PP برای استفاده از یک فایل پیکربندی، .B pod2pdf را همراه با گزینه \f(CW\*(C`@/path/to/configfile.conf\*(C'\fR فراخوانی کنید. .PP برای نمونه، اگر می‌خواهید همیشه نشان‌واره (لوگو) شرکت، برچسب زمانی و اعلان حق نشر (کپی‌رایت) را در پرونده‌های PDF خود بگنجانید، فایلی به نام .I mycompany.conf با محتوای زیر ایجاد کنید: .PP .Vb 3 \& \-\-icon "/path/to/your/logo.png" \& \-\-footer\-text "Copyright 2007 MyCompany Limited" \& \-\-timestamp .Ve .PP سپس .B pod2pdf را به این صورت اجرا کنید: .PP .Vb 1 \& pod2pdf @/path/to/mycompany.conf input.pod >output.pdf .Ve .PP اگر یک فایل پیکربندی به نام .I pod2pdf.conf ایجاد کرده و آن را در همان پوشه‌ای قرار دهید که اسکریپت .B pod2pdf در آن قرار دارد، به عنوان پیکربندی پیش‌فرض بارگذاری خواهد شد. .SH "افزونه‌های پاد (POD EXTENSIONS)" .IX Header "POD ENTENSIONS" علاوه بر دستورات استاندارد POD (نگاه کنید به perlpodspec)، .B pod2pdf از افزونه‌های زیر برای قالب POD پشتیبانی می‌کند: .ie n .IP """=ff""" 4 .el .IP \f(CW=ff\fR 4 .IX Item "=ff" دستور \f(CW\*(C`=ff\*(C'\fR یک شکست صفحه (form feed) در سند درج می‌کند. .ie n .IP """O<...>""" 4 .el .IP \f(CWO<...>\fR 4 .IX Item "O<...>" کد قالب‌بندی \f(CW\*(C`O<...>\*(C'\fR یک شیء (پرونده) خارجی را در سند قرار می‌دهد. این کد اساساً برای جای‌گذاری تصاویر در نظر گرفته شده است؛ مانند: .Sp .Vb 1 \& O .Ve .Sp برای درج دیاگرام‌ها و موارد دیگر در مستندات. .Sp دستور .B pod2pdf از انواع فایل‌های JPG، GIF، TIFF، PNG و PNM برای اشیاء تعبیه‌شده پشتیبانی می‌کند. .SH "وابستگی‌ها (DEPENDENCIES)" .IX Header "DEPENDENCIES" دستور .B pod2pdf نیازمند نصب ماژول‌های زیر است: .IP PDF::API2 4 .IX Item "PDF::API2" .PD 0 .IP Pod::Escapes 4 .IX Item "Pod::Escapes" .IP Getopt::ArgvFile 4 .IX Item "Getopt::ArgvFile" .PD .PP علاوه بر این، برای استفاده از تصاویر، ماژول‌های File::Type و Image::Size باید نصب باشند و برای تعیین اندازه‌های متناوب کاغذ، ماژول Paper::Specs مورد نیاز است. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" صفحه خانگی pod2pdf: .PP برای دریافت اطلاعات بیشتر پیرامون POD، صفحه راهنمای perlpod را بخوانید یا به صفحه POD در ویکی پرل ۵ مراجعه کنید (). .SH "حق نشر و مجوز (COPYRIGHT and LICENSE)" .IX Header "COPYRIGHT and LICENSE" حق نشر (C) 2007 متعلق به Jon Allen (JJ) است. .PP این نرم‌افزار تحت شرایط مجوز هنری (Artistic License) نسخه 2.0 مجوزدهی شده است. .PP برای جزئیات کامل مجوز، لطفاً فایل .I artistic\-2_0.txt ارائه‌شده به همراه این توزیع را بخوانید، یا به نشانی زیر مراجعه کنید: