نام (NAME)

updmap.cfg - پیکربندی نگاشت/گنجاندن قلم‌ها برای dvips و برنامه‌های مرتبط

توضیحات (DESCRIPTION)

فایل updmap.cfg فایل مرکزی پیکربندی قلم در یک سیستم teTeX است و توسط updmap(1) خوانده می‌شود. این فایل توصیف می‌کند که آیا قلم‌ها باید در فایل‌های خروجی PS/PDF گنجانده شوند (یا نشوند) و چگونه این کار انجام شود. این سازوکار برای قلم‌های برداری (Postscript Type1) و قلم‌های بیت‌مپ (Postscript Type3) که بیشتر از Metafont می‌آیند، کار می‌کند.

ابزار updmap برنامه‌ای است که فایل‌های پیکربندی قلم را برای dvips(1)، pdftex(1)، xdvi(1)، ps2pk(1)، gsftopk(1) و dvipdfmx(1) ایجاد می‌کند. در یک دنیای ایده‌آل، نیازی به updmap نبود و هر یک از این برنامه‌ها همان فایل پیکربندی یکسان را می‌خواندند تا متوجه شوند چه قلم‌هایی در دسترس هستند و چگونه باید با آن‌ها رفتار شود. با این حال، در وضعیت فعلی، هر یک از این ابزارها الزامات اندکی متفاوت دارند و در نتیجه به فایل پیکربندی قلم اختصاصی خود نیاز دارند. updmap فایل‌های پیکربندی قلم را برای همه این برنامه‌ها از چندین منبع، یعنی تمام فایل‌های updmap.cfg ایجاد می‌کند، و به شما اجازه می‌دهد تا تمام فایل‌های پیکربندی گوناگون را به‌راحتی هماهنگ (sync) نگه دارید.

اجرای "updmap --help" مستندات اصلی مربوط به استفاده از updmap را نمایش خواهد داد.

dvipsPreferOutline
پیکربندی می‌کند که آیا dvips (به‌طور پیش‌فرض) در صورت در دسترس بودن هر دو نوع قلم، باید قلم‌های بیت‌مپ را ترجیح دهد یا قلم‌های برداری را. مستقل از این تنظیم، می‌توان با قرار دادن "p psfonts_t1.map" در فایل پیکربندی که dvips می‌خواند، استفاده از قلم‌های برداری را اجباری کرد. همچنین می‌توان با قرار دادن "p psfonts_pk.map" در یک فایل پیکربندی، قلم‌های بیت‌مپ را اجباری نمود. ما چنین فایل‌های پیکربندی را ارائه می‌دهیم که می‌توان آن‌ها را از طریق dvips -Poutline (یا dvips -Ppk) فعال کرد.
تنظیمات معتبر برای dvipsPreferOutline عبارتند از true / false.

LW35
کدام قلم‌ها از "Basic 35 Laserwriter Fonts" را می‌خواهید استفاده کنید و نام فایل‌ها چگونه انتخاب شوند؟ تنظیمات معتبر:
URW: قلم‌های URW با نام فایل‌های ارائه‌دهنده (vendor) (مانند n019064l.pfb)
URWkb: قلم‌های URW با نام فایل‌های "berry" (مانند uhvbo8ac.pfb)
ADOBE: قلم‌های Adobe با نام فایل‌های ارائه‌دهنده (مانند hvnbo___.pfb)
ADOBEkb: قلم‌های Adobe با نام فایل‌های "berry" (مانند phvbo8an.pfb)

dvipsDownloadBase35
پیکربندی می‌کند که آیا dvips (به‌طور پیش‌فرض) باید ۳۵ قلم پایه PostScript را درون سند بارگیری کند (تنظیم true) یا این قلم‌ها باید از مفسر یا چاپگر PostScript استفاده شوند (تنظیم false).
کاربر می‌تواند پیش‌فرض را با مشخص کردن dvips -Pdownload35 (جهت بارگیری قلم‌های LW35) یا dvips -Pbuiltin35 (جهت استفاده از قلم‌های توکار) بازنویسی کند.
تنظیمات معتبر true / false هستند.

