.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "ARLATEX 1"
.TH ARLATEX 1 2025-02-26 v1.1 "User Commands"
.\" 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)"
arlatex \- بسته‌بندی فایل‌های متنی و اسناد چندبخشی LaTeX در یک فایل واحد
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
arlatex
[\fB\-\-outfile\fR=\fIfilename\fR\fI.tex\fR]
\&\fB\-\-document\fR=\fIfilename\fR\fI.tex\fR
\&\fIfilename\fR
\&...
.PP
arlatex
\&\fB\-\-version\fR
.PP
arlatex
\&\fB\-\-help\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \fBarlatex\fR برنامه‌ای برای آرشیو کردن و بسته‌بندی فایل‌ها مانند \fBshar\fR، \fBtar\fR، \fBzip\fR و غیره است. با این حال، بر خلاف سایر برنامه‌های آرشیو، \fBarlatex\fR به طور ویژه برای استفاده با لایتک (LaTeX) طراحی شده است. \fBarlatex\fR نام فایل اصلی \fI.tex\fR و تعدادی فایل کمکی استفاده‌شده توسط آن فایل اصلی (مانند فایل‌های \fI.tex\fR، \fI.sty\fR، \fI.cls\fR و \fI.eps\fR) را دریافت می‌کند. از این فایل‌ها، \fBarlatex\fR یک فایل واحد تولید می‌کند که با اجرا شدن توسط \fBlatex\fR، هم فایل‌های کمکی را بازسازی می‌کند و هم سند را در قالب یک فایل \fI.dvi\fR کامپایل می‌نماید.
.PP
برنامه \fBarlatex\fR چندین مزیت نسبت به سایر برنامه‌های فشرده‌سازی و آرشیو دارد:
.IP \(bu 4
فایل‌های \fI.tex\fR تولیدشده توسط \fBarlatex\fR در قالب متن ساده (plain-text) هستند؛ بنابراین کاملاً قابل‌حمل بوده و ارسال آن‌ها با ایمیل به همکاران بسیار آسان است.
.IP \(bu 4
ابزار \fBarlatex\fR برای اجرا تنها به LaTeX نیاز دارد و هیچ وابستگی به ابزارهای خارجی دیگر ندارد.
.IP \(bu 4
هیچ مرحله استخراج جداگانه‌ای وجود ندارد. زمانی که سند تولیدشده توسط \fBlatex\fR اجرا می‌شود، فایل‌های کمکی را استخراج کرده و سند را در همان مرحله می‌سازد. کاربری که \fBlatex\fR را اجرا می‌کند حتی متوجه تولید شدن فایل‌های جانبی اضافی نخواهد شد.
.PP
نحوه کار \fBarlatex\fR به این صورت است که تعدادی بلوک \f(CW\*(C`\ebegin{filecontents*}\*(C'\fR\ ...\ \&\f(CW\*(C`\eend{filecontents*}\*(C'\fR را به همراه محتویات فایل اصلی در فایل خروجی می‌نویسد. (در واقع، هرگونه کامنت لایتک در ابتدای فایل اصلی به بالای فایل تولیدشده منتقل می‌شود. این امر به نویسنده اجازه می‌دهد تا در صورت تمایل، توجه را به این نکته جلب کند که فایل‌های کمکی تولید خواهند شد.) محیط \f(CW\*(C`filecontents*\*(C'\fR که بخشی از استاندارد LaTeX2e است، محتویات خود را عیناً (verbatim) در یک فایل مشخص می‌نویسد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش شماره نسخه اسکریپت \fBarlatex\fR.
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش اطلاعات خلاصه نحوه استفاده از \fBarlatex\fR.
.IP "\fB\-\-document\fR=\fI.tex file\fR" 4
.IX Item "--document=.tex file"
مشخص کردن سند اصلی. خروجی \fBarlatex\fR همین فایل خواهد بود که تمام فایل‌های دیگر نام‌برده‌شده در خط فرمان به ابتدای آن اضافه شده‌اند. توجه داشته باشید که \f(CW\*(C`\-\-document\*(C'\fR یک پارامتر \fIاجباری\fR است؛ در صورت مشخص نشدن \f(CW\*(C`\-\-document\*(C'\fR، برنامه \fBarlatex\fR با یک پیام خطا متوقف می‌شود.
.IP "\fB\-\-outfile\fR=\fI.tex file\fR" 4
.IX Item "--outfile=.tex file"
مشخص کردن فایل خروجی. فایل خروجی کاملاً شبیه به سند اصلی است، اما تعدادی محیط \f(CW\*(C`filecontents*\*(C'\fR پیش از خط \f(CW\*(C`\edocumentclass\*(C'\fR در آن قرار گرفته است. اگر \f(CW\*(C`\-\-outfile\*(C'\fR مشخص نشود، خروجی در خروجی استاندارد (stdout) نوشته خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
فرض کنید مقاله‌ای به نام \fIpaper.tex\fR دارید که یک بسته سفارشی را با \f(CW\*(C`\eusepackage{mypackage}\*(C'\fR بارگذاری می‌کند. می‌خواهید مقاله را به یک کنفرانس ارسال کنید، اما می‌خواهید کاملاً مطمئن شوید که با دست‌به‌دست شدن مقاله بین افراد، فایل \fImypackage.sty\fR گم نمی‌شود. در ادامه نحوه استفاده از \fBarlatex\fR آمده است:
.PP
.Vb 1
\&    arlatex \-\-document=paper.tex mypackage.sty \-\-outfile=paper\-submit.tex
.Ve
.PP
هنگامی که \fIpaper\-submit.tex\fR با \fBlatex\fR پردازش می‌شود، دقیقاً مانند فایل اصلی \fIpaper.tex\fR ساخته می‌شود، با این تفاوت که علاوه بر آن یک فایل \fImypackage.sty\fR را نیز در پوشه جاری ایجاد می‌کند:
.PP
.Vb 5
\&    This is TeX, Version 3.14159 (Web2C 7.3.1)
\&    (paper\-submit.tex
\&    LaTeX2e <1999/12/01> patch level 1
\&    Babel <v3.6Z> and hyphenation patterns for american, french, german,
\&    ngerman, italian, nohyphenation, loaded.
\&
\&    LaTeX Warning: Writing file \`./mypackage.sty\*(Aq.
\&
\&    (/usr/share/texmf/tex/latex/base/article.cls
\&    Document Class: article 1999/09/10 v1.4a Standard LaTeX document class
\&    (/usr/share/texmf/tex/latex/base/size12.clo)) (mypackage.sty)
\&                                  .
\&                                  .
\&                                  .
.Ve
.PP
به عنوان مثالی دیگر، در ادامه نحوه بسته‌بندی تمام فایل‌های مورد نیاز برای ساخت یک سند بزرگ جهت نگهداری طولانی‌مدت آمده است:
.PP
.Vb 4
\&    arlatex \-\-document=thesis.tex abstract.tex introduction.tex
\&      background.tex approach.tex experiments.tex relatedwork.tex
\&      conclusions.tex before.eps after.eps fast.eps slow.eps
\&      podunkUthesis.cls \-\-outfile=thesis\-all.tex
.Ve
.PP
با افزایش تعداد فایل‌هایی که باید با هم آرشیو شوند، اجرای دستی \fBarlatex\fR دشوارتر می‌شود. خوشبختانه استفاده از \fBarlatex\fR همراه با \fBbundledoc\fR بسیار ساده است. ابزار \fBbundledoc\fR تمام فایل‌های مورد نیاز برای ساخت سند را پیدا می‌کند و \fBarlatex\fR آن‌ها را در یک فایل واحد ترکیب می‌نماید. موارد زیر نمونه‌هایی از خط \f(CW\*(C`bundle:\*(C'\fR هستند که می‌توانید در فایل پیکربندی \fBbundledoc\fR استفاده کنید:
.IP Unix: 1
.IX Item "Unix:"
.Vb 2
\&   bundle: (arlatex \-\-document=$BDBASE.tex $BDINPUTS \e
\&     \-\-outfile=$BDBASE\-all.tex)
.Ve
.IP Windows: 1
.IX Item "Windows:"
.Vb 2
\&   bundle: arlatex \-\-document=%BDBASE%.tex %BDINPUTS% \e
\&     \-\-outfile=%BDBASE%\-all.tex
.Ve
.PP
برای اطلاعات بیشتر به مستندات \fBbundledoc\fR مراجعه کنید.
.SH "هشدارها (CAVEATS)"
.IX Header "CAVEATS"
برنامه \fBarlatex\fR از محیط \f(CW\*(C`filecontents*\*(C'\fR در LaTeX استفاده می‌کند. این برنامه گزینه \f(CW\*(C`overwrite\*(C'\fR را به \f(CW\*(C`filecontents*\*(C'\fR ارسال می‌کند تا نشان دهد فایل‌های موجود با همان نام باید بازنویسی (overwrite) شوند. توجه داشته باشید که ساخت فایل تولیدشده، فایل‌هایی را که برای ایجاد آن استفاده شده‌اند بازنویسی خواهد کرد.
.PP
بهتر است از بسته‌بندی فایل‌های باینری (مانند تصاویر گرافیکی گنجانده‌شده) با \fBarlatex\fR خودداری شود؛ چرا که این فایل‌ها معمولاً به درستی استخراج نمی‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBbundledoc\fR\|(1), \fBlatex\fR\|(1), \fBshar\fR\|(1), \fBtar\fR\|(1), \fBzip\fR\|(1)
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
Scott Pakin, \fIscott+bdoc@pakin.org\fR