INSTALL-CATALOG(8) INSTALL-CATALOG(8)

install-catalog - مدیریت یک کاتالوگ متمرکز SGML یا XML

install-catalog [ option ] action ... [ [ -d] [ --delegate] ] [ [ -a centralized ordinary] [ --add centralized ordinary]


[ -r centralized ordinary] [ --remove centralized ordinary]


[ -h] [ --help]


[ -v] [ --version] ]

این اسکریپت شل امکان مدیریت یک کاتالوگ متمرکز را که به کاتالوگ‌های «معمولی» SGML یا XML از نوع Open Catalog ارجاع می‌دهد، فراهم می‌کند.

یک Open Catalog شامل مجموعه‌ای از دستورالعمل‌های تعریف‌شده توسط OASIS است که عمدتاً برای تعریف معادل‌ها میان FPIها (شناسه‌های عمومی رسمی یا Formal Public Identifiers) و نام فایل‌های واقعی استفاده می‌شود (به TR9401:1997 در <URL:http://www.oasis-open.org> مراجعه کنید). کاتالوگ‌های Open Catalog معمولاً در مسیر /usr/share/sgml قرار دارند.

یک کاتالوگ متمرکز (centralized catalog) یک Open Catalog ویژه است که تنها شامل توضیحات (کامنت‌ها) و دستورالعمل‌های CATALOG است که به کاتالوگ‌های دیگر اشاره می‌کنند (یا دستورالعمل‌های DELEGATE در صورت پشتیبانی). کاتالوگ متمرکز می‌تواند کلید دسترسی به تمام منابع SGML دیگر باشد. این کاتالوگ معمولاً در مسیر /etc/sgml قرار دارد.

کاتالوگ متمرکز را می‌توان به‌صورت دستی یا از طریق اسکریپت install-catalog ویرایش کرد تا ارجاع‌ها به کاتالوگ‌های معمولی دیگر اضافه یا حذف شوند. این اسکریپت عمدتاً برای اسکریپت‌های پس از نصب بسته‌های نرم‌افزاری در نظر گرفته شده است.

یک نمونه از فراخوانی متداول install-catalog:

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

این فراخوانی، در مسیر /etc/sgml/sgml-docbook-4.0.cat ارجاعی به /usr/share/sgml/docbook/dsssl-stylesheets-1.54/catalog نصب خواهد کرد.

در اینجا فهرستی از گزینه‌هایی که می‌توانند بر نحوه کارکرد install-catalog تأثیر بگذارند آورده شده است:


[ [ -d] [ --delegate] ]

استفاده از دستورالعمل‌های DELEGATE به‌جای CATALOG برای مشخص کردن یک اشاره‌گر

در اینجا فهرستی از اقداماتی که می‌توان از install-catalog درخواست کرد آورده شده است:


[ [ -a centralized ordinary] [ --add centralized ordinary] ]

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


[ [ -r centralized ordinary] [ --remove centralized ordinary] ]

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


[ [ -h] [ --help] ]

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


[ [ -v] [ --version] ]

چاپ شناسه نسخه و خروج

/etc/sgml/*

کاتالوگ‌های متمرکز SGML

Eric Bischoff <ebisch@cybercable.tm.fr>

توسعه‌دهنده install-catalog.

jw(1)

تبدیل از DocBook به سایر فرمت‌های فایل

nsgmls(1)

یک مولفه پایه از موتور DSSSL با نام Jade

<URL:http://sourceware.cygnus.com/docbook-tools>

صفحه خانگی ابزارهای DocBook، مجموعه‌ای از تمام ابزارهای لازم برای پردازش فایل‌های DocBook، شامل موارد عمومی مربوط به SGML-common.

04 August 2000