'\" t
.\"     Title: osx
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: November 2002
.\"    Manual: Reference
.\"    Source: OpenJade
.\"  Language: English
.\"
.TH "OSX" "1" "November 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)"
osx \- تبدیل‌کننده SGML به XML
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBosx\fR\ 'u
\fBosx\fR [\fB\-CeghnRvx\fR] [\fB\-a\fR\fB\fIname\fR\fR] [\fB\-A\fR\fB\fIarchitecture\fR\fR] [\fB\-b\fR\fB\fIencoding\fR\fR] [\fB\-c\fR\fB\fIcatalog_file\fR\fR] [\fB\-d\fR\fB\fIdirectory\fR\fR] [\fB\-D\fR\fB\fIdirectory\fR\fR] [\fB\-i\fR\fB\fIname\fR\fR] [\fB\-f\fR\fB\fIfile\fR\fR] [\fB\-l\fR\fB\fIdtd_file\fR\fR] [\fB\-w\fR\fB\fIwarning_type\fR\fR] [\fB\-x\fR\fB\fIxml_output_option\fR\fR...] [\fB\fIsysid\fR\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBosx\fR
اسناد SGML را به XML تبدیل می‌کند\&.
\fBosx\fR
سند SGML موجود در
.HP \w'\ 'u [\fB\fIsysid\fR\fR...]
را تجزیه و اعتبارسنجی کرده و یک سند XML معادل را در خروجی استاندارد می‌نویسد\&.
\fBosx\fR
در مورد ساختارهای SGML که هیچ معادل XML ندارند هشدار خواهد داد\&.
.PP
بخشی از یک سیستم SGML منطبق با استاندارد بین‌المللی ISO 8879 \-\- زبان نشانه‌گذاری تعمیم‌یافته استاندارد (SGML)\&. یک سیستم تسهیلات گسترش‌یافته SGML منطبق با ضمیمه A از استاندارد بین‌المللی ISO/IEC 10744 \-\- زبان ساختاریافته فرارسانه/مبتنی بر زمان\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر در دسترس هستند:
.PP
\fB\-a\fR\fB\fIname\fR\fR, \fB\-\-activate=\fR\fB\fIname\fR\fR
.RS 4
فعال کردن doctype یا linkname با نام
\fIname\fR\&.
.RE
.PP
\fB\-A\fR\fB\fIname\fR\fR, \fB\-\-architecture=\fR\fB\fIname\fR\fR
.RS 4
تجزیه نسبت به معماری
\fIname\fR\&.
.RE
.PP
\fB\-b\fR\fB\fIencoding\fR\fR, \fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
استفاده از BCTF
\fIencoding\fR
برای خروجی\&. به طور پیش‌فرض
\fBosx\fR
از UTF\-8 استفاده می‌کند\&.
.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\fIdirectory\fR\fR, \fB\-\-entity_output_location=\fR\fB\fIdirectory\fR\fR
.RS 4
قرار دادن فایل‌های خروجی در
\fIdirectory\fR\&.
.RE
.PP
\fB\-D\fR\fB\fIdirectory\fR\fR, \fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
جستجوی
\fIdirectory\fR
برای فایل‌های مشخص‌شده در شناسه‌های سیستمی\&. این گزینه همان تأثیری را دارد که در
\fBonsgmls(1)\fR
آمده است\&.
.RE
.PP
\fB\-e\fR, \fB\-\-open\-entities\fR
.RS 4
توصیف موجودیت‌های باز در پیام‌های خطا\&.
.RE
.PP
\fB\-E\fR\fB\fImax_errors\fR\fR, \fB\-\-max\-errors=\fR\fB\fImax_errors\fR\fR
.RS 4
صرف‌نظر کردن پس از وقوع
\fImax_errors\fR
خطا\&.
.RE
.PP
\fB\-f\fR\fB\fIfile\fR\fR, \fB\-\-error\-file=\fR\fB\fIfile\fR\fR
.RS 4
هدایت خطاها به
\fIfile\fR\&.
این گزینه عمدتاً با پوسته‌هایی مفید است که از هدایت stderr پشتیبانی نمی‌کنند\&.
.RE
.PP
\fB\-g\fR, \fB\-\-open\-elements\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\-l\fR\fB\fIdtd\-file\fR\fR, \fB\-\-dtd_location=\fR\fB\fIdtd\-file\fR\fR
.RS 4
مشخص می‌کند که فایل XML حاصل باید با DTD موجود در
\fIdtd\-file\fR
مطابقت داشته باشد\&.
.RE
.PP
\fB\-n\fR, \fB\-\-error\-numbers\fR
.RS 4
نمایش شماره خطاها در پیام‌های خطا\&.
.RE
.PP
\fB\-\-references\fR
.RS 4
نمایش ارجاعات در پیام‌های خطا\&.
.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, \fB\-\-warning=\fR\fB\fItype\fR\fR
.RS 4
کنترل هشدارها و خطاها با توجه به نوع\&. این گزینه همان تأثیری را دارد که در
\fBonsgmls(1)\fR
آمده است\&.
.RE
.PP
\fB\-x\fR\fB\fIxml_output_option\fR\fR, \fB\-\-xml\-output\-option=\fR\fB\fIxml_output_option\fR\fR
.RS 4
کنترل خروجی XML با توجه به مقدار
\fIxml_output_option\fR
به شرح زیر:
.sp
\fBno\-nl\-in\-tag\fR
از خطوط جدید در داخل برچسب‌های شروع استفاده نکنید\&. معمولاً
\fBosx\fR
برای کاهش احتمال ایجاد خطوط بیش از حد طولانی، از خطوط جدید در داخل برچسب‌های شروع استفاده می‌کند\&.
.sp
\fBid\fR
خروجی دادن اعلان‌های ویژگی برای ویژگی‌های ID\&.
.sp
\fBnotation\fR
خروجی دادن اعلان‌ها برای نشانه‌گذاری‌ها (notations)\&.
.sp
\fBndata\fR
خروجی دادن اعلان‌ها برای موجودیت‌های داده‌ای خارجی\&. استاندارد XML مستلزم این است که این‌ها NDATA باشند\&.
\fBosx\fR
در مورد موجودیت‌های داده‌ای خارجی CDATA و SDATA هشدار می‌دهد و آن‌ها را به عنوان موجودیت‌های NDATA خروجی می‌دهد\&.
.sp
\fBcdata\fR
استفاده از بخش‌های CDATA در XML برای بخش‌های نشانه‌گذاری‌شده CDATA و برای عنصرهایی با محتوای اعلان‌شده CDATA\&.
.sp
\fBcomment\fR
خروجی دادن اعلان‌های توضیحات (comment)\&. اعلان‌های توضیحات در DTD خروجی داده نخواهند شد\&.
.sp
\fBlower\fR
ترجیح حروف کوچک\&. نام‌هایی که توسط SGML مشمول جایگزینی با حروف بزرگ شده بودند به حروف کوچک تبدیل می‌شوند\&. این شامل نام‌های رزروشده نمی‌شود؛ استاندارد XML مستلزم این است که این نام‌ها با حروف بزرگ باشند\&.
.sp
\fBpi\-escape\fR
استفاده از escape برای کاراکترهای &<> در محتوای دستورالعمل‌های پردازشی با استفاده از موجودیت‌های amp، lt و gt\&. این امکان را می‌دهد که دستورالعمل‌های پردازشی حاوی رشته >? باشند، اما مستلزم آن است که برنامه‌ها کاراکترهای escape شده را مدیریت کنند\&.
.sp
\fBempty\fR
استفاده از ساختار <e/> برای انواع عنصرهای e که به عنوان EMPTY اعلان شده‌اند\&.
.sp
\fBattlist\fR
خروجی دادن اعلان ATTLIST برای هر عنصر با تعیین نوع همه ویژگی‌ها\&. مقدار پیش‌فرض همیشه #IMPLIED خواهد بود\&.
.sp
\fBreport\-input\-sources\fR
خروجی دادن یک دستورالعمل پردازشی برای گزارش باز یا بسته شدن یک منبع ورودی به جز فایل اصلی در نمونه سند\&. هیچ تغییری در منبع ورودی در DTD گزارش نمی‌شود\&.
.sp
\fBreport\-entities\fR
خروجی دادن یک دستورالعمل پردازشی برای گزارش زمان حل یک ارجاع موجودیت خارجی در نمونه سند\&. هیچ وضوح موجودیتی در DTD گزارش نمی‌شود\&.
.sp
\fBno\-expand\-external\fR
حفظ موجودیت‌های خارجی، نوشتن یک فایل گرداننده اعلان به نام "extEntities\&.dtf"، و گنجاندن آن فایل در زیرمجموعه داخلی نمونه سند\&.
.sp
\fBno\-expand\-internal\fR
حفظ موجودیت‌های داخلی، نوشتن یک فایل گرداننده اعلان به نام "intEntities\&.dtf"، و گنجاندن آن فایل در زیرمجموعه داخلی نمونه سند\&.
.sp
\fBno\-external\-decl\fR
فایل گرداننده اعلان موجودیت‌های خارجی در زیرمجموعه داخلی نمونه سند گنجانده نشود\&.
.sp
\fBno\-internal\-decl\fR
فایل گرداننده اعلان موجودیت‌های داخلی در زیرمجموعه داخلی نمونه سند گنجانده نشود\&.
.sp
\fBno\-output\-outside\-outdir\fR
هنگام حفظ موجودیت‌های خارجی، فایل‌های خروجی خارج از دایرکتوری خروجی مشخص‌شده (به طور پیش‌فرض "\&.") نوشته نشوند\&. به عبارت دیگر، اگر شناسه سیستمی یک موجودیت خارجی شامل تعداد کافی از نمونه‌های "\&.\&." باشد که باعث شود osx فایلی را خارج از (بالاتر از) دایرکتوری خروجی بنویسد، خارج شوید (به طور پیش‌فرض osx یک هشدار صادر می‌کند اما فایل را می‌نویسد و ادامه می‌دهد)\&.
.sp
\fBno\-overwrite\fR
هنگام حفظ موجودیت‌های داخلی یا خارجی، چندین فایل خروجی نوشته خواهد شد\&. اگر این گزینه مشخص شود، فایل‌های موجود بازنویسی نمی‌شوند؛ در عوض، تلاش می‌شود یک عدد به انتهای نام فایل اصلی اضافه شود تا یک نام فایل منحصربه‌فرد ایجاد گردد\&. اگر تعداد بیش از حدی (۱۰۰ عدد) از چنین فایل‌هایی از قبل وجود داشته باشد با خطا خارج می‌شود\&.
.sp
\fBpreserve\-case\fR
حفظ بزرگی و کوچکی حروف همان‌طور که در DTD مشخص شده است برای نام‌های عنصر؛ نام‌های ویژگی؛ مقادیر ویژگی‌هایی که فهرست نشانه‌ها هستند\&.
.sp
\fBsdata\-as\-pis\fR
هنگام ترجمه موجودیت‌های SDATA (چه در حال گسترش آن‌ها یا ارائه تعریفی برای آن‌ها در زیرمجموعه داخلی خروجی)، آن‌ها را به عنوان دستورالعمل‌های پردازشی به جای موجودیت‌های عمومی داخلی بیان کنید\&.
.sp
استفاده همزمان از چند گزینه
\fB\-x\fR
مجاز است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBonsgmls(1)\fR,
\fBospam(1)\fR,
\fBonsgmlnorm(1)\fR,
\fBospent(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