.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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 turned on, 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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "TEXDIRFLATTEN 1"
.TH TEXDIRFLATTEN 1 "2017-07-03" "texdirflatten-v1.3" "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)"
texdirflatten \- جمع‌آوری تمام اجزای یک فایل (La)TeX در یک دایرکتوری خروجی واحد \-\- یعنی مسطح‌سازی سلسله‌مراتب آن.
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
texdirflatten [\-1|\-\-onetex] [\-f|\-\-file input.tex] [\-o outputdir] 
    	      [\-\-imgexts .ext1,.ext2,...] [\-\-debug] [\-V|\-\-version] [\-?|\-\-help]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این اسکریپت Perl یک فایل LaTeX را به صورت بازگشتی پردازش کرده، تمام فایل‌های فرزند را پویش می‌کند و مشخصات هرگونه فایل پیوست‌شده یا سایر فایل‌های داده، مانند تصاویر و فایل‌های کتاب‌شناسی BiBTeX را جمع‌آوری می‌نماید. سپس این فایل‌های جزء همگی در یک دایرکتوری واحد قرار می‌گیرند (و به این ترتیب درخت دایرکتوری سند \*(L"مسطح\*(R" می‌شود). این قابلیت هنگام توزیع دست‌نوشته‌ها بین همکاران یا ارسال آن‌ها به ژورنال‌ها مفید است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-file\fR, \fB\-f\fR \fIinput.tex\fR" 4
.IX Item "--file, -f input.tex"
فایل ورودی (La)TeX را مشخص می‌کند.
.IP "\fB\-\-onetex\fR, \fB\-1\fR" 4
.IX Item "--onetex, -1"
در صورت تعیین، با بسط دادن تمامی دستورهای \einput و \&\einclude در همان محل، یک فایل TeX واحد تولید می‌کند.
.IP "\fB\-\-output\fR, \fB\-o\fR \fIoutputdir\fR" 4
.IX Item "--output, -o outputdir"
دایرکتوری برای جمع‌آوری تمام فایل‌ها. \fBtexdirflatten\fR تک‌تک فایل‌های منبع، تصاویر و فایل‌های کتاب‌شناسی را در این دایرکتوری کپی می‌کند. در صورت عدم وجود، ایجاد خواهد شد. اگر مشخص نشود، مقدار پیش‌فرض \f(CW\*(C`flat/\*(C'\fR است.
.IP "\fB\-\-imgexts\fR \fI.ext1,.ext2[,...]\fR" 4
.IX Item "--imgexts .ext1,.ext2[,...]"
این پسوندها را به ابتدای فهرست اولویت‌بندی‌شده پسوندهای تصویر اضافه می‌کند تا هنگام یافتن تصویر برای کپی در پوشه خروجی جستجو شوند. نخستین فایلی که با پسوند پیدا شده مطابقت داشته باشد کپی شده و جستجو متوقف می‌شود. ترتیب پیش‌فرض \f(CW"", ".eps", ".pdf", ".pstex"\fR است (توجه داشته باشید که شامل فایل‌های بدون پسوند نیز می‌شود). در صورت استفاده از pdflatex، می‌توان با \f(CW\*(C`\-\-imgexts .pdf\*(C'\fR فرمت \s-1PDF\s0 را قبل از \s-1EPS\s0 قرار داد. نقطه پیش از پسوند را فراموش نکنید!
.IP "\fB\-\-debug\fR" 4
.IX Item "--debug"
خروجی‌های اشکال‌زدایی با جزئیات فراوان را فعال می‌کند \- زمانی که مشکلی پیش می‌آید مفید است.
.IP "\fB\-\-version\fR, \fB\-V\fR" 4
.IX Item "--version, -V"
شماره نسخه فعلی و نحوه استفاده را نمایش داده و خارج می‌شود.
.IP "\fB\-\-help\fR, \fB\-?\fR" 4
.IX Item "--help, -?"
نمایش این صفحه راهنما.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
مثال زیر \f(CW\*(C`manuscript.tex\*(C'\fR را در دایرکتوری جاری بررسی کرده و آن و تمام اجزایش را در دایرکتوری \f(CW\*(C`submit_01/\*(C'\fR جمع‌آوری می‌کند:
.PP
.Vb 1
\& $ texdirflatten \-f manuscript.tex \-o submit_01
.Ve
.SH "هشدارها (CAVEATS)"
.IX Header "CAVEATS"
لطفاً پیش از اجرای این دستور نسخه‌های پشتیبان تهیه کنید. هیچ‌گونه ضمانتی ارائه نمی‌شود.
.PP
در صورت استفاده از \f(CW\*(C`pdflatex\*(C'\fR ممکن است نیاز باشد \f(CW\*(C`epstopdf\*(C'\fR را روی فایل‌های \s-1EPS\s0 اجرا کنید:
.PP
.Vb 1
\& $ for i in *.eps; do epstopdf $i; done
.Ve
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
از ارسال گزارش‌های باگ و وصله‌ها استقبال می‌شود.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Cengiz Gunay <cengique<\s-1AT\s0>users.sf.net>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT AND LICENSE"
Copyleft 2003\-2017, Cengiz Gunay
.PP
این کتابخانه یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت همان شرایط خود Perl بازتوزیع کرده و/یا تغییر دهید.