pdftexDownloadBase14
آیا pdftex باید ۱۴ قلم پایه PDF را بارگیری کند؟ از آنجا که برخی پیکربندی‌ها (ابزارهای ps / pdf / چاپگرها) از قلم‌های پیش‌فرض نامناسب استفاده می‌کنند، ایمن‌تر است که قلم‌ها بارگیری شوند. حجم فایل‌های pdf بیشتر می‌شود، اما این هزینه آن است.
تنظیمات معتبر عبارتند از true (بارگیری قلم‌ها) یا false (عدم بارگیری قلم‌ها). ادوبی تعبیه (embed) کردن تمام قلم‌ها را توصیه می‌کند.

pxdviUse
آیا باید فایل‌های نگاشت اختصاصی برای pxdvi ایجاد شوند؟ pxdvi نسخه‌ای از xdvi با پشتیبانی از خواندن و نمایش فایل‌های تولیدشده توسط خانواده موتورهای ptex است.
تنظیمات معتبر عبارتند از true (تولید پیکربندی) یا false. برای بحث تفصیلی نشانی http://www.tug.org/texlive/updmap-kanji.html را ببینید.

kanjiEmbed
kanjiVariant
گزینه‌های kanjiEmbed و kanjiVariant جایگزینی‌های خاصی را در خطوط نگاشت مشخص می‌کنند. در یک نگاشت، رشته "@kanjiEmbed@" با مقدار آن گزینه جایگزین خواهد شد؛ به همین ترتیب برای kanjiVariant. به این ترتیب، کاربران TeX ژاپنی می‌توانند قلم‌های متفاوتی را برای گنجاندن در خروجی نهایی انتخاب کنند.

Map
به یک فایل نگاشت اشاره می‌کند، که نگاشت از یک قلم (فراخوانی‌شده در سند TeX) به فایل pfb حاوی کد Postscript را توصیف می‌نماید.
نحوه استفاده: Map filename.map

سینتکس فایل‌های نگاشت همانند سینتکس مورد استفاده در dvips(1) است؛ بخش "psfonts.map" را در راهنمای dvips(1) مشاهده کنید.

MixedMap
مشابه Map. زمانی باید استفاده شود که هم پیاده‌سازی Type1 و هم پیاده‌سازی بیت‌مپ از قلم وجود داشته باشد (مورد دوم بیشتر از Metafont می‌آید). در صورتی که dvipsPreferOutline روی false تنظیم شده باشد، این مدخل‌ها در نگاشت پیش‌فرض dvips استفاده نخواهند شد.
نحوه استفاده: MixedMap filename.map

KanjiMap
مشابه Map. این گزینه باید برای قلم‌های کانجی استفاده شود.
نحوه استفاده: KanjiMap filename.map

علامت # در ابتدای یک نظر (کامنت) قرار می‌گیرد.

فایل‌های نگاشتی که نباید استفاده شوند، باید با استفاده از رشته #! در ابتدای خط کامنت شوند. چنین مدخل‌هایی را می‌توان با استفاده از updmap با گزینه‌های --enable و --disable به‌ترتیب (غیر)فعال کرد.

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

updmap(1), dvips(1).

سپاسگزاری (THANKS TO)

Frank Kuester, Thomas Esser.

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

این صفحه راهنما توسط Hilmar Preusse <hille42@web.de> نوشته شده و توسط Norbert Preining <preining@logic.at> برای سیستم دبیان گنو/لینوکس با رونوشت‌برداری ساده از نظرات درون updmap.cfg و بازنویسی برخی از آن‌ها گسترش یافته است. این سند می‌تواند توسط سایر توزیع‌ها بدون نیاز به تماس با نویسنده استفاده شود.

گزارش اشکالات (BUGS)

گزارش‌های اشکال را به نشانی https://lists.tug.org/tex-k (فهرست پستی عمومی) ایمیل کنید.