OSGMLNORM(1) Reference OSGMLNORM(1)

osgmlnorm - یک نرمال‌ساز و استانداردساز سندهای SGML/XML

osgmlnorm [-CdeghmnrRvx] [-alinktype] [-Aarchitecture] [-bbctf] [-ccatalog] [-Ddirectory...] [-Emax_errors...] [-iname...] [-fname...] [-wwarning...] [sysid...]

دستور osgmlnorm یک نمونه سند نرمال‌شده (استانداردسازی‌شده) را برای سند SGML موجود در الحاق موجودیت‌هایی با شناسه‌های سیستمی

در خروجی استاندارد چاپ می‌کند.

هنگامی که اعلان اصلی SGML و پیش‌درآمد (prolog) به ابتدای نمونه سند نرمال‌شده افزوده شوند، ESIS آن با سند اصلی SGML یکسان خواهد بود، به استثنای موارد زیر:

* خروجی osgmlnorm در برابر شناسایی جداکننده‌های ارجاع کوتاه (short reference delimiters) محافظت نمی‌کند، بنابراین هرگونه اعلان USEMAP باید از DTD حذف شود.

* نمونه سند نرمال‌شده از جداکننده‌های ارجاع مرجع استفاده خواهد کرد، حتی اگر نمونه سند اصلی از آن‌ها استفاده نکرده باشد.

* اگر با استفاده از گزینه -m بخش‌های علامت‌گذاری‌شده در خروجی گنجانده شوند، برای کلیدواژه‌های وضعیت از نام‌های رزروشده مرجع استفاده خواهد شد حتی اگر نمونه سند اصلی چنین نکرده باشد.

* هرگونه اطلاعات ESIS مربوط به ویژگی SGML LINK از دست خواهد رفت.

نمونه سند نرمال‌شده از هیچ‌یک از ویژگی‌های کمینه‌سازی نشانه‌گذاری استفاده نخواهد کرد، مگر در موارد زیر:

* هرگونه صفتی که در نمونه سند اصلی مشخص نشده باشد، در نمونه سند نرمال‌شده گنجانده نخواهد شد. (صفات جاری گنجانده خواهند شد.)

* اگر مقدار اعلان‌شده یک صفت یک گروه نشانه نام (name token group) باشد و مقداری مشخص شده باشد که همان نام صفت است، نام صفت و نشانگر مقدار حذف خواهند شد. برای مثال، در HTML دستور osgmlnorm خروجی <DL COMPACT> را به جای <DL COMPACT="COMPACT"> تولید می‌کند.

بخشی از یک سیستم SGML منطبق بر استاندارد بین‌المللی ISO 8879 -- زبان نشانه‌گذاری تعمیم‌یافته استاندارد (SGML). یک سیستم امکانات گسترش‌یافته SGML منطبق بر پیوست A از استاندارد بین‌المللی ISO/IEC 10744 -- زبان ساختاردهی ابررسانه‌ای/مبتنی بر زمان (HyTime).

گزینه‌های زیر در دسترس هستند:

-aname, --activate=name

فعال کردن doctype یا linktype با نام name.

-Aarchitecture, --architecture=architecture

تجزیه با در نظر گرفتن معماری architecture.

-bbctf, --bctf=bctf

استفاده از BCTF با نام bctf برای خروجی.

-csysid, --catalog=sysid

نگاشت شناسه‌های عمومی و نام‌های موجودیت به شناسه‌های سیستمی با استفاده از فایل ورودی کاتالوگ با شناسه سیستمی sysid.

-C, --catalogs

این گزینه همان عملکرد موجود در onsgmls(1) را دارد.

-d, --dtd

چاپ یک اعلان نوع سند (document type declaration) با همان شناسه خارجی سند ورودی و بدون زیرمجموعه اعلان داخلی (internal declaration subset). هیچ بررسی مبنی بر معتبر بودن نمونه سند با توجه به این DTD انجام نمی‌شود.

-Ddirectory, --directory=directory

جستجوی پوشه directory برای فایل‌های مشخص‌شده در شناسه‌های سیستمی.

این گزینه همان عملکرد موجود در onsgmls(1) را دارد.

-e, --open-entities

شرح موجودیت‌های باز در پیام‌های خطا.

--error-numbers

نمایش شماره خطاها در پیام‌های خطا.

-h, --help

نمایش متن راهنما و خروج.

-iname, --include=name

این گزینه همان عملکرد موجود در onsgmls(1) را دارد.

-m, --marked-sections

چاپ بخش‌های علامت‌گذاری‌شده (marked sections) موجود در نمونه سند ورودی در خروجی.

-n, --comments

چاپ تمام یادداشت‌ها و توضیحات (کامنت‌های) موجود در نمونه سند ورودی در خروجی.

-r, --raw

خروجی خام. عدم انجام هرگونه تبدیل روی RSها و REها هنگام چاپ موجودیت. موجودیت معمولاً ویژگی مدیریت ذخیره‌سازی records=asis را خواهد داشت.

-R, --restricted

این گزینه همان عملکرد موجود در onsgmls(1) را دارد.

-v, --version

چاپ شماره نسخه برنامه.

-wtype

کنترل هشدارها و خطاها با توجه به نوع (type). این گزینه همان عملکرد موجود در onsgmls(1) را دارد.

onsgmls(1), ospam(1), ospent(1), osx(1)

James Clark

نویسنده.

Ian Castle <ian.castle@openjade.org>

نویسنده.

January 2002 OpenJade