نام (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).