.\" Process this file with
.\" groff -man -Tascii sgml2latex.1
.\"
.TH SGML2LATEX 1 "2025-04-06"
.SH "نام (NAME)"
sgml2latex \- ایجاد خروجی‌های LaTeX، DVI، PostScript یا PDF از فایل مبدأ SGML با ساختار LinuxDoc DTD
.SH "خلاصه دستور (SYNOPSIS)"
.B sgml2latex [generic-option...]
.BI [--output= tex | dvi | ps | pdf]
.B [--bibtex] [--makeindex]
.BI [--pagenumber= n ]
.B --quick
.BI [--latex= hlatexp | platex]
.BI [--dvips= dvips | dvi2ps]
.BI [--verbosity=n]
.IR file [.sgml]
.SH "توضیحات (DESCRIPTION)"
دستور
.B sgml2latex
شکلی قدیمی و منسوخ‌شده از دستور تبدیل latex در
LinuxDoc-Tools
است
(نام آن ممکن است گمراه‌کننده باشد، زیرا ابزاری برای هر SGML DTD نیست و تنها از LinuxDoc DTD پشتیبانی می‌کند).
توصیه می‌شود اکنون به شکل جدید
.B linuxdoc -B latex
تغییر وضعیت دهید.
این دستور با استفاده از تجزیه‌کننده
.BR nsgmls (1)
یا
.BR onsgmls (1)
و مترجم
.BR sgmlsasp (1)
یک فایل مبدأ SGML بر پایه LinuxDoc DTD را به خروجی LaTeX تبدیل می‌کند. با استفاده از خروجی LaTeX و قالب‌بند متنی
.BR latex (1)،
می‌توانید خروجی DVI ایجاد کنید، و خروجی PostScript را نیز با استفاده از مبدل
.BR dvips (1)
بسازید. خروجی در فایل
.I file.tex
برای خروجی LaTeX، در
.I file.dvi
برای خروجی DVI، یا در
.I file.ps
برای خروجی PostScript ذخیره می‌شود؛ که در آن
.I file
نام فایل مبدأ SGML است.
.LP
با استفاده از خروجی LaTeX و قالب‌بند متنی
.BR pdflatex (1)،
می‌توانید یک خروجی تمیز PDF مناسب برای مشاهده با نمایشگرهای PDF مانند
.BR xpdf (1)،
.BR acroread (1)
یا
.BR ghostview (1)
ایجاد نمایید.
.LP
جفت ویژگی/مقدار «output=latex2e» برای عبارت‌های شرطی تنظیم شده است.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B sgml2latex
تمام گزینه‌های عمومی شرح‌داده‌شده در
.BR linuxdoc (1)
و گزینه‌های خاص زیر را می‌پذیرد:
.IP "--output=\fIfmt\fR, -o"
قالب خروجی مورد نظر را مشخص می‌کند. مشخص‌کننده
.I fmt
می‌تواند «tex»، «dvi»، «ps» یا «pdf» باشد.
.PP
نکته: این نسخه فایل‌های میانی را بازنویسی یا حذف نمی‌کند: فایل tex برای خروجی dvi، یا فایل‌های tex/dvi برای خروجی ps.
این رفتار با رفتار نسخه اصلی SGML-Tools 1.0.9 متفاوت است، بنابراین در اینجا به شما هشدار داده می‌شود.
.IP "--bibtex, -b"
پردازش TeX تولیدشده با
.BR bibtex (1).
.IP "--makeindex, -m"
تولید یک فایل نمایه TeX مناسب برای پردازش با
.BR makeindex (1)
از برچسب‌های <idx> و <cdx> موجود در مبدأ SGML.
.IP "--pagenumber, -n"
شماره صفحه شروع را در فایل خروجی DVI یا PS مشخص می‌کند.
.IP "--quick, -q"
تنها یک دور (pass) قالب‌بندی LaTeX را انجام می‌دهد.
این کار اغلب برای تولید خروجی نهایی کافی نیست (به دلیل ارجاعات و غیره)، اما برای یافتن خطاهای TeX و مشکلات ترازبندی مفید است.
.IP "--pass, -P"
آرگومان گزینه pass دقیقاً بعد از پیش‌درآمد (preamble) در LaTeX که توسط برچسب نوع سند تولید شده است، درج می‌شود.
قالب خروجی مورد نظر را مشخص می‌کند.
مشخص‌کننده
.I fmt
می‌تواند «tex»، «dvi»، «ps» یا «pdf» باشد.
.IP "--latex=\fIalternate_latex_command\fR, -x"
این گزینه در حال حاضر برای زبان‌های کره‌ای و ژاپنی است.
مقدار
.I alternate_latex_command
می‌تواند «latex» (پیش‌فرض)، «hlatexp» (برای کره‌ای)، «platex»
یا «jlatex» (برای ژاپنی) باشد.
این گزینه می‌تواند برای رندر کردن اسناد کره‌ای با استفاده از HLaTeXp،
یا رندر کردن اسناد ژاپنی با استفاده از pLaTeX/jLaTeX استفاده شود.
در غیر این صورت، برای رندر کردن اسناد کره‌ای باید HLaTeX نصب شده باشد.
از سوی دیگر، اسناد ژاپنی را می‌توان با jLaTeX رندر کرد
(که در صورت مشخص شدن «\-c nippon» پیش‌فرض است)، بنابراین اگر از قبل jLaTeX را دارید، نیازی به نصب pLaTeX نخواهید داشت.
.IP "--dvips=\fIalternate_dvips_command\fR, -s"
این گزینه در حال حاضر برای زبان ژاپنی است.
مقدار
.I alternate_dvips_command
می‌تواند «dvips» یا «dvi2ps» باشد.
اگر با این دستورها آشنایی ندارید، احتمالاً نیازی هم به این گزینه نخواهید داشت.
.IP "--verbosity, -V"
میزان پرگویی (verbosity) را تنظیم می‌کند.
مقدار \[aq]0\[aq] (پیش‌فرض) اطلاعات مربوط به اجرای LaTeX را تنها در صورت بروز خطا نمایش می‌دهد.
مقدار \[aq]1\[aq] همیشه اطلاعات آخرین اجرا را نمایش می‌دهد.
مقدار \[aq]2\[aq] اطلاعات را برای تمام دفعات اجرا نمایش خواهد داد.
.IP file
فایل مبدأ SGML، با نام
.I file
یا
.I file.sgml
.SH "فایل‌ها (FILES)"
فایل‌ها و برنامه‌های اجرایی متعددی در /usr/share/linuxdoc-tools و /usr/bin استفاده می‌شوند.
.SH "گزارش باگ‌ها (BUGS)"
هیچ موردی شناخته نشده است.
.SH "نویسندگان (AUTHORS)"
در ابتدا توسط
Greg Hankins <greg.hankins@cc.gatech.edu>
بر پایه اسکریپت‌هایی از Tom Gordon و Alexander Horz نوشته شد.
سپس توسط Cees de Groot <cg@cdegroot.com> بازنویسی شد.
وصله‌های مربوط به PDF توسط Juan Jose Amor <jjamor@hispalinux.es>.
قبلاً توسط Taketoshi Sano <sano@debian.org> برای Linuxdoc-Tools نگهداری می‌شد.
در حال حاضر توسط Agustin Martin <agustin6martin AT gmail com> نگهداری می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR linuxdoc (1),
.BR sgml2html (1),
.BR sgml2info (1),
.BR sgml2lyx (1),
.BR sgml2rtf (1),
.BR sgml2txt (1),
.BR sgmlcheck (1).