نام (NAME)

xmlcatalog - ابزار خط فرمان برای تجزیه و دستکاری پرونده‌های کاتالوگ XML یا SGML.

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

xmlcatalog [--sgml | --shell | --convert | --create | --del VALUE(S) | [ --add TYPE ORIG REPLACE | --add FILENAME] | --noout | --no-super-update | [-v | --verbose]] {CATALOGFILE} {ENTITIES...}

توضیحات (DESCRIPTION)

xmlcatalog یک برنامه خط فرمانی است که به کاربران اجازه می‌دهد کاتالوگ‌های XML و SGML را بررسی و دستکاری کنند. این برنامه در libxml(3) گنجانده شده است.

عملکردهای آن می‌تواند با یک دستور از خط فرمان فراخوانی شود، یا چندین عملکرد را در حالت تعاملی انجام دهد. این برنامه می‌تواند روی هر دو نوع پروندهٔ XML و SGML کار کند.

گزینهها (OPTIONS)

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

--add TYPE ORIG REPLACE

یک ورودی به CATALOGFILE اضافه می‌کند. TYPE نوع ورودی را مشخص می‌کند. نوع‌های ممکن عبارتند از: public, system, uri, rewriteSystem, rewriteURI, delegatePublic, delegateSystem, delegateURI, nextCatalog. ORIG مرجع اصلی برای جایگزینی است، و REPLACE نشانی URI موجودیت جایگزینی است که باید استفاده شود. گزینهٔ --add روی CATALOGFILE بازنویسی نمی‌کند و خروجی را به stdout می‌فرستد، مگر اینکه از --noout استفاده شود. گزینهٔ --add همواره سه پارامتر می‌گیرد، حتی اگر برخی از ساختارهای کاتالوگ XML تنها یک آرگومان داشته باشند.

--add FILENAME

اگر گزینهٔ --add پس از گزینهٔ --sgml استفاده شود، تنها یک آرگومان، یعنی یک FILENAME، به کار می‌رود. این حالت برای افزودن نام یک فایل کاتالوگ به یک اَبَرکاتالوگ SGML به کار می‌رود؛ فایلی که شامل ارجاعاتی به سایر فایل‌های کاتالوگ SGML گنجانده‌شده است.

--convert

کاتالوگ SGML را به XML تبدیل می‌کند.

--create

یک کاتالوگ جدید XML ایجاد می‌کند. خروجی را به stdout می‌فرستد و filename را نادیده می‌گیرد، مگر اینکه از --noout استفاده شود که در این صورت یک فایل کاتالوگ جدید به نام filename ایجاد می‌کند.

--del VALUE(S)

مدخل‌های منطبق با VALUE(S) را از CATALOGFILE حذف می‌کند. گزینهٔ --del پروندهٔ CATALOGFILE را بازنویسی نمی‌کند و خروجی را به stdout می‌فرستد، مگر اینکه از --noout استفاده شود.

--noout

خروجی را به‌جای ارسال به stdout در پروندهٔ مشخص‌شده ذخیره می‌کند.

--no-super-update

ابرکاتالوگ SGML را به‌روزرسانی نمی‌کند.

--shell

پوسته‌ای را اجرا می‌کند که امکان پرس‌وجوی تعاملی روی پروندهٔ کاتالوگ CATALOGFILE را فراهم می‌سازد. برای مشاهدهٔ مجموعه دستورهای دردسترس، به بخش “SHELL COMMANDS” مراجعه کنید.

--sgml

از ابرکاتالوگ‌های SGML برای گزینه‌های --add و --del استفاده می‌کند.

-v, --verbose

اطلاعات اشکال‌زدایی را نمایش می‌دهد.

فراخوانی غیرتعاملی xmlcatalog بدون یک اقدام مشخص (تعیین‌شده با گزینه‌هایی مانند --add) منجر به جستجوی مدخل کاتالوگ برای ENTITIES در کاتالوگ تعیین‌شده با CATALOGFILE خواهد شد. مدخل‌های مربوطه در خط فرمان خروجی داده خواهند شد. این حالت عملکردی، به همراه حالت --shell و اقدامات مستقیم غیرتغییردهنده (یعنی بدون --noout)، امکان میان‌بری ویژه برای مشخص کردن CATALOGFILE خالی (که احتمالاً در محیط پوسته به شکل "" نشان داده می‌شود) را جهت تعیین کاتالوگ پیش‌فرض سیستم فراهم می‌کند. این امر مدیریت را هنگامی که مکان دقیق آن اهمیتی ندارد اما همچنان باید به کاتالوگ توکار مربوطه مراجعه شود، ساده می‌سازد.

دستورات پوسته (SHELL COMMANDS)

فراخوانی xmlcatalog با گزینهٔ --shell CATALOGFILE یک پوستهٔ خط فرمانی را باز می‌کند که امکان دسترسی تعاملی به پروندهٔ کاتالوگ مشخص‌شده توسط CATALOGFILE را فراهم می‌سازد. فراخوانی این پوسته یک اعلان خط فرمان ارائه می‌دهد که پس از آن می‌توان دستورات زیر را (که به ترتیب الفبا شرح داده شده‌اند) وارد کرد.

add TYPE ORIG REPLACE

افزودن یک مدخل به پروندهٔ کاتالوگ. TYPE نوع مدخل را مشخص می‌کند. انواع ممکن عبارتند از: public، system، uri، rewriteSystem، rewriteURI، delegatePublic، delegateSystem، delegateURI، nextCatalog. ORIG مرجع اصلی است که باید جایگزین شود، و REPLACE شناسهٔ URI موجودیت جایگزین برای استفاده است. گزینهٔ --add روی CATALOGFILE بازنویسی نخواهد کرد و خروجی را به stdout می‌فرستد، مگر اینکه از --noout استفاده شود. گزینهٔ --add همواره سه پارامتر دریافت می‌کند، حتی اگر برخی از ساختارهای کاتالوگ XML تنها دارای یک آرگومان باشند.

debug

چاپ پیام‌های اشکال‌زدایی که مراحل در حال اجرای xmlcatalog را نشان می‌دهند.

del VALUE(S)

مدخل کاتالوگ متناظر با VALUE(S) را حذف می‌کند.

dump

کاتالوگ فعلی را چاپ می‌کند.

exit

از پوسته خارج می‌شود.

public PUBLIC-ID

یک جستجوی شناسه عمومی رسمی (Formal Public Identifier) را برای مدخل کاتالوگِ PUBLIC-ID اجرا می‌کند. مدخل متناظر در خط فرمان خروجی داده خواهد شد.

quiet

چاپ عبارت‌های اشکال‌زدایی را متوقف می‌کند.

system SYSTEM-ID

یک جستجوی شناسه عمومی رسمی (Formal Public Identifier) را برای مدخل کاتالوگِ SYSTEM-ID اجرا می‌کند. مدخل متناظر در خط فرمان خروجی داده خواهد شد.

متغیرهای محیطی (ENVIRONMENT)

XML_CATALOG_FILES

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