.\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH sgml2xml-isoent 1 "3 March 2007" "docbook2X 0.8.8" docbook2X
.SH "نام (NAME)"
sgml2xml-isoent \- تبدیل SGML به XML با پشتیبانی از موجودیت‌های ISO
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBsgml2xml-isoent\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fIsgml-document\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور
\fBsgml2xml-isoent\fR
یک سند SGML را با پشتیبانی از موجودیت‌های ISO به XML تبدیل می‌کند.
این کار با استفاده از
\fBsgml2xml\fR(1)
از بسته SP (یا
\fBosx\fR(1)
از بسته OpenSP) انجام شده و تعریف نسخه XML موجودیت‌های ISO به خروجی اضافه می‌شود.
این بدان معناست که خروجی این تبدیل باید به‌طور مستقیم با هر ابزار XML کار کند.
.PP
این برنامه معمولاً برای پردازش اسناد SGML DocBook با ابزارهای مبتنی بر XML استفاده می‌شود. به‌ویژه،
\fBdb2x_xsltproc\fR(1)
این برنامه را به عنوان بخشی از گزینه
\*(T<\fB\-\-sgml\fR\*(T>
خود فراخوانی می‌کند. از سوی دیگر، این ابزار احتمالاً برای انتقال یک فایل متنی منبع SGML به XML چندان مفید نیست، زیرا فرآیند تبدیل ساختار قالب‌بندی اصلی را دگرگون می‌سازد.
.PP
از آنجا که به نسخه XML موجودیت‌های ISO مستقیماً و نه از طریق DTD ارجاع داده می‌شود، این ابزار با انواع دیگر اسناد غیر از DocBook نیز کار می‌کند.
.SH "نکات (NOTES)"
موجودیت‌های ISO با استفاده از شناسه‌های عمومی
\*(T<ISO 8879:1986//ENTITIES//\fI\&...\fR//EN//XML\*(T>
ارجاع داده می‌شوند.
کاتالوگ‌های مورد استفاده هنگام تحلیل سند تبدیل‌شده باید این موجودیت‌ها را به مسیر مناسب (روی فایل‌سیستم محلی) نگاشت کنند. اگر موجودیت‌ها در کاتالوگ پیدا نشوند، راهکار جایگزین دریافت فایل‌های موجودیت از وب‌سایت
\*(T<http://www.docbook.org\*(T>
خواهد بود.
.SH "نویسنده (AUTHOR)"
Steve Cheng <\*(T<stevecheng@users.sourceforge.net\*(T>>.
.SH "همچنین ببینید (SEE ALSO)"
\fBsgml2xml\fR(1),
\fBosx\fR(1)