OSX(1) Reference OSX(1)

osx - تبدیل‌کننده SGML به XML

osx [-CeghnRvx] [-aname] [-Aarchitecture] [-bencoding] [-ccatalog_file] [-ddirectory] [-Ddirectory] [-iname] [-ffile] [-ldtd_file] [-wwarning_type] [-xxml_output_option...] [sysid...]

دستور osx اسناد SGML را به XML تبدیل می‌کند. osx سند SGML موجود در

را تجزیه و اعتبارسنجی کرده و یک سند XML معادل را در خروجی استاندارد می‌نویسد. osx در مورد ساختارهای SGML که هیچ معادل XML ندارند هشدار خواهد داد.

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

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

-aname, --activate=name

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

-Aname, --architecture=name

تجزیه نسبت به معماری name.

-bencoding, --encoding=encoding

استفاده از BCTF encoding برای خروجی. به طور پیش‌فرض osx از UTF-8 استفاده می‌کند.

-csysid, --catalog=sysid

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

-C, --catalogs

این گزینه همان تأثیری را دارد که در onsgmls(1) آمده است.

-ddirectory, --entity_output_location=directory

قرار دادن فایل‌های خروجی در directory.

-Ddirectory, --directory=directory

جستجوی directory برای فایل‌های مشخص‌شده در شناسه‌های سیستمی. این گزینه همان تأثیری را دارد که در onsgmls(1) آمده است.

-e, --open-entities

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

-Emax_errors, --max-errors=max_errors

صرف‌نظر کردن پس از وقوع max_errors خطا.

-ffile, --error-file=file

هدایت خطاها به file. این گزینه عمدتاً با پوسته‌هایی مفید است که از هدایت stderr پشتیبانی نمی‌کنند.

-g, --open-elements

توصیف عناصر باز در پیام‌های خطا.

-h, --help

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

-iname, --include=name

این گزینه همان تأثیری را دارد که در onsgmls(1) آمده است.

-ldtd-file, --dtd_location=dtd-file

مشخص می‌کند که فایل XML حاصل باید با DTD موجود در dtd-file مطابقت داشته باشد.

-n, --error-numbers

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

--references

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

-R, --restricted

این گزینه همان تأثیری را دارد که در onsgmls(1) آمده است.

-v, --version

چاپ شماره نسخه و خروج.

-wtype, --warning=type

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

-xxml_output_option, --xml-output-option=xml_output_option

کنترل خروجی XML با توجه به مقدار xml_output_option به شرح زیر:

no-nl-in-tag از خطوط جدید در داخل برچسب‌های شروع استفاده نکنید. معمولاً osx برای کاهش احتمال ایجاد خطوط بیش از حد طولانی، از خطوط جدید در داخل برچسب‌های شروع استفاده می‌کند.

id خروجی دادن اعلان‌های ویژگی برای ویژگی‌های ID.

notation خروجی دادن اعلان‌ها برای نشانه‌گذاری‌ها (notations).

ndata خروجی دادن اعلان‌ها برای موجودیت‌های داده‌ای خارجی. استاندارد XML مستلزم این است که این‌ها NDATA باشند. osx در مورد موجودیت‌های داده‌ای خارجی CDATA و SDATA هشدار می‌دهد و آن‌ها را به عنوان موجودیت‌های NDATA خروجی می‌دهد.

cdata استفاده از بخش‌های CDATA در XML برای بخش‌های نشانه‌گذاری‌شده CDATA و برای عنصرهایی با محتوای اعلان‌شده CDATA.

comment خروجی دادن اعلان‌های توضیحات (comment). اعلان‌های توضیحات در DTD خروجی داده نخواهند شد.

lower ترجیح حروف کوچک. نام‌هایی که توسط SGML مشمول جایگزینی با حروف بزرگ شده بودند به حروف کوچک تبدیل می‌شوند. این شامل نام‌های رزروشده نمی‌شود؛ استاندارد XML مستلزم این است که این نام‌ها با حروف بزرگ باشند.

