XSLTPROC(1)

xsltproc Manual

XSLTPROC(1)

نام (NAME)

xsltproc - پردازشگر خط فرمانی XSLT

خلاصه دستور (SYNOPSIS)

xsltproc [[-V | --version] [-v | --verbose] [{-o | --output} {FILE | DIRECTORY}] | --timing | --repeat | --debug | --novalid | --noout | --maxdepth VALUE | --maxvars VALUE | --huge | --seed-rand VALUE | --html | --encoding ENCODING | --param PARAMNAME PARAMVALUE | --stringparam PARAMNAME PARAMVALUE | --nonet | --path "PATH(S)" | --load-trace | --catalogs | --xinclude | --xincludestyle | [--profile | --norman] | --dumpextensions | --nowrite | --nomkdir | --writesubtree PATH | --nodtdattr] [STYLESHEET] {XML-FILE... | -}

توضیحات (DESCRIPTION)

xsltproc یک ابزار خط فرمانی برای اعمال شیوه‌برگه‌های XSLT روی اسناد XML است. این ابزار بخشی از libxslt(3)، کتابخانهٔ C مربوط به XSLT برای GNOME است. اگرچه به عنوان بخشی از پروژهٔ GNOME توسعه یافته است، اما می‌تواند مستقل از محیط رومیزی GNOME عمل کند.

xsltproc از خط فرمان با نام شیوه‌برگهٔ مورد نظر و به دنبال آن نام فایل یا فایل‌هایی که شیوه‌برگه باید روی آن‌ها اعمال شود فراخوانی می‌شود. اگر نام فایل ارائه‌شده - باشد، از ورودی استاندارد استفاده خواهد کرد.

اگر یک شیوه‌برگه درون یک سند XML با استفاده از دستورالعمل پردازش شیوه‌برگه (Stylesheet Processing Instruction) گنجانده شده باشد، نیازی به ذکر نام شیوه‌برگه در خط فرمان نیست. xsltproc به‌طور خودکار شیوه‌برگهٔ گنجانده‌شده را شناسایی کرده و از آن استفاده می‌کند.

به‌طور پیش‌فرض، خروجی به stdout ارسال می‌شود. می‌توانید با استفاده از گزینهٔ -o یا --output فایلی را برای خروجی مشخص کنید.

گزینه‌ها (OPTIONS)

xsltproc گزینه‌های زیر را (به ترتیب الفبا) می‌پذیرد:

--catalogs

استفاده از کاتالوگ SGML مشخص‌شده در SGML_CATALOG_FILES برای یافتن نشانی موجودیت‌های خارجی. به‌طور پیش‌فرض، xsltproc به دنبال کاتالوگ مشخص‌شده در XML_CATALOG_FILES می‌گردد. اگر مقداری مشخص نشده باشد، از /etc/xml/catalog استفاده می‌کند.

--debug

خروجی دادن یک درخت XML از سند تبدیل‌شده برای اهداف اشکال‌زدایی.

--dumpextensions

تخلیه فهرست تمام افزونه‌های ثبت‌شده در stdout.

--html

سند ورودی یک فایل HTML است.

--load-trace

نمایش تمام اسناد بارگذاری‌شده در طول پردازش در stderr.

--maxdepth VALUE

تنظیم حداکثر عمق پشتهٔ الگو پیش از آنکه libxslt(3) نتیجه بگیرد در یک حلقهٔ بی‌پایان قرار دارد. پیش‌فرض 3000 است.

--maxvars VALUE

حداکثر تعداد متغیرها. پیش‌فرض 15000 است.

--huge

کاهش محدودیت‌های سخت‌کدشدهٔ تجزیه‌کننده XML با تنظیم گزینهٔ تجزیه‌کننده XML_PARSE_HUGE.

--seed-rand VALUE

مقداردهی اولیه به مولد اعداد شبه‌تصادفی با یک بذر (seed) مشخص.

--nodtdattr

ویژگی‌های پیش‌فرض را از DTD سند اعمال نکن.

--nomkdir

از ساخت دایرکتوری‌ها خودداری می‌کند.

--nonet

از اینترنت برای واکشی DTDها، موجودیت‌ها یا اسناد استفاده نکن.

--noout

نتیجه را در خروجی صادر نکن.

--novalid

از بارگذاری DTD سند صرف‌نظر کن.

--nowrite

از نوشتن در هرگونه فایل یا منبع خودداری می‌کند.

-o یا --output FILE | DIRECTORY

