'\" t
.\"     Title: xsltproc
.\"    Author: John Fleck <jfleck@inkstain.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07/04/2024
.\"    Manual: xsltproc Manual
.\"    Source: libxslt
.\"  Language: Persian
.\"
.TH "XSLTPROC" "1" "07/04/2024" "libxslt" "xsltproc Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
xsltproc \- پردازشگر خط فرمانی XSLT
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxsltproc\fR\ 'u
\fBxsltproc\fR [[\fB\-V\fR | \fB\-\-version\fR] [\fB\-v\fR | \fB\-\-verbose\fR] [{\fB\-o\fR | \fB\-\-output\fR} {\fIFILE\fR | \fIDIRECTORY\fR}] | \fB\-\-timing\fR | \fB\-\-repeat\fR | \fB\-\-debug\fR | \fB\-\-novalid\fR | \fB\-\-noout\fR | \fB\-\-maxdepth\ \fR\fB\fIVALUE\fR\fR | \fB\-\-maxvars\ \fR\fB\fIVALUE\fR\fR | \fB\-\-huge\fR | \fB\-\-seed\-rand\ \fR\fB\fIVALUE\fR\fR | \fB\-\-html\fR | \fB\-\-encoding\ \fR\fB\fIENCODING\fR\fR\fB\ \fR | \fB\-\-param\ \fR\fB\fIPARAMNAME\fR\fR\fB\ \fR\fB\fIPARAMVALUE\fR\fR\fB\ \fR | \fB\-\-stringparam\ \fR\fB\fIPARAMNAME\fR\fR\fB\ \fR\fB\fIPARAMVALUE\fR\fR\fB\ \fR | \fB\-\-nonet\fR | \fB\-\-path\ "\fR\fB\fIPATH(S)\fR\fR\fB"\fR | \fB\-\-load\-trace\fR | \fB\-\-catalogs\fR | \fB\-\-xinclude\fR | \fB\-\-xincludestyle\fR | [\fB\-\-profile\fR\ |\ \fB\-\-norman\fR] | \fB\-\-dumpextensions\fR | \fB\-\-nowrite\fR | \fB\-\-nomkdir\fR | \fB\-\-writesubtree\ \fR\fB\fIPATH\fR\fR | \fB\-\-nodtdattr\fR] [\fISTYLESHEET\fR] {\fIXML\-FILE\fR... | \-}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBxsltproc\fR
یک ابزار خط فرمانی برای اعمال شیوه‌برگه‌های
XSLT
روی اسناد
XML
است\&. این ابزار بخشی از
\fBlibxslt\fR(3)،
کتابخانهٔ C مربوط به XSLT برای GNOME است\&. اگرچه به عنوان بخشی از پروژهٔ GNOME توسعه یافته است، اما می‌تواند مستقل از محیط رومیزی GNOME عمل کند\&.
.PP
\fBxsltproc\fR
از خط فرمان با نام شیوه‌برگهٔ مورد نظر و به دنبال آن نام فایل یا فایل‌هایی که شیوه‌برگه باید روی آن‌ها اعمال شود فراخوانی می‌شود\&. اگر نام فایل ارائه‌شده
\fB\-\fR
باشد، از ورودی استاندارد استفاده خواهد کرد\&.
.PP
اگر یک شیوه‌برگه درون یک سند
XML
با استفاده از دستورالعمل پردازش شیوه‌برگه (Stylesheet Processing Instruction) گنجانده شده باشد، نیازی به ذکر نام شیوه‌برگه در خط فرمان نیست\&.
\fBxsltproc\fR
به‌طور خودکار شیوه‌برگهٔ گنجانده‌شده را شناسایی کرده و از آن استفاده می‌کند\&.
.PP
به‌طور پیش‌فرض، خروجی به
stdout
ارسال می‌شود\&. می‌توانید با استفاده از گزینهٔ
\fB\-o\fR
یا
\fB\-\-output\fR
فایلی را برای خروجی مشخص کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fBxsltproc\fR
گزینه‌های زیر را (به ترتیب الفبا) می‌پذیرد:
.PP
\fB\-\-catalogs\fR
.RS 4
استفاده از کاتالوگ
SGML
مشخص‌شده در
\fBSGML_CATALOG_FILES\fR
برای یافتن نشانی موجودیت‌های خارجی\&. به‌طور پیش‌فرض،
\fBxsltproc\fR
به دنبال کاتالوگ مشخص‌شده در
\fBXML_CATALOG_FILES\fR
می‌گردد\&. اگر مقداری مشخص نشده باشد، از
/etc/xml/catalog
استفاده می‌کند\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
خروجی دادن یک درخت
XML
از سند تبدیل‌شده برای اهداف اشکال‌زدایی\&.
.RE
.PP
\fB\-\-dumpextensions\fR
.RS 4
تخلیه فهرست تمام افزونه‌های ثبت‌شده در
stdout\&.
.RE
.PP
\fB\-\-html\fR
.RS 4
سند ورودی یک فایل
HTML
است\&.
.RE
.PP
\fB\-\-load\-trace\fR
.RS 4
نمایش تمام اسناد بارگذاری‌شده در طول پردازش در
stderr\&.
.RE
.PP
\fB\-\-maxdepth \fR\fB\fIVALUE\fR\fR
.RS 4
تنظیم حداکثر عمق پشتهٔ الگو پیش از آنکه
\fBlibxslt\fR(3)
نتیجه بگیرد در یک حلقهٔ بی‌پایان قرار دارد\&. پیش‌فرض 3000 است\&.
.RE
.PP
\fB\-\-maxvars \fR\fB\fIVALUE\fR\fR
.RS 4
حداکثر تعداد متغیرها\&. پیش‌فرض 15000 است\&.
.RE
.PP
\fB\-\-huge\fR
.RS 4
کاهش محدودیت‌های سخت‌کدشدهٔ تجزیه‌کننده XML با تنظیم گزینهٔ تجزیه‌کننده XML_PARSE_HUGE\&.
.RE
.PP
\fB\-\-seed\-rand \fR\fB\fIVALUE\fR\fR
.RS 4
مقداردهی اولیه به مولد اعداد شبه‌تصادفی با یک بذر (seed) مشخص\&.
.RE
.PP
\fB\-\-nodtdattr\fR
.RS 4
ویژگی‌های پیش‌فرض را از
DTD
سند اعمال نکن\&.
.RE
.PP
\fB\-\-nomkdir\fR
.RS 4
از ساخت دایرکتوری‌ها خودداری می‌کند\&.
.RE
.PP
\fB\-\-nonet\fR
.RS 4
از اینترنت برای واکشی
DTDها،
موجودیت‌ها یا اسناد استفاده نکن\&.
.RE
.PP
\fB\-\-noout\fR
.RS 4
نتیجه را در خروجی صادر نکن\&.
.RE
.PP
\fB\-\-novalid\fR
.RS 4
از بارگذاری
DTD
سند صرف‌نظر کن\&.
.RE
.PP
\fB\-\-nowrite\fR
.RS 4
از نوشتن در هرگونه فایل یا منبع خودداری می‌کند\&.
.RE
.PP
\fB\-o\fR یا \fB\-\-output\fR \fIFILE\fR | \fIDIRECTORY\fR
.RS 4
هدایت مستقیم خروجی به
\fIFILE\fR
ارائه‌شده\&. استفاده از این گزینه همراه با یک
\fIDIRECTORY\fR
فایل‌های خروجی را به دایرکتوری مشخص‌شده هدایت می‌کند\&. این ویژگی می‌تواند برای خروجی‌های چندگانه (که با نام «chunking» یا تکه‌تکه‌سازی نیز شناخته می‌شود) یا پردازش صفحات راهنما (manpage) مفید باشد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBمهم\fR
.ps -1
.br
دایرکتوری داده‌شده
\fBباید\fR
از قبل وجود داشته باشد\&..sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
اطمینان حاصل کنید که
\fIFILE\fR
و
\fIDIRECTORY\fR
از
\(lqURI reference computation\(rq
همان‌طور که در RFC 2396 و نسخه‌های پس از آن توصیف شده است پیروی می‌کنند\&. این بدان معناست که برای نمونه
\fB\-o directory\fR
ممکن است کار نکند، اما
\fB\-o directory/\fR
کار خواهد کرد\&.
.sp .5v
.RE
.RE
.PP
\fB\-\-encoding \fR\fB\fIENCODING\fR\fR
.RS 4
امکان تعیین کدگذاری (encoding) را برای ورودی فراهم می‌کند\&.
.RE
.PP
\fB\-\-param \fR\fB\fIPARAMNAME\fR\fR\fB \fR\fB\fIPARAMVALUE\fR\fR
.RS 4
پارامتری با نام
\fIPARAMNAME\fR
و مقدار
\fIPARAMVALUE\fR
را به شیوه‌نامه (stylesheet) ارسال می‌کند\&. می‌توانید چندین جفت نام/مقدار را تا حداکثر ۳۲ مورد ارسال کنید\&. اگر مقدار ارسالی یک رشته باشد، می‌توانید در عوض از
\fB\-\-stringparam\fR
استفاده کنید تا از نویسه‌های نقل‌قول اضافی که در عبارات رشته‌ای ظاهر می‌شوند جلوگیری شود\&. نکته: عبارت XPath باید دارای کدگذاری UTF\-8 باشد\&.
.RE
.PP
\fB\-\-path "\fR\fB\fIPATH(S)\fR\fR\fB"\fR
.RS 4
از فهرست مسیرهای سیستم‌فایل (جداشده با فاصله یا دونقطه) که توسط
\fIPATHS\fR
مشخص شده است برای بارگذاری DTDها، موجودیت‌ها (entities) یا اسناد استفاده می‌کند\&. فهرست‌های جداشده با فاصله را در علامت نقل‌قول قرار دهید\&.
.RE
.PP
\fB\-\-profile\fR یا \fB\-\-norman\fR
.RS 4
اطلاعات پروفایل‌سازی (profiling) را با جزئیات مدت زمان صرف‌شده در هر بخش از شیوه‌نامه در خروجی نمایش می‌دهد\&. این گزینه برای بهینه‌سازی کارایی شیوه‌نامه مفید است\&.
.RE
.PP
\fB\-\-repeat\fR
.RS 4
تبدیل را ۲۰ بار اجرا می‌کند\&. برای آزمون‌های زمان‌سنجی استفاده می‌شود\&.
.RE
.PP
\fB\-\-stringparam \fR\fB\fIPARAMNAME\fR\fR\fB \fR\fB\fIPARAMVALUE\fR\fR
.RS 4
پارامتری با نام
\fIPARAMNAME\fR
و مقدار
\fIPARAMVALUE\fR
را ارسال می‌کند که در آن
\fIPARAMVALUE\fR
به جای یک شناسه گره (node identifier)، یک رشته است\&.
\fBنکته:\fR
رشته باید با کدگذاری UTF\-8 باشد\&.
.RE
.PP
\fB\-\-timing\fR
.RS 4
زمان صرف‌شده برای تجزیه شیوه‌نامه، تجزیه سند، اعمال شیوه‌نامه و ذخیره نتیجه را نمایش می‌دهد\&. خروجی بر حسب میلی‌ثانیه نمایش داده می‌شود\&.
.RE
.PP
\fB\-v\fR یا \fB\-\-verbose\fR
.RS 4
هر گام برداشته‌شده توسط
\fBxsltproc\fR
در پردازش شیوه‌نامه و سند را در خروجی نمایش می‌دهد\&.
.RE
.PP
\fB\-V\fR یا \fB\-\-version\fR
.RS 4
نسخه
\fBlibxml\fR(3)
و
\fBlibxslt\fR(3)
استفاده‌شده را نمایش می‌دهد\&.
.RE
.PP
\fB\-\-writesubtree \fR\fB\fIPATH\fR\fR
.RS 4
نوشتن فایل را فقط در زیردرخت
\fIPATH\fR
مجاز می‌داند\&.
.RE
.PP
\fB\-\-xinclude\fR
.RS 4
سند ورودی را با استفاده از مشخصات XInclude پردازش می‌کند\&. جزئیات بیشتر در این باره را می‌توان در مشخصات XInclude یافت:
\m[blue]\fB\%http://www.w3.org/TR/xinclude\fR\m[]
.RE
.PP
\fB\-\-xincludestyle\fR
.RS 4
شیوه‌نامه را با XInclude پردازش می‌کند\&.
.RE.SH "محیط (ENVIRONMENT)"
.PP
\fBSGML_CATALOG_FILES\fR
.RS 4
رفتار کاتالوگ
SGML
را می‌توان با بازهدایت پرس‌وجوها به مجموعه کاتالوگ‌های اختصاصی کاربر تغییر داد\&. این کار با تنظیم متغیر محیطی
\fBSGML_CATALOG_FILES\fR
بر روی فهرستی از کاتالوگ‌ها امکان‌پذیر است\&. یک مقدار خالی باید بارگذاری کاتالوگ پیش‌فرض
/etc/sgml/catalog
را غیرفعال کند\&.
.RE
.PP
\fBXML_CATALOG_FILES\fR
.RS 4
رفتار کاتالوگ
XML
را می‌توان با بازهدایت پرس‌وجوها به مجموعه کاتالوگ‌های اختصاصی کاربر تغییر داد\&. این کار با تنظیم متغیر محیطی
\fBXML_CATALOG_FILES\fR
بر روی فهرستی از کاتالوگ‌ها امکان‌پذیر است\&. یک مقدار خالی باید بارگذاری کاتالوگ پیش‌فرض
/etc/xml/catalog
را غیرفعال کند\&.
.RE
.SH "خطاها (DIAGNOSTICS)"
.PP
کدهای بازگشتی
\fBxsltproc\fR
اطلاعاتی را ارائه می‌دهند که هنگام فراخوانی آن از طریق اسکریپت‌ها قابل استفاده است\&.
.PP
\fB0\fR
.RS 4
بدون خطا (عملکرد عادی)
.RE
.PP
\fB1\fR
.RS 4
بدون آرگومان
.RE
.PP
\fB2\fR
.RS 4
تعداد پارامترها بیش از حد است
.RE
.PP
\fB3\fR
.RS 4
گزینه ناشناخته
.RE
.PP
\fB4\fR
.RS 4
شکست در تجزیه شیوه‌نامه
.RE
.PP
\fB5\fR
.RS 4
خطا در شیوه‌نامه
.RE
.PP
\fB6\fR
.RS 4
خطا در یکی از اسناد
.RE
.PP
\fB7\fR
.RS 4
روش xsl:output پشتیبانی‌نشده
.RE
.PP
\fB8\fR
.RS 4
پارامتر رشته‌ای حاوی هر دو علامت نقل‌قول تکی و جفتی است
.RE
.PP
\fB9\fR
.RS 4
خطای پردازش داخلی
.RE
.PP
\fB10\fR
.RS 4
پردازش توسط یک پیام خاتمه‌دهنده متوقف شد
.RE
.PP
\fB11\fR
.RS 4
نوشتن نتیجه در فایل خروجی امکان‌پذیر نبود
.RE.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlibxml\fR(3),
\fBlibxslt\fR(3)
.PP
اطلاعات بیشتر را می‌توان در نشانی‌های زیر یافت:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحهٔ وب
\fBlibxml\fR(3)
\m[blue]\fB\%https://gitlab.gnome.org/GNOME/libxslt\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحهٔ
XSLT
در
W3C
\m[blue]\fB\%http://www.w3.org/TR/xslt\fR\m[]
.RE
.sp
.SH "نویسندگان (AUTHORS)"
.PP
\fBJohn Fleck\fR <\&jfleck@inkstain\&.net\&>
.RS 4
نویسنده.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
کپی‌رایت \(co 2001, 2002
.br