نام (NAME)

fc-cache - ساخت فایل‌های کَش اطلاعات قلم

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

fc-cache [ -EfrsvVh ] [ --error-on-no-fonts ] [ --force ] [ --really-force ] [ -y dir | --sysroot dir ] [ --system-only ] [ --verbose ] [ --version ] [ --help ] [ dir ... ]

توضیحات (DESCRIPTION)

دستور fc-cache دایرکتوری‌های قلم را در سیستم پویش کرده و برای برنامه‌هایی که از fontconfig جهت مدیریت قلم‌های خود بهره می‌برند، فایل‌های کَش اطلاعات قلم را می‌سازد.

در صورتی که آرگومان‌های دایرکتوری مشخص نشده باشند، fc-cache از تک‌تک دایرکتوری‌های موجود در پیکربندی جاری قلم استفاده می‌کند. هر دایرکتوری برای یافتن فایل‌های قلمِ قابل خواندن توسط FreeType پویش می‌شود. یک کَش ایجاد می‌گردد که شامل ویژگی‌های هر قلم و نام فایل مربوط به آن است. این کَش برای افزایش سرعت راه‌اندازی برنامه‌ها در زمان استفاده از کتابخانه fontconfig به کار می‌رود.

توجه داشته باشید که fc-cache باید برای هر معماری یک‌بار اجرا شود تا اطلاعات قلمِ سفارشی‌شده برای همان معماری تولید گردد.

گزینه‌ها (OPTIONS)

این برنامه از قواعد معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است:

-E --error-on-no-fonts

در صورتی که قلمی در dir یا (در صورت مشخص نشدن آن) در دایرکتوری‌های پیکربندی وجود نداشته باشد، خطا صادر می‌کند.

-f --force

تولید مجدد فایل‌های کَشی را که ظاهراً به‌روز هستند تحمیل کرده و بررسی برچسب زمانی (timestamp) را نادیده می‌گیرد.

-r --really-force

تمام فایل‌های کَش موجود را پاک کرده و دوباره پویش می‌کند.

-s --system-only

تنها دایرکتوری‌های سراسری سیستم را پویش کرده و مسیرهای واقع در دایرکتوری خانگی کاربر را نادیده می‌گیرد.

-v --verbose

اطلاعات وضعیت را در حین انجام کار نمایش می‌دهد.

-y -sysroot dir

مسیر dir را به ابتدای تمام مسیرها جهت پویش اضافه می‌کند.

-h --help

خلاصه‌ای از گزینه‌ها را نمایش می‌دهد.

-V --version

نسخه برنامه را نمایش داده و خارج می‌شود.

dir

دایرکتوری مورد نظر برای پویش قلم‌ها.

وضعیت خروج (EXIT STATUS)

در صورتی که کَش‌ها با موفقیت ایجاد شوند، fc-cache مقدار صفر و در غیر این صورت مقداری غیرصفر بازمی‌گرداند.

فایل‌ها (FILES)

%cachedir%/*-%arch%.cache-%version%

این فایل‌ها توسط fc-cache تولید شده و شامل نگاشت‌هایی از نام فایل‌ها به ویژگی‌های قلم هستند. این فایل‌ها هنگام راه‌اندازی برنامه توسط کتابخانه fontconfig برای یافتن قلم‌های مناسب خوانده می‌شوند.

همچنین ببینید (SEE ALSO)

fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)

راهنمای کاربری fontconfig در <URL:https://fontconfig.pages.freedesktop.org/fontconfig/fontconfig-user.html>

نویسندگان (AUTHORS)

این صفحه راهنما توسط Keith Packard <keithp@keithp.com> و Josselin Mouette <joss@debian.org> نوشته شده است.