'\" t
.\"     Title: ospam
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: November 2002
.\"    Manual: Reference
.\"    Source: OpenJade
.\"  Language: English
.\"
.TH "OSPAM" "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)"
ospam \- ویرایشگر جریان نشانه‌گذاری SGML/XML
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBospam\fR\ 'u
\fBospam\fR [\fB\-CeghilprRvx\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_file\fR\fR] [\fB\-D\fR\fB\fIdirectory\fR\fR] [\fB\-f\fR\fB\fIfile\fR\fR] [\fB\-m\fR\fB\fImarkup_option\fR\fR] [\fB\-o\fR\fB\fIentity_name\fR\fR] [\fB\-w\fR\fB\fIwarning_type\fR\fR] [\fIsysid\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBospam\fR
(مخفف OpenSP Add Markup) یک ویرایشگر جریان نشانه‌گذاری SGML است که با استفاده از تجزیه‌کننده OpenSP پیاده‌سازی شده است\&.
\fBospam\fR
سند SGML موجود در
\fIsysid\fR
را تجزیه کرده و بخشی از موجودیت سند را که حاوی نمونه سند (document instance) است به خروجی استاندارد کپی می‌کند و نشانه‌گذاری‌ها را مطابق با آنچه توسط گزینه‌های
\fB\-m\fR
مشخص شده است اضافه کرده یا تغییر می‌دهد\&. گزینه
\fB\-p\fR
می‌تواند برای گنجاندن اعلان SGML و پیش‌گفتار (prolog) در خروجی استفاده شود\&. گزینه
\fB\-o\fR
می‌تواند برای خروجی دادن سایر موجودیت‌ها استفاده شود\&. گزینه
\fB\-x\fR
می‌تواند برای گسترش ارجاعات موجودیت به کار رود\&.
.PP
بخشی از یک سیستم SGML منطبق با استاندارد بین‌المللی ISO 8879 \-\- زبان نشانه‌گذاری تعمیم‌یافته استاندارد (SGML)\&. یک سیستم تسهیلات گسترش‌یافته SGML منطبق با ضمیمه A از استاندارد بین‌المللی ISO/IEC 10744 \-\- زبان ساختاریافته فرارسانه/مبتنی بر زمان\&.
.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\fIdirectory\fR\fR, \fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
دایرکتوری را برای فایل‌های مشخص‌شده در شناسه‌های سیستمی جستجو می‌کند\&. این گزینه همان تأثیری را دارد که در
\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\-h\fR, \fB\-\-hoist\-omitted\-tags\fR
.RS 4
بالا بردن برچسب‌های حذف‌شده از ابتدای موجودیت‌های داخلی\&. اگر متن ابتدای یک موجودیت داخلی باعث شود یک برچسب به طور ضمنی در نظر گرفته شود، معمولاً آن برچسب در همان موجودیت داخلی در نظر گرفته می‌شود؛ این گزینه به جای آن باعث می‌شود که برچسب در موجودیتی که به موجودیت داخلی ارجاع داده است در نظر گرفته شود\&. این گزینه در ترکیب با
\fB\-momittag\fR
یا
\fB\-x\fR
\fB\-x\fR
تفاوت ایجاد می‌کند\&.
.RE
.PP
\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\-\-lowercase\fR
.RS 4
ترجیح حروف کوچک\&. نام‌های اضافه‌شده‌ای که مشمول جایگزینی حروف بزرگ بودند به حروف کوچک تبدیل می‌شوند\&.
.RE
.PP
\fB\-m\fR\fB\fImarkup_option\fR\fR, \fB\-\-markup\-option=\fR\fB\fImarkup_option\fR\fR
.RS 4
تغییر نشانه‌گذاری در خروجی با توجه به مقدار
\fImarkup_option\fR
به صورت زیر:
.sp
\fBomittag\fR
افزودن برچسب‌هایی که با استفاده از کمینه‌سازی برچسب‌های حذف‌شده جا افتاده‌اند\&. برچسب‌های پایانی که به دلیل داشتن محتوای اعلان‌شده EMPTY یا ارجاع محتوای صریح حذف شده‌اند اضافه نخواهند شد\&.
.sp
\fBshortref\fR
جایگزینی ارجاعات کوتاه با ارجاعات موجودیت نام‌گذاری‌شده\&.
.sp
\fBnet\fR
تبدیل برچسب‌های پایانی تهی (null end-tags) به برچسب‌های پایانی کمینه‌نشده، و تبدیل برچسب‌های شروع فعال‌کننده net به برچسب‌های شروع کمینه‌نشده\&.
.sp
\fBemptytag\fR
تبدیل برچسب‌های خالی به برچسب‌های کمینه‌نشده\&.
.sp
\fBunclosed\fR
تبدیل برچسب‌های بسته‌نشده به برچسب‌های کمینه‌نشده\&.
.sp
\fBattname\fR
افزودن نام‌های ویژگی حذف‌شده و viها\&.
.sp
\fBattvalue\fR
افزودن جداکننده‌های لفظی حذف‌شده از مقادیر ویژگی‌ها\&.
.sp
\fBattspec\fR
افزودن مشخصات ویژگی حذف‌شده\&.
.sp
\fBcurrent\fR
افزودن مشخصات ویژگی حذف‌شده برای ویژگی‌های جاری\&. این گزینه به طور ضمنی توسط گزینه attspec انتخاب می‌شود\&.
.sp
\fBshorttag\fR
معادل ترکیبی از گزینه‌های net، emptytag، unclosed، attname، attvalue و attspec\&.
.sp
\fBrank\fR
افزودن پسوندهای رتبه (rank) حذف‌شده\&.
.sp
\fBreserved\fR
قرار دادن نام‌های رزروشده با حروف بزرگ\&.
.sp
\fBms\fR
حذف اعلان‌های بخش نشانه‌گذاری‌شده که وضعیت مؤثر آن‌ها IGNORE است، و جایگزینی هر اعلان بخش نشانه‌گذاری‌شده که وضعیت مؤثر آن INCLUDE است با بخش نشانه‌گذاری‌شده آن\&. در نمونه سند، کامنت‌های خالی قبل یا بعد از اعلان بخش نشانه‌گذاری‌شده اضافه می‌شود تا اطمینان حاصل شود که انتهای رکوردهای نادیده‌گرفته‌شده، نادیده باقی می‌مانند\&.
.sp
استفاده همزمان از چند گزینه \-m مجاز است\&.
.RE
.PP
\fB\-n\fR, \fB\-\-error\-numbers\fR
.RS 4
نمایش شماره خطاها در پیام‌های خطا\&.
.RE
.PP
\fB\-o\fR\fB\fIname\fR\fR, \fB\-\-output\-entity=\fR\fB\fIname\fR\fR
.RS 4
خروجی دادن نام موجودیت عمومی به جای موجودیت سند\&. خروجی مطابق با نخستین باری خواهد بود که به آن موجودیت در محتوا ارجاع داده می‌شود\&.
.RE
.PP
\fB\-p\fR, \fB\-\-output\-prolog\fR
.RS 4
خروجی دادن بخشی از موجودیت سند که حاوی اعلان SGML (اگر صریحاً در موجودیت سند وجود داشته باشد) و پیش‌گفتار (prolog) است، قبل از هر چیز دیگری\&. اگر این گزینه دو بار یا بیشتر مشخص شود، تمام ارجاعات موجودیت که بین اعلان‌ها در پیش‌گفتار رخ می‌دهند گسترش می‌یابند؛ این شامل ارجاع ضمنی به موجودیت حاوی زیرمجموعه خارجی DTD نیز می‌شود (در صورت وجود)\&. توجه داشته باشید که اگر اعلان SGML توسط یک ورودی SGMLDECL در کاتالوگ مشخص شده باشد، گنجانده نخواهد شد\&.
.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, \fB\-\-warning=\fR\fB\fItype\fR\fR
.RS 4
کنترل هشدارها و خطاها با توجه به نوع\&. این گزینه همان تأثیری را دارد که در
\fBonsgmls(1)\fR
آمده است\&.
.RE
.PP
\fB\-x\fR, \fB\-\-expand\-references\fR
.RS 4
گسترش ارجاعات به موجودیت‌هایی که تغییر یافته‌اند\&. اگر این گزینه دو بار یا بیشتر مشخص شود، تمام ارجاعات به موجودیت‌های حاوی برچسب گسترش خواهند یافت\&.
.RE
.SH "اشکالات (BUGS)"
.PP
برچسب‌های حذف‌شده در نقطه‌ای اضافه می‌شوند که توسط تجزیه‌کننده SGML استنباط می‌شوند (مگر مواردی که با گزینه
\fB\-h\fR
اصلاح شده باشند)؛ این نقطه اغلب دقیقاً همان جایی نیست که انتظار می‌رود\&.
.PP
بزرگی و کوچکی حروف در جداکننده‌های عمومی حفظ نمی‌شود\&.
.PP
اگر از یک ساختار عینی متغیر استفاده شود که در آن جداکننده‌هایی در نشانه‌گذاری‌های اضافه‌شونده وجود داشته باشند که پیشوندی دارند که پسوند سرهٔ جداکننده دیگری است، ممکن است نتایج نادرستی حاصل شود\&.
.PP
اگر یک ارجاع موجودیت در یک مقدار پیش‌فرض از موجودیت پیش‌فرض استفاده کند و سپس موجودیتی با آن نام تعریف شود و آن مقدار پیش‌فرض به نمونه سند اضافه گردد، ممکن است سند حاصل با سند اصلی معادل نباشد\&. در صورت تحقق دو شرط اول، دستور
\fBospam\fR
یک هشدار صادر می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBonsgmls(1)\fR,
\fBospent(1)\fR,
\fBonsgmlnorm(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