نام (NAME)

sgml2latex - ایجاد خروجی‌های LaTeX، DVI، PostScript یا PDF از فایل مبدأ SGML با ساختار LinuxDoc DTD

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

توضیحات (DESCRIPTION)

دستور sgml2latex شکلی قدیمی و منسوخ‌شده از دستور تبدیل latex در LinuxDoc-Tools است (نام آن ممکن است گمراه‌کننده باشد، زیرا ابزاری برای هر SGML DTD نیست و تنها از LinuxDoc DTD پشتیبانی می‌کند). توصیه می‌شود اکنون به شکل جدید linuxdoc -B latex تغییر وضعیت دهید. این دستور با استفاده از تجزیه‌کننده nsgmls(1) یا onsgmls(1) و مترجم sgmlsasp(1) یک فایل مبدأ SGML بر پایه LinuxDoc DTD را به خروجی LaTeX تبدیل می‌کند. با استفاده از خروجی LaTeX و قالب‌بند متنی latex(1)، می‌توانید خروجی DVI ایجاد کنید، و خروجی PostScript را نیز با استفاده از مبدل dvips(1) بسازید. خروجی در فایل file.tex برای خروجی LaTeX، در file.dvi برای خروجی DVI، یا در file.ps برای خروجی PostScript ذخیره می‌شود؛ که در آن file نام فایل مبدأ SGML است.

با استفاده از خروجی LaTeX و قالب‌بند متنی pdflatex(1)، می‌توانید یک خروجی تمیز PDF مناسب برای مشاهده با نمایشگرهای PDF مانند xpdf(1)، acroread(1) یا ghostview(1) ایجاد نمایید.

جفت ویژگی/مقدار «output=latex2e» برای عبارت‌های شرطی تنظیم شده است.

گزینه‌ها (OPTIONS)

دستور sgml2latex تمام گزینه‌های عمومی شرح‌داده‌شده در linuxdoc(1) و گزینه‌های خاص زیر را می‌پذیرد:

--output=fmt, -o: قالب خروجی مورد نظر را مشخص می‌کند. مشخص‌کننده fmt می‌تواند «tex»، «dvi»، «ps» یا «pdf» باشد.

نکته: این نسخه فایل‌های میانی را بازنویسی یا حذف نمی‌کند: فایل tex برای خروجی dvi، یا فایل‌های tex/dvi برای خروجی ps. این رفتار با رفتار نسخه اصلی SGML-Tools 1.0.9 متفاوت است، بنابراین در اینجا به شما هشدار داده می‌شود.

--bibtex, -b: پردازش TeX تولیدشده با bibtex(1).
--makeindex, -m: تولید یک فایل نمایه TeX مناسب برای پردازش با makeindex(1) از برچسب‌های <idx> و <cdx> موجود در مبدأ SGML.
--pagenumber, -n: شماره صفحه شروع را در فایل خروجی DVI یا PS مشخص می‌کند.
--quick, -q: تنها یک دور (pass) قالب‌بندی LaTeX را انجام می‌دهد. این کار اغلب برای تولید خروجی نهایی کافی نیست (به دلیل ارجاعات و غیره)، اما برای یافتن خطاهای TeX و مشکلات ترازبندی مفید است.
--pass, -P: آرگومان گزینه pass دقیقاً بعد از پیش‌درآمد (preamble) در LaTeX که توسط برچسب نوع سند تولید شده است، درج می‌شود. قالب خروجی مورد نظر را مشخص می‌کند. مشخص‌کننده fmt می‌تواند «tex»، «dvi»، «ps» یا «pdf» باشد.
--latex=alternate_latex_command, -x: این گزینه در حال حاضر برای زبان‌های کره‌ای و ژاپنی است. مقدار alternate_latex_command می‌تواند «latex» (پیش‌فرض)، «hlatexp» (برای کره‌ای)، «platex» یا «jlatex» (برای ژاپنی) باشد. این گزینه می‌تواند برای رندر کردن اسناد کره‌ای با استفاده از HLaTeXp، یا رندر کردن اسناد ژاپنی با استفاده از pLaTeX/jLaTeX استفاده شود. در غیر این صورت، برای رندر کردن اسناد کره‌ای باید HLaTeX نصب شده باشد. از سوی دیگر، اسناد ژاپنی را می‌توان با jLaTeX رندر کرد (که در صورت مشخص شدن «-c nippon» پیش‌فرض است)، بنابراین اگر از قبل jLaTeX را دارید، نیازی به نصب pLaTeX نخواهید داشت.
--dvips=alternate_dvips_command, -s: این گزینه در حال حاضر برای زبان ژاپنی است. مقدار alternate_dvips_command می‌تواند «dvips» یا «dvi2ps» باشد. اگر با این دستورها آشنایی ندارید، احتمالاً نیازی هم به این گزینه نخواهید داشت.
--verbosity, -V: میزان پرگویی (verbosity) را تنظیم می‌کند. مقدار '0' (پیش‌فرض) اطلاعات مربوط به اجرای LaTeX را تنها در صورت بروز خطا نمایش می‌دهد. مقدار '1' همیشه اطلاعات آخرین اجرا را نمایش می‌دهد. مقدار '2' اطلاعات را برای تمام دفعات اجرا نمایش خواهد داد.
file: فایل مبدأ SGML، با نام file یا file.sgml

فایل‌ها (FILES)

فایل‌ها و برنامه‌های اجرایی متعددی در /usr/share/linuxdoc-tools و /usr/bin استفاده می‌شوند.

گزارش باگ‌ها (BUGS)

هیچ موردی شناخته نشده است.

نویسندگان (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> نگهداری می‌شود.

همچنین ببینید (SEE ALSO)

linuxdoc(1), sgml2html(1), sgml2info(1), sgml2lyx(1), sgml2rtf(1), sgml2txt(1), sgmlcheck(1).