.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "INSTALL-CATALOG" "8" "04 August 2000" "" ""
.SH "نام (NAME)"
install-catalog \- مدیریت یک کاتالوگ متمرکز SGML یا XML
.SH "خلاصه دستور (SYNOPSIS)"

\fBinstall-catalog\fR [ \fBoption \fR]  \fBaction \fR\fI ...\fR [ \fB [ -d]  [ --delegate] \fR]  [ \fB [ -a \fIcentralized\fB \fIordinary\fB]  [ --add \fIcentralized\fB \fIordinary\fB]

 [ -r \fIcentralized\fB \fIordinary\fB]  [ --remove \fIcentralized\fB \fIordinary\fB]

 [ -h]  [ --help]

 [ -v]  [ --version] \fR]

.SH "شرح (DESCRIPTION)"
.PP
این اسکریپت شل امکان مدیریت یک کاتالوگ متمرکز
را که به کاتالوگ‌های «معمولی» SGML یا XML از نوع Open Catalog ارجاع می‌دهد، فراهم می‌کند.
.PP
یک \fIOpen Catalog\fR شامل
مجموعه‌ای از دستورالعمل‌های تعریف‌شده توسط OASIS است که عمدتاً
برای تعریف معادل‌ها میان FPIها (شناسه‌های عمومی رسمی یا Formal Public Identifiers)
و نام فایل‌های واقعی استفاده می‌شود (به TR9401:1997 در <URL:http://www.oasis-open.org> مراجعه کنید).
کاتالوگ‌های Open Catalog معمولاً در مسیر
\fI/usr/share/sgml\fR قرار دارند.
.PP
یک \fIکاتالوگ متمرکز (centralized catalog)\fR یک Open Catalog
ویژه است که تنها شامل توضیحات (کامنت‌ها) و دستورالعمل‌های CATALOG است که
به کاتالوگ‌های دیگر اشاره می‌کنند (یا دستورالعمل‌های DELEGATE در صورت پشتیبانی).
کاتالوگ متمرکز می‌تواند کلید دسترسی به تمام منابع SGML دیگر باشد. این کاتالوگ
معمولاً در مسیر \fI/etc/sgml\fR قرار دارد.
.PP
کاتالوگ متمرکز را می‌توان به‌صورت دستی یا از طریق اسکریپت
\fBinstall-catalog\fR ویرایش کرد تا ارجاع‌ها به کاتالوگ‌های
معمولی دیگر اضافه یا حذف شوند. این اسکریپت عمدتاً برای
اسکریپت‌های پس از نصب بسته‌های نرم‌افزاری در نظر گرفته شده است.
.PP
یک نمونه از فراخوانی متداول install-catalog:

.nf
      install-catalog --add \\
        /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog \\
        /etc/sgml/sgml-docbook-4.0.cat

.fi
.PP
این فراخوانی، در مسیر
\fI/etc/sgml/sgml-docbook-4.0.cat\fR ارجاعی به
\fI/usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog\fR نصب خواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.PP
در اینجا فهرستی از گزینه‌هایی که می‌توانند بر نحوه کارکرد
\fBinstall-catalog\fR تأثیر بگذارند آورده شده است:

 [ \fB [ -d]  [ --delegate] \fR]

.PP
استفاده از دستورالعمل‌های DELEGATE به‌جای CATALOG برای مشخص کردن یک اشاره‌گر
.SH "اقدامات (ACTIONS)"
.PP
در اینجا فهرستی از اقداماتی که می‌توان از
\fBinstall-catalog\fR درخواست کرد آورده شده است:

 [ \fB [ -a \fIcentralized\fB \fIordinary\fB]  [ --add \fIcentralized\fB \fIordinary\fB] \fR]

.PP
اعلان یک بسته جدید SGML.

 [ \fB [ -r \fIcentralized\fB \fIordinary\fB]  [ --remove \fIcentralized\fB \fIordinary\fB] \fR]

.PP
حذف یک بسته SGML که قبلاً نصب شده است.

 [ \fB [ -h]  [ --help] \fR]

.PP
چاپ یک پیام راهنمای کوتاه و خروج

 [ \fB [ -v]  [ --version] \fR]

.PP
چاپ شناسه نسخه و خروج
.SH "فایل‌ها (FILES)"
\fI/etc/sgml/*\fR
.PP
کاتالوگ‌های متمرکز SGML
.SH "نویسندگان (AUTHORS)"
Eric Bischoff <ebisch@cybercable.tm.fr>
.PP
توسعه‌دهنده install-catalog.
.SH "همچنین ببینید (SEE ALSO)"
\fBjw\fR(1)
.PP
تبدیل از DocBook به سایر فرمت‌های فایل

\fB\fR

\fBnsgmls\fR(1)
.PP
یک مولفه پایه از موتور DSSSL با نام \fBJade\fR

\fB\fR

<URL:http://sourceware.cygnus.com/docbook-tools>
.PP
صفحه خانگی ابزارهای DocBook، مجموعه‌ای از
تمام ابزارهای لازم برای پردازش فایل‌های DocBook، شامل
موارد عمومی مربوط به SGML-common.