هدایت مستقیم خروجی به FILE ارائه‌شده. استفاده از این گزینه همراه با یک DIRECTORY فایل‌های خروجی را به دایرکتوری مشخص‌شده هدایت می‌کند. این ویژگی می‌تواند برای خروجی‌های چندگانه (که با نام «chunking» یا تکه‌تکه‌سازی نیز شناخته می‌شود) یا پردازش صفحات راهنما (manpage) مفید باشد.

مهم
دایرکتوری داده‌شده باید از قبل وجود داشته باشد..sp .5v

نکته
اطمینان حاصل کنید که FILE و DIRECTORY از “URI reference computation” همان‌طور که در RFC 2396 و نسخه‌های پس از آن توصیف شده است پیروی می‌کنند. این بدان معناست که برای نمونه -o directory ممکن است کار نکند، اما -o directory/ کار خواهد کرد.

--encoding ENCODING

امکان تعیین کدگذاری (encoding) را برای ورودی فراهم می‌کند.

--param PARAMNAME PARAMVALUE

پارامتری با نام PARAMNAME و مقدار PARAMVALUE را به شیوه‌نامه (stylesheet) ارسال می‌کند. می‌توانید چندین جفت نام/مقدار را تا حداکثر ۳۲ مورد ارسال کنید. اگر مقدار ارسالی یک رشته باشد، می‌توانید در عوض از --stringparam استفاده کنید تا از نویسه‌های نقل‌قول اضافی که در عبارات رشته‌ای ظاهر می‌شوند جلوگیری شود. نکته: عبارت XPath باید دارای کدگذاری UTF-8 باشد.

--path "PATH(S)"

از فهرست مسیرهای سیستم‌فایل (جداشده با فاصله یا دونقطه) که توسط PATHS مشخص شده است برای بارگذاری DTDها، موجودیت‌ها (entities) یا اسناد استفاده می‌کند. فهرست‌های جداشده با فاصله را در علامت نقل‌قول قرار دهید.

--profile یا --norman

اطلاعات پروفایل‌سازی (profiling) را با جزئیات مدت زمان صرف‌شده در هر بخش از شیوه‌نامه در خروجی نمایش می‌دهد. این گزینه برای بهینه‌سازی کارایی شیوه‌نامه مفید است.

--repeat

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

--stringparam PARAMNAME PARAMVALUE

پارامتری با نام PARAMNAME و مقدار PARAMVALUE را ارسال می‌کند که در آن PARAMVALUE به جای یک شناسه گره (node identifier)، یک رشته است. نکته: رشته باید با کدگذاری UTF-8 باشد.

--timing

زمان صرف‌شده برای تجزیه شیوه‌نامه، تجزیه سند، اعمال شیوه‌نامه و ذخیره نتیجه را نمایش می‌دهد. خروجی بر حسب میلی‌ثانیه نمایش داده می‌شود.

-v یا --verbose

هر گام برداشته‌شده توسط xsltproc در پردازش شیوه‌نامه و سند را در خروجی نمایش می‌دهد.

-V یا --version

نسخه libxml(3) و libxslt(3) استفاده‌شده را نمایش می‌دهد.

--writesubtree PATH

نوشتن فایل را فقط در زیردرخت PATH مجاز می‌داند.

--xinclude

سند ورودی را با استفاده از مشخصات XInclude پردازش می‌کند. جزئیات بیشتر در این باره را می‌توان در مشخصات XInclude یافت: http://www.w3.org/TR/xinclude

--xincludestyle

شیوه‌نامه را با XInclude پردازش می‌کند.

SGML_CATALOG_FILES

رفتار کاتالوگ SGML را می‌توان با بازهدایت پرس‌وجوها به مجموعه کاتالوگ‌های اختصاصی کاربر تغییر داد. این کار با تنظیم متغیر محیطی SGML_CATALOG_FILES بر روی فهرستی از کاتالوگ‌ها امکان‌پذیر است. یک مقدار خالی باید بارگذاری کاتالوگ پیش‌فرض /etc/sgml/catalog را غیرفعال کند.

XML_CATALOG_FILES

رفتار کاتالوگ XML را می‌توان با بازهدایت پرس‌وجوها به مجموعه کاتالوگ‌های اختصاصی کاربر تغییر داد. این کار با تنظیم متغیر محیطی XML_CATALOG_FILES بر روی فهرستی از کاتالوگ‌ها امکان‌پذیر است. یک مقدار خالی باید بارگذاری کاتالوگ پیش‌فرض /etc/xml/catalog را غیرفعال کند.