'\" t
.\"     Title: osgmlnorm
.\"    Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: January 2002
.\"    Manual: Reference
.\"    Source: OpenJade
.\"  Language: Persian
.\"
.TH "OSGMLNORM" "1" "January 2002" "OpenJade" "Reference"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
osgmlnorm \- یک نرمال‌ساز و استانداردساز سندهای SGML/XML
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBosgmlnorm\fR\ 'u
\fBosgmlnorm\fR [\fB\-CdeghmnrRvx\fR] [\fB\-a\fR\fB\fIlinktype\fR\fR] [\fB\-A\fR\fB\fIarchitecture\fR\fR] [\fB\-b\fR\fB\fIbctf\fR\fR] [\fB\-c\fR\fB\fIcatalog\fR\fR] [\fB\-D\fR\fB\fIdirectory\fR\fR...] [\fB\-E\fR\fB\fImax_errors\fR\fR...] [\fB\-i\fR\fB\fIname\fR\fR...] [\fB\-f\fR\fB\fIname\fR\fR...] [\fB\-w\fR\fB\fIwarning\fR\fR...] [\fIsysid\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBosgmlnorm\fR
یک نمونه سند نرمال‌شده (استانداردسازی‌شده) را برای سند SGML موجود در الحاق موجودیت‌هایی با شناسه‌های سیستمی
.HP \w'\ 'u [\fIsysid\fR...]
در خروجی استاندارد چاپ می‌کند\&.
.PP
هنگامی که اعلان اصلی SGML و پیش‌درآمد (prolog) به ابتدای نمونه سند نرمال‌شده افزوده شوند، ESIS آن با سند اصلی SGML یکسان خواهد بود، به استثنای موارد زیر:
.PP
* خروجی osgmlnorm در برابر شناسایی جداکننده‌های ارجاع کوتاه (short reference delimiters) محافظت نمی‌کند، بنابراین هرگونه اعلان USEMAP باید از DTD حذف شود\&.
.PP
* نمونه سند نرمال‌شده از جداکننده‌های ارجاع مرجع استفاده خواهد کرد، حتی اگر نمونه سند اصلی از آن‌ها استفاده نکرده باشد\&.
.PP
* اگر با استفاده از گزینه
.B \-m
بخش‌های علامت‌گذاری‌شده در خروجی گنجانده شوند، برای کلیدواژه‌های وضعیت از نام‌های رزروشده مرجع استفاده خواهد شد حتی اگر نمونه سند اصلی چنین نکرده باشد\&.
.PP
* هرگونه اطلاعات ESIS مربوط به ویژگی SGML LINK از دست خواهد رفت\&.
.PP
نمونه سند نرمال‌شده از هیچ‌یک از ویژگی‌های کمینه‌سازی نشانه‌گذاری استفاده نخواهد کرد، مگر در موارد زیر:
.PP
* هرگونه صفتی که در نمونه سند اصلی مشخص نشده باشد، در نمونه سند نرمال‌شده گنجانده نخواهد شد\&. (صفات جاری گنجانده خواهند شد\&.)
.PP
* اگر مقدار اعلان‌شده یک صفت یک گروه نشانه نام (name token group) باشد و مقداری مشخص شده باشد که همان نام صفت است، نام صفت و نشانگر مقدار حذف خواهند شد\&. برای مثال، در HTML دستور osgmlnorm خروجی <DL COMPACT> را به جای <DL COMPACT="COMPACT"> تولید می‌کند\&.
.PP
بخشی از یک سیستم SGML منطبق بر استاندارد بین‌المللی ISO 8879 \-\- زبان نشانه‌گذاری تعمیم‌یافته استاندارد (SGML)\&. یک سیستم امکانات گسترش‌یافته SGML منطبق بر پیوست A از استاندارد بین‌المللی ISO/IEC 10744 \-\- زبان ساختاردهی ابررسانه‌ای/مبتنی بر زمان (HyTime)\&.
.PP
گزینه‌های زیر در دسترس هستند:
.PP
\fB\-a\fR\fB\fIname\fR\fR, \fB\-\-activate=\fR\fB\fIname\fR\fR
.RS 4
فعال کردن doctype یا linktype با نام
\fIname\fR\&.
.RE
.PP
\fB\-A\fR\fB\fIarchitecture\fR\fR, \fB\-\-architecture=\fR\fB\fIarchitecture\fR\fR
.RS 4
تجزیه با در نظر گرفتن معماری
\fIarchitecture\fR\&.
.RE
.PP
\fB\-b\fR\fB\fIbctf\fR\fR, \fB\-\-bctf=\fR\fB\fIbctf\fR\fR
.RS 4
استفاده از BCTF با نام
\fIbctf\fR
برای خروجی\&.
.RE
.PP
\fB\-c\fR\fB\fIsysid\fR\fR, \fB\-\-catalog=\fR\fB\fIsysid\fR\fR
.RS 4
نگاشت شناسه‌های عمومی و نام‌های موجودیت به شناسه‌های سیستمی با استفاده از فایل ورودی کاتالوگ با شناسه سیستمی
\fIsysid\fR\&.
.RE
.PP
\fB\-C\fR, \fB\-\-catalogs\fR
.RS 4
این گزینه همان عملکرد موجود در
\fBonsgmls(1)\fR
را دارد\&.
.RE
.PP
\fB\-d\fR, \fB\-\-dtd\fR
.RS 4
چاپ یک اعلان نوع سند (document type declaration) با همان شناسه خارجی سند ورودی و بدون زیرمجموعه اعلان داخلی (internal declaration subset)\&. هیچ بررسی مبنی بر معتبر بودن نمونه سند با توجه به این DTD انجام نمی‌شود\&.
.RE
.PP
\fB\-D\fR\fB\fIdirectory\fR\fR, \fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
جستجوی پوشه
\fIdirectory\fR
برای فایل‌های مشخص‌شده در شناسه‌های سیستمی\&.
.sp
این گزینه همان عملکرد موجود در
\fBonsgmls(1)\fR
را دارد\&.
.RE
.PP
\fB\-e\fR, \fB\-\-open\-entities\fR
.RS 4
شرح موجودیت‌های باز در پیام‌های خطا\&.
.RE
.PP
\fB\-\-error\-numbers\fR
.RS 4
نمایش شماره خطاها در پیام‌های خطا\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش متن راهنما و خروج\&.
.RE
.PP
\fB\-i\fR\fB\fIname\fR\fR, \fB\-\-include=\fR\fB\fIname\fR\fR
.RS 4
این گزینه همان عملکرد موجود در
\fBonsgmls(1)\fR
را دارد\&.
.RE
.PP
\fB\-m\fR, \fB\-\-marked\-sections\fR
.RS 4
چاپ بخش‌های علامت‌گذاری‌شده (marked sections) موجود در نمونه سند ورودی در خروجی\&.
.RE
.PP
\fB\-n\fR, \fB\-\-comments\fR
.RS 4
چاپ تمام یادداشت‌ها و توضیحات (کامنت‌های) موجود در نمونه سند ورودی در خروجی\&.
.RE
.PP
\fB\-r\fR, \fB\-\-raw\fR
.RS 4
خروجی خام\&. عدم انجام هرگونه تبدیل روی RSها و REها هنگام چاپ موجودیت\&. موجودیت معمولاً ویژگی مدیریت ذخیره‌سازی records=asis را خواهد داشت\&.
.RE
.PP
\fB\-R\fR, \fB\-\-restricted\fR
.RS 4
این گزینه همان عملکرد موجود در
\fBonsgmls(1)\fR
را دارد\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
چاپ شماره نسخه برنامه\&.
.RE
.PP
\fB\-w\fR\fB\fItype\fR\fR
.RS 4
کنترل هشدارها و خطاها با توجه به نوع (type)\&. این گزینه همان عملکرد موجود در
\fBonsgmls(1)\fR
را دارد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBonsgmls(1)\fR,
\fBospam(1)\fR,
\fBospent(1)\fR,
\fBosx(1)\fR
.SH "نویسندگان (AUTHORS)"
.PP
\fBJames Clark\fR
.RS 4
نویسنده.
.RE
.PP
\fBIan Castle\fR <\&ian.castle@openjade.org\&>
.RS 4
نویسنده.
.RE
.SH "حق نشر (COPYRIGHT)"
.br