pi-escape استفاده از escape برای کاراکترهای &<> در محتوای دستورالعمل‌های پردازشی با استفاده از موجودیت‌های amp، lt و gt. این امکان را می‌دهد که دستورالعمل‌های پردازشی حاوی رشته >? باشند، اما مستلزم آن است که برنامه‌ها کاراکترهای escape شده را مدیریت کنند.

empty استفاده از ساختار <e/> برای انواع عنصرهای e که به عنوان EMPTY اعلان شده‌اند.

attlist خروجی دادن اعلان ATTLIST برای هر عنصر با تعیین نوع همه ویژگی‌ها. مقدار پیش‌فرض همیشه #IMPLIED خواهد بود.

report-input-sources خروجی دادن یک دستورالعمل پردازشی برای گزارش باز یا بسته شدن یک منبع ورودی به جز فایل اصلی در نمونه سند. هیچ تغییری در منبع ورودی در DTD گزارش نمی‌شود.

report-entities خروجی دادن یک دستورالعمل پردازشی برای گزارش زمان حل یک ارجاع موجودیت خارجی در نمونه سند. هیچ وضوح موجودیتی در DTD گزارش نمی‌شود.

no-expand-external حفظ موجودیت‌های خارجی، نوشتن یک فایل گرداننده اعلان به نام "extEntities.dtf"، و گنجاندن آن فایل در زیرمجموعه داخلی نمونه سند.

no-expand-internal حفظ موجودیت‌های داخلی، نوشتن یک فایل گرداننده اعلان به نام "intEntities.dtf"، و گنجاندن آن فایل در زیرمجموعه داخلی نمونه سند.

no-external-decl فایل گرداننده اعلان موجودیت‌های خارجی در زیرمجموعه داخلی نمونه سند گنجانده نشود.

no-internal-decl فایل گرداننده اعلان موجودیت‌های داخلی در زیرمجموعه داخلی نمونه سند گنجانده نشود.

no-output-outside-outdir هنگام حفظ موجودیت‌های خارجی، فایل‌های خروجی خارج از دایرکتوری خروجی مشخص‌شده (به طور پیش‌فرض ".") نوشته نشوند. به عبارت دیگر، اگر شناسه سیستمی یک موجودیت خارجی شامل تعداد کافی از نمونه‌های ".." باشد که باعث شود osx فایلی را خارج از (بالاتر از) دایرکتوری خروجی بنویسد، خارج شوید (به طور پیش‌فرض osx یک هشدار صادر می‌کند اما فایل را می‌نویسد و ادامه می‌دهد).

no-overwrite هنگام حفظ موجودیت‌های داخلی یا خارجی، چندین فایل خروجی نوشته خواهد شد. اگر این گزینه مشخص شود، فایل‌های موجود بازنویسی نمی‌شوند؛ در عوض، تلاش می‌شود یک عدد به انتهای نام فایل اصلی اضافه شود تا یک نام فایل منحصربه‌فرد ایجاد گردد. اگر تعداد بیش از حدی (۱۰۰ عدد) از چنین فایل‌هایی از قبل وجود داشته باشد با خطا خارج می‌شود.

preserve-case حفظ بزرگی و کوچکی حروف همان‌طور که در DTD مشخص شده است برای نام‌های عنصر؛ نام‌های ویژگی؛ مقادیر ویژگی‌هایی که فهرست نشانه‌ها هستند.

sdata-as-pis هنگام ترجمه موجودیت‌های SDATA (چه در حال گسترش آن‌ها یا ارائه تعریفی برای آن‌ها در زیرمجموعه داخلی خروجی)، آن‌ها را به عنوان دستورالعمل‌های پردازشی به جای موجودیت‌های عمومی داخلی بیان کنید.

استفاده همزمان از چند گزینه -x مجاز است.

onsgmls(1), ospam(1), onsgmlnorm(1), ospent(1)

James Clark

نویسنده.

Ian Castle <ian.castle@openjade.org>

نویسنده.

November 2002 OpenJade