'\" t
.\"     Title: xmlif
.\"    Author: Eric S. Raymond <esr@snark.thyrsus.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: April 2009
.\"    Manual: xmlif
.\"    Source: Linux
.\"  Language: Persian
.\"
.TH "XMLIF" "1" "April 2009" "Linux" "xmlif"
.\" -----------------------------------------------------------------
.\" * 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)"
xmlif \- دستورالعمل‌های پردازش شرطی برای XML
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxmlif\fR\ 'u
\fBxmlif\fR [attrib=value...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
.B xmlif
اسناد XML را بر اساس نشانه‌گذاری‌های شرطی فیلتر می‌کند\&. این ویژگی برای قالب‌بندی یکی از چندین نسخه مختلف یک سند XML بسته به شرایط ارسال‌شده به دستور مفید است\&.
.PP
جفت‌های ویژگی/مقدار (Attribute/value) ارسال‌شده از خط فرمان، با ویژگی‌های مرتبط با دستورالعمل‌های پردازشی خاص در سند تطبیق داده می‌شوند\&. این دستورالعمل‌ها عبارتند از:
<?xmlif if?>
و معکوس آن
<?xmlif if not?>،
<?xmlif elif?>
و معکوس آن
<?xmlif elif not?>،
<?xmlif else?>
و
<?xmlif fi?>\&.
.PP
جفت‌های آرگومان/مقدار مشخص‌شده در خط فرمان، در برابر مقدار ویژگی‌های متناظر در دستورالعمل‌های پردازش شرطی بررسی می‌شوند\&. یک
`attribute match\*(Aq
(تطابق ویژگی) زمانی رخ می‌دهد که یک ویژگی هم در آرگومان‌های خط فرمان و هم در تگ وجود داشته باشد و مقادیر آن‌ها یکسان باشند\&. یک
`attribute mismatch\*(Aq
(عدم تطابق ویژگی) زمانی رخ می‌دهد که یک ویژگی هم در آرگومان‌های خط فرمان و هم در تگ وجود داشته باشد، اما مقادیر آن‌ها مطابقت نداشته باشند\&.
.PP
بخش‌های بین
<?xmlif if?>
یا
<?xmlif elif?>
و دستورالعمل پردازش شرطی بعدی در همان سطح تو‌در‌تویی، در صورتی که حداقل یک تطابق ویژگی و بدون هیچ عدم تطابقی وجود داشته باشد، بدون تغییر عبور داده می‌شوند؛ بخش‌های بین
<?xmlif if not?>
و
<?xmlif elif not?>
و دستورالعمل پردازش شرطی بعدی در غیر این صورت عبور داده می‌شوند\&. بخش‌های بین
<?xmlif else?>
و تگ پردازش شرطی بعدی تنها در صورتی بدون تغییر عبور داده می‌شوند که هیچ بخش قبلی در همان سطح عبور داده نشده باشد\&. دستورالعمل‌های
<?xmlif if?>
و
<?xmlif fi?>
(و نگارش‌های `not\*(Aq آن‌ها) سطح تو‌در‌تویی فعلی را تغییر می‌دهند؛ اما
<?xmlif else?>
و
<?xmlif elif?>
سطح را تغییر نمی‌دهند\&.
.PP
تمام این دستورالعمل‌های پردازشی از خروجی تولیدشده حذف خواهند شد\&. به غیر از اعمال شرط‌ها، تمام ورودی‌های دیگر دست‌نخورده عبور داده می‌شوند؛ به‌ویژه، ارجاعات موجودیت‌ها (entity references) بازگشایی نمی‌شوند\&.
.PP
تطبیق مقادیر بر اساس برابری رشته‌ای انجام می‌شود، با این استثنا که «|» در مقدار یک ویژگی به عنوان نویسه تناوب (یا/OR) تفسیر می‌شود\&. بنابراین، بیان foo=\*(Aqred|blue\*(Aq در خط فرمان، شرایط red و blue را فعال می‌کند\&. درج color=\*(Aqblack|white\*(Aq در یک تگ، با شرایط خط فرمان color=\*(Aqblack\*(Aq و color=\*(Aqwhite\*(Aq مطابقت پیدا می‌کند\&.
.PP
در اینجا یک مثال آمده است:
.sp
.if n \{\
.RS 4
.\}
.nf
Always issue this text\&.
<?xmlif if condition=\*(Aqhtml\*(Aq?>
Issue this text if \*(Aqcondition=html\*(Aq is given on the command line\&.
<?xmlif elif condition=\*(Aqpdf|ps\*(Aq?>
Issue this text if \*(Aqcondition=pdf\*(Aq or \*(Aqcondition=ps\*(Aq
is given on the command line\&.
<?xmlif else?>
Otherwise issue this text\&.
<?xmlif fi?>
Always issue this text\&.
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.PP
\fBEric S\&. Raymond\fR <\&esr@snark\&.thyrsus\&.com\&>
.RS 4
نویسنده برنامه xmlif
.RE