.\" Process this file with
.\" groff -man -Tascii sgml2txt.1
.\"
.TH SGML2TXT 1 "2025-04-06"
.SH "نام (NAME)"
sgml2txt \- تولید خروجی متن ساده از فایل منبع SGML با LinuxDoc DTD
.SH "خلاصه دستور (SYNOPSIS)"
.B sgml2txt [generic-option...] [--manpage] [--filter] [--blanks=\fIn\fB]
.IR file [.sgml]
.SH "توضیحات (DESCRIPTION)"
دستور
.B sgml2txt
شکلی قدیمی و منسوخ‌شده از دستور تبدیل متن در
LinuxDoc-Tools
است
(نام آن ممکن است گمراه‌کننده باشد، چرا که ابزاری برای هر نوع SGML DTD نیست و تنها از SGML LinuxDoc DTD پشتیبانی می‌کند).
توصیه می‌شود در حال حاضر به قالب جدید
.B linuxdoc -B text
مهاجرت کنید.
این دستور یک فایل منبع SGML با LinuxDoc DTD را به خروجی‌های ASCII، ISO-8859-1 یا EUC-JP تبدیل می‌کند.
خروجی در فایل
.I file.txt
قرار خواهد گرفت که در آن
.I file
نام فایل منبع SGML است.
.LP
جفت ویژگی/مقدار "output=txt" برای گزاره‌های شرطی تنظیم شده است.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B sgml2txt
تمام گزینه‌های عمومی شرح داده شده در
.BR linuxdoc (1)
و گزینه‌های خاص زیر را می‌پذیرد:
.IP "--manpage, -m"
تولید یک فایل منبع groff، مناسب برای قالب‌بندی با
.B groff -man
جهت صفحات راهنما (man pages).
.IP "--filter, -f"
حذف کاراکترهای backspace-overstrike از قالب واسط تولید شده توسط
\fBgroff\fR(1).
.IP "--pass, -P"
آرگومان گزینه pass به گزینه‌های خط فرمانی که به
.BR groff (1)
داده می‌شوند اضافه می‌گردد.
.IP "--blanks=\fIn\fR, -b"
تنظیم محدودیت خطوط خالی متوالی برای تولید سند خروجی.
محدودیت پیش‌فرض ۳ است.
اگر ۰ (صفر) مشخص شود،
نتیجه شامل خطوط خالی متوالی بسیاری خواهد بود.
.IP file
فایل منبع SGML، که با نام
.I file
یا
.I file.sgml
مشخص می‌شود.
.SH "فایل‌ها (FILES)"
فایل‌ها و برنامه‌های اجرایی متعددی در /usr/share/linuxdoc-tools استفاده می‌شوند.
.SH "گزارش باگ‌ها (BUGS)"
هیچ باگ شناخته‌شده‌ای وجود ندارد.
.SH "نویسندگان (AUTHORS)"
در ابتدا توسط Greg Hankins <greg.hankins@cc.gatech.edu> بر پایه اسکریپت‌هایی از Tom Gordon و Alexander Horz نوشته شد و بعداً توسط Cees de Groot <cg@cdegroot.com> برای SGML-Tools (نسخه ۱) بازنویسی گردید.
پیش‌تر توسط 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 sgml2latex (1),
.BR sgml2lyx (1),
.BR sgml2rtf (1),
.BR sgmlcheck (1).