SGML2HTML(1)                General Commands Manual               SGML2HTML(1)

نام (NAME)
       sgml2html - ایجاد خروجی HTML از یک فایل منبع SGML با LinuxDoc DTD

خلاصه دستور (SYNOPSIS)
       sgml2html [generic-option...] [--split 0|1|2 ] [--toc 0|1|2 ]
       [--dosnames] [--imagebuttons] file[.sgml]

توضیحات (DESCRIPTION)
       دستور sgml2html یک قالب قدیمی و منسوخ از دستور تبدیل html در LinuxDoc-
       Tools است (نام آن ممکن است گمراه‌کننده باشد، زیرا ابزاری برای هر نوع
       SGML DTD نیست و تنها از SGML LinuxDoc DTD پشتیبانی می‌کند).  توصیه می‌شود
       که اکنون به فرم جدید linuxdoc -B html مهاجرت کنید.  این ابزار یک فایل
       منبع SGML با LinuxDoc DTD را به خروجی HTML تبدیل می‌کند.  خروجی در فایل
       سطح بالای file.html و برای هر بخش در file-n.html قرار می‌گیرد، که در آن
       file نام فایل منبع SGML و n نام بخش است.

       جفت مشخصه/مقدار "output=html" برای عبارت‌های شرطی تنظیم شده است.

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

       --split, -s
              سطحی که اسناد منبع بر اساس آن تقسیم می‌شوند.  ۰ = بدون تقسیم، ۱ =
              تقسیم بر اساس بخش‌های اصلی، ۲ = تقسیم بر اساس زیربخش‌ها.

       --toc, -T
              سطح تولید فهرست مطالب (TOC).
                ۰ = عدم تولید فهرست مطالب،
                ۱ = شامل بخش‌های اصلی (/فصل‌ها/قسمت‌ها)،
                ۲ = شامل زیربخش‌ها.

       --dosnames, -h
              استفاده از ".htm" به جای ".html" به عنوان پسوند فایل‌ها.

       --imagebuttons, -I
              استفاده از آیکون‌های تصویری پیکان "next" ،"previous" و "contents"
              موجود در /usr/share/linuxdoc-tools به عنوان دکمه‌های ناوبری.

       --footer, -F
              استفاده از فایل مشخص‌شده به عنوان پاورقی (footer) در هر فایل html
              حاصل.  پاورقی پیش‌فرض به شکل ساده زیر است:

               </BODY>\n </HTML>\n

       --header, -H
              استفاده از فایل مشخص‌شده به عنوان بخش بالایی سربرگ (header) در هر
              فایل html حاصل.  توجه داشته باشید که این بخش شامل تمام سربرگ
              نیست؛ یعنی عنوان و پیوندهای (next,previous,contents) موجود در
              سربرگ پیش‌فرض حفظ می‌شوند.  مقدار پیش‌فرض عبارت است از:

               <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\n
               <HTML>\n <HEAD>\n

       file   فایل منبع SGML، با نام file یا file.sgml.

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

اشکالات (BUGS)
       هیچ موردی شناخته نشده است.

نویسندگان (AUTHORS)
       در ابتدا توسط Greg Hankins <greg.hankins@cc.gatech.edu> و Cees de Groot
       <cg@cdegroot.com> برای SGML-Tools (v1) نوشته شده و توسط Taketoshi Sano
       <sano@debian.org> برای Linuxdoc-Tools نگهداری شده است.  در حال حاضر
       توسط Agustin Martin <agustin6martin AT gmail com> نگهداری می‌شود.

همچنین ببینید (SEE ALSO)
       linuxdoc(1), sgml2info(1), sgml2latex(1), sgml2lyx(1), sgml2rtf(1),
       sgml2txt(1), sgmlcheck(1).

                                  2025-04-06                      SGML2HTML(1)