'\" t
.\"     Title: xmlcatalog
.\"    Author: John Fleck <jfleck@inkstain.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 09/04/2026
.\"    Manual: xmlcatalog Manual
.\"    Source: libxml2
.\"  Language: Persian
.\"
.TH "XMLCATALOG" "1" "09/04/2026" "libxml2" "xmlcatalog 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)"
xmlcatalog \- ابزار خط فرمان برای تجزیه و دستکاری پرونده‌های کاتالوگ XML یا SGML\&.
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxmlcatalog\fR\ 'u
\fBxmlcatalog\fR [\fB\-\-sgml\fR | \fB\-\-shell\fR | \fB\-\-convert\fR | \fB\-\-create\fR | \fB\-\-del\ \fR\fB\fIVALUE(S)\fR\fR | [\ \fB\-\-add\ \fR\fB\fITYPE\fR\fR\fB\ \fR\fB\fIORIG\fR\fR\fB\ \fR\fB\fIREPLACE\fR\fR\fB\ \fR\ |\ \fB\-\-add\ \fR\fB\fIFILENAME\fR\fR] | \fB\-\-noout\fR | \fB\-\-no\-super\-update\fR | [\fB\-v\fR\ |\ \fB\-\-verbose\fR]] {\fICATALOGFILE\fR} {\fIENTITIES\fR...}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBxmlcatalog\fR
یک برنامه خط فرمانی است که به کاربران اجازه می‌دهد کاتالوگ‌های
XML
و
SGML
را بررسی و دستکاری کنند\&. این برنامه در
\fBlibxml\fR(3)
گنجانده شده است\&.
.PP
عملکردهای آن می‌تواند با یک دستور از خط فرمان فراخوانی شود، یا چندین عملکرد را در حالت تعاملی انجام دهد\&. این برنامه می‌تواند روی هر دو نوع پروندهٔ
XML
و
SGML
کار کند\&.
.SH "گزینهها (OPTIONS)"
.PP
\fBxmlcatalog\fR
گزینه‌های زیر را (به ترتیب الفبا) می‌پذیرد:
.PP
\fB\-\-add \fR\fB\fITYPE\fR\fR\fB \fR\fB\fIORIG\fR\fR\fB \fR\fB\fIREPLACE\fR\fR\fB \fR
.RS 4
یک ورودی به
CATALOGFILE
اضافه می‌کند\&.
\fITYPE\fR
نوع ورودی را مشخص می‌کند\&. نوع‌های ممکن عبارتند از:
\fIpublic\fR, \fIsystem\fR, \fIuri\fR, \fIrewriteSystem\fR, \fIrewriteURI\fR, \fIdelegatePublic\fR, \fIdelegateSystem\fR, \fIdelegateURI\fR, \fInextCatalog\fR\&.
\fIORIG\fR
مرجع اصلی برای جایگزینی است، و
\fIREPLACE\fR
نشانی
URI
موجودیت جایگزینی است که باید استفاده شود\&. گزینهٔ
\fB\-\-add\fR
روی
CATALOGFILE
بازنویسی نمی‌کند و خروجی را به
stdout
می‌فرستد، مگر اینکه از
\fB\-\-noout\fR
استفاده شود\&. گزینهٔ
\fB\-\-add\fR
همواره سه پارامتر می‌گیرد، حتی اگر برخی از ساختارهای کاتالوگ
XML
تنها یک آرگومان داشته باشند\&.
.RE
.PP
\fB\-\-add \fR\fB\fIFILENAME\fR\fR
.RS 4
اگر گزینهٔ
\fB\-\-add\fR
پس از گزینهٔ
\fB\-\-sgml\fR
استفاده شود، تنها یک آرگومان، یعنی یک
\fIFILENAME\fR،
به کار می‌رود\&. این حالت برای افزودن نام یک فایل کاتالوگ به یک اَبَرکاتالوگ
SGML
به کار می‌رود؛ فایلی که شامل ارجاعاتی به سایر فایل‌های کاتالوگ
SGML
گنجانده‌شده است\&.
.RE
.PP
\fB\-\-convert\fR
.RS 4
کاتالوگ SGML را به XML تبدیل می‌کند\&.
.RE
.PP
\fB\-\-create\fR
.RS 4
یک کاتالوگ جدید
XML
ایجاد می‌کند\&. خروجی را به
stdout
می‌فرستد و
\fIfilename\fR
را نادیده می‌گیرد، مگر اینکه از
\fB\-\-noout\fR
استفاده شود که در این صورت یک فایل کاتالوگ جدید به نام
\fIfilename\fR
ایجاد می‌کند\&.
.RE
.PP
\fB\-\-del \fR\fB\fIVALUE(S)\fR\fR
.RS 4
مدخل‌های منطبق با
\fIVALUE(S)\fR
را از
\fICATALOGFILE\fR
حذف می‌کند\&. گزینهٔ
\fB\-\-del\fR
پروندهٔ
\fICATALOGFILE\fR
را بازنویسی نمی‌کند و خروجی را به
stdout
می‌فرستد، مگر اینکه از
\fB\-\-noout\fR
استفاده شود\&.
.RE
.PP
\fB\-\-noout\fR
.RS 4
خروجی را به‌جای ارسال به
stdout
در پروندهٔ مشخص‌شده ذخیره می‌کند\&.
.RE
.PP
\fB\-\-no\-super\-update\fR
.RS 4
ابرکاتالوگ
SGML
را به‌روزرسانی نمی‌کند\&.
.RE
.PP
\fB\-\-shell\fR
.RS 4
پوسته‌ای را اجرا می‌کند که امکان پرس‌وجوی تعاملی روی پروندهٔ کاتالوگ
\fICATALOGFILE\fR
را فراهم می‌سازد\&. برای مشاهدهٔ مجموعه دستورهای دردسترس، به بخش
\(lqSHELL COMMANDS\(rq
مراجعه کنید\&.
.RE
.PP
\fB\-\-sgml\fR
.RS 4
از ابرکاتالوگ‌های
SGML
برای گزینه‌های
\fB\-\-add\fR
و
\fB\-\-del\fR
استفاده می‌کند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
اطلاعات اشکال‌زدایی را نمایش می‌دهد\&.
.RE
.PP
فراخوانی غیرتعاملی
\fBxmlcatalog\fR
بدون یک اقدام مشخص (تعیین‌شده با گزینه‌هایی مانند
\fB\-\-add\fR)
منجر به جستجوی مدخل کاتالوگ برای
\fIENTITIES\fR
در کاتالوگ تعیین‌شده با
\fICATALOGFILE\fR\&
خواهد شد\&. مدخل‌های مربوطه در خط فرمان خروجی داده خواهند شد\&. این حالت عملکردی، به همراه حالت
\fB\-\-shell\fR
و اقدامات مستقیم غیرتغییردهنده (یعنی بدون
\fB\-\-noout\fR)،
امکان میان‌بری ویژه برای مشخص کردن
\fICATALOGFILE\fR
خالی (که احتمالاً در محیط پوسته به شکل "" نشان داده می‌شود) را جهت تعیین کاتالوگ پیش‌فرض سیستم فراهم می‌کند\&. این امر مدیریت را هنگامی که مکان دقیق آن اهمیتی ندارد اما همچنان باید به کاتالوگ توکار مربوطه مراجعه شود، ساده می‌سازد\&.
.SH "دستورات پوسته (SHELL COMMANDS)"
.PP
فراخوانی
\fBxmlcatalog\fR
با گزینهٔ
\fB\-\-shell \fR\fB\fICATALOGFILE\fR\fR
یک پوستهٔ خط فرمانی را باز می‌کند که امکان دسترسی تعاملی به پروندهٔ کاتالوگ مشخص‌شده توسط
\fICATALOGFILE\fR\&
را فراهم می‌سازد\&. فراخوانی این پوسته یک اعلان خط فرمان ارائه می‌دهد که پس از آن می‌توان دستورات زیر را (که به ترتیب الفبا شرح داده شده‌اند) وارد کرد\&.
.PP
\fBadd \fR\fB\fITYPE\fR\fR\fB \fR\fB\fIORIG\fR\fR\fB \fR\fB\fIREPLACE\fR\fR\fB \fR
.RS 4
افزودن یک مدخل به پروندهٔ کاتالوگ\&.
\fITYPE\fR
نوع مدخل را مشخص می‌کند\&. انواع ممکن عبارتند از:
\fIpublic\fR، \fIsystem\fR، \fIuri\fR، \fIrewriteSystem\fR، \fIrewriteURI\fR، \fIdelegatePublic\fR، \fIdelegateSystem\fR، \fIdelegateURI\fR، \fInextCatalog\fR\&.
\fIORIG\fR
مرجع اصلی است که باید جایگزین شود، و
\fIREPLACE\fR
شناسهٔ
URI
موجودیت جایگزین برای استفاده است\&. گزینهٔ
\fB\-\-add\fR
روی
CATALOGFILE
بازنویسی نخواهد کرد و خروجی را به
stdout
می‌فرستد، مگر اینکه از
\fB\-\-noout\fR
استفاده شود\&. گزینهٔ
\fB\-\-add\fR
همواره سه پارامتر دریافت می‌کند، حتی اگر برخی از ساختارهای کاتالوگ
XML
تنها دارای یک آرگومان باشند\&.
.RE
.PP
\fBdebug\fR
.RS 4
چاپ پیام‌های اشکال‌زدایی که مراحل در حال اجرای
\fBxmlcatalog\fR
را نشان می‌دهند\&.
.RE
.PP
\fBdel \fR\fB\fIVALUE(S)\fR\fR
.RS 4
مدخل کاتالوگ متناظر با
\fIVALUE(S)\fR
را حذف می‌کند\&.
.RE
.PP
\fBdump\fR
.RS 4
کاتالوگ فعلی را چاپ می‌کند\&.
.RE
.PP
\fBexit\fR
.RS 4
از پوسته خارج می‌شود\&.
.RE
.PP
\fBpublic \fR\fB\fIPUBLIC\-ID\fR\fR
.RS 4
یک جستجوی شناسه عمومی رسمی (Formal Public Identifier) را برای مدخل کاتالوگِ
\fIPUBLIC\-ID\fR
اجرا می‌کند\&. مدخل متناظر در خط فرمان خروجی داده خواهد شد\&.
.RE
.PP
\fBquiet\fR
.RS 4
چاپ عبارت‌های اشکال‌زدایی را متوقف می‌کند\&.
.RE
.PP
\fBsystem \fR\fB\fISYSTEM\-ID\fR\fR
.RS 4
یک جستجوی شناسه عمومی رسمی (Formal Public Identifier) را برای مدخل کاتالوگِ
\fISYSTEM\-ID\fR
اجرا می‌کند\&. مدخل متناظر در خط فرمان خروجی داده خواهد شد\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT)"
.PP
\fBXML_CATALOG_FILES\fR
.RS 4
رفتار کاتالوگ
XML
را می‌توان با تغییر مسیر پرس‌وجوها به مجموعه کاتالوگ‌های خود کاربر تغییر داد\&. این کار با تنظیم متغیر محیطی
\fBXML_CATALOG_FILES\fR
روی فهرستی از کاتالوگ‌ها که با فاصله از هم جدا شده‌اند انجام می‌شود\&. برای گریز از فاصله‌ها یا نویسه‌های دیگر از percent\-encoding استفاده کنید\&. یک متغیر خالی باید بارگذاری کاتالوگ پیش‌فرض از
/etc/xml/catalog
یا به‌طور مشخص‌تر،
${sysconfdir}/xml/catalog
را غیرفعال کند\&.
.RE
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
کدهای بازگشتی
\fBxmlcatalog\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
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBlibxml\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/libxml2\fR\m[]
.RE
.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/libxml2/-/wikis/Catalog-support\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه کاتالوگ SGML اثر James Clark
\m[blue]\fB\%http://www.jclark.com/sp/catalog.htm\fR\m[]
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مشخصات کاتالوگ OASIS XML
\m[blue]\fB\%http://www.oasis-open.org/committees/entity/spec.html\fR\m[]
.RE
.sp
.SH "نویسندگان (AUTHORS)"
.PP
\fBJohn Fleck\fR <\&jfleck@inkstain\&.net\&>
.RS 4
.RE
.SH "حق نشر (COPYRIGHT)"
.br
حق نشر \(co 2001, 2004
.br