.\" Process this file with
.\" groff -man -Tascii sgml2html.1
.\"
.TH SGML2HTML 1 "2025-04-06"
.SH "نام (NAME)"
sgml2html \- ایجاد خروجی HTML از یک فایل منبع SGML با LinuxDoc DTD
.SH "خلاصه دستور (SYNOPSIS)"
.B sgml2html [generic-option...] [--split
.I 0|1|2
.B ] [--toc
.I 0|1|2
.B ] [--dosnames] [--imagebuttons]
.IR file [.sgml]
.SH "توضیحات (DESCRIPTION)"
دستور
.B sgml2html
یک قالب قدیمی و منسوخ از دستور تبدیل html در
LinuxDoc-Tools
است (نام آن ممکن است گمراه‌کننده باشد، زیرا ابزاری برای هر نوع SGML DTD نیست و تنها از SGML LinuxDoc DTD پشتیبانی می‌کند).
توصیه می‌شود که اکنون به فرم جدید
.B linuxdoc -B html
مهاجرت کنید.
این ابزار یک فایل منبع SGML با LinuxDoc DTD را به خروجی HTML تبدیل می‌کند.
خروجی در فایل سطح بالای
.I file.html
و برای هر بخش در
.I file-n.html
قرار می‌گیرد، که در آن
.I file
نام فایل منبع SGML و
.I n
نام بخش است.
.LP
جفت مشخصه/مقدار "output=html" برای عبارت‌های شرطی تنظیم شده است.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B sgml2html
تمام گزینه‌های عمومی شرح‌داده‌شده در
.BR linuxdoc (1)
و گزینه‌های اختصاصی زیر را می‌پذیرد:
.IP "--split, -s"
سطحی که اسناد منبع بر اساس آن تقسیم می‌شوند.
۰ = بدون تقسیم، ۱ = تقسیم بر اساس بخش‌های اصلی، ۲ = تقسیم بر اساس زیربخش‌ها.
.IP "--toc, -T"
سطح تولید فهرست مطالب (TOC).
  ۰ = عدم تولید فهرست مطالب،
  ۱ = شامل بخش‌های اصلی (/فصل‌ها/قسمت‌ها)،
  ۲ = شامل زیربخش‌ها.
.IP "--dosnames, -h"
استفاده از ".htm" به جای ".html" به عنوان پسوند فایل‌ها.
.IP "--imagebuttons, -I"
استفاده از آیکون‌های تصویری پیکان "next" ،"previous" و "contents" موجود در /usr/share/linuxdoc-tools به عنوان دکمه‌های ناوبری.
.IP "--footer, -F"
استفاده از فایل مشخص‌شده به عنوان پاورقی (footer) در هر فایل html حاصل.
پاورقی پیش‌فرض به شکل ساده زیر است:

.nh
.nf
.ad l
 </BODY>\\n </HTML>\\n
.hy
.fi
.IP "--header, -H"
استفاده از فایل مشخص‌شده به عنوان بخش بالایی سربرگ (header) در هر فایل html حاصل.
توجه داشته باشید که این بخش شامل تمام سربرگ نیست؛ یعنی عنوان و پیوندهای (next,previous,contents) موجود در سربرگ پیش‌فرض حفظ می‌شوند.
مقدار پیش‌فرض عبارت است از:

.nh
.nf
.ad l
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\\n
 <HTML>\\n <HEAD>\\n
.hy
.fi
.IP file
فایل منبع SGML، با نام
.I file
یا
.IR file.sgml .
.SH "فایل‌ها (FILES)"
فایل‌ها و برنامه‌های اجرایی متعددی در /usr/share/linuxdoc-tools و /usr/bin استفاده می‌شوند.
.SH "اشکالات (BUGS)"
هیچ موردی شناخته نشده است.
.SH "نویسندگان (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> نگهداری می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR linuxdoc (1),
.BR sgml2info (1),
.BR sgml2latex (1),
.BR sgml2lyx (1),
.BR sgml2rtf (1),
.BR sgml2txt (1),
.BR sgmlcheck (1).