.\" Hey, Emacs! This is an -*- nroff -*- source file. .\" .\" Copyright (C) 2025 Karl Berry .\" Copyright (C) 2004, 2012 Hilmar Preusse .\" Copyright (C) 2012 Norbert Preining .\" .\" This is free software; you can redistribute it and/or modify it under .\" the terms of the GNU General Public License as published by the Free .\" Software Foundation; either version 2, or (at your option) any later .\" version. .\" .\" This is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. if not, see . .\" .TH "UPDMAP.CFG" "5" "19 February 2025" "TeX Live" "TeX Live" .SH "نام (NAME)" \fBupdmap.cfg\fR \- پیکربندی نگاشت/گنجاندن قلم‌ها برای dvips و برنامه‌های مرتبط .SH "توضیحات (DESCRIPTION)" فایل \fBupdmap.cfg\fR فایل مرکزی پیکربندی قلم در یک سیستم teTeX است و توسط \fBupdmap\fP(1) خوانده می‌شود. این فایل توصیف می‌کند که آیا قلم‌ها باید در فایل‌های خروجی PS/PDF گنجانده شوند (یا نشوند) و چگونه این کار انجام شود. این سازوکار برای قلم‌های برداری (Postscript Type1) و قلم‌های بیت‌مپ (Postscript Type3) که بیشتر از Metafont می‌آیند، کار می‌کند. .PP ابزار \fBupdmap\fP برنامه‌ای است که فایل‌های پیکربندی قلم را برای \fBdvips\fP(1)، \fBpdftex\fP(1)، \fBxdvi\fP(1)، \fBps2pk\fP(1)، \fBgsftopk\fP(1) و \fBdvipdfmx\fP(1) ایجاد می‌کند. در یک دنیای ایده‌آل، نیازی به updmap نبود و هر یک از این برنامه‌ها همان فایل پیکربندی یکسان را می‌خواندند تا متوجه شوند چه قلم‌هایی در دسترس هستند و چگونه باید با آن‌ها رفتار شود. با این حال، در وضعیت فعلی، هر یک از این ابزارها الزامات اندکی متفاوت دارند و در نتیجه به فایل پیکربندی قلم اختصاصی خود نیاز دارند. \fBupdmap\fP فایل‌های پیکربندی قلم را برای همه این برنامه‌ها از چندین منبع، یعنی تمام فایل‌های \fBupdmap.cfg\fR ایجاد می‌کند، و به شما اجازه می‌دهد تا تمام فایل‌های پیکربندی گوناگون را به‌راحتی هماهنگ (sync) نگه دارید. .P اجرای "updmap \-\-help" مستندات اصلی مربوط به استفاده از \fBupdmap\fR را نمایش خواهد داد. .P \fBdvipsPreferOutline\fR .br پیکربندی می‌کند که آیا \fBdvips\fR (به‌طور پیش‌فرض) در صورت در دسترس بودن هر دو نوع قلم، باید قلم‌های بیت‌مپ را ترجیح دهد یا قلم‌های برداری را. مستقل از این تنظیم، می‌توان با قرار دادن "p psfonts_t1.map" در فایل پیکربندی که dvips می‌خواند، استفاده از قلم‌های برداری را اجباری کرد. همچنین می‌توان با قرار دادن "p psfonts_pk.map" در یک فایل پیکربندی، قلم‌های بیت‌مپ را اجباری نمود. ما چنین فایل‌های پیکربندی را ارائه می‌دهیم که می‌توان آن‌ها را از طریق \fBdvips\fR \fI-Poutline\fR (یا \fBdvips\fR \fI-Ppk\fR) فعال کرد. .br تنظیمات معتبر برای dvipsPreferOutline عبارتند از \fItrue\fR / \fIfalse\fR. .P \fBLW35\fR .br کدام قلم‌ها از "Basic 35 Laserwriter Fonts" را می‌خواهید استفاده کنید و نام فایل‌ها چگونه انتخاب شوند؟ تنظیمات معتبر: .br URW: قلم‌های URW با نام فایل‌های ارائه‌دهنده (vendor) (مانند n019064l.pfb) .br URWkb: قلم‌های URW با نام فایل‌های "berry" (مانند uhvbo8ac.pfb) .br ADOBE: قلم‌های Adobe با نام فایل‌های ارائه‌دهنده (مانند hvnbo___.pfb) .br ADOBEkb: قلم‌های Adobe با نام فایل‌های "berry" (مانند phvbo8an.pfb) .P \fBdvipsDownloadBase35\fR .br پیکربندی می‌کند که آیا \fBdvips\fR (به‌طور پیش‌فرض) باید ۳۵ قلم پایه PostScript را درون سند بارگیری کند (تنظیم \fItrue\fR) یا این قلم‌ها باید از مفسر یا چاپگر PostScript استفاده شوند (تنظیم \fIfalse\fR). .br کاربر می‌تواند پیش‌فرض را با مشخص کردن \fBdvips\fR \fI-Pdownload35\fR (جهت بارگیری قلم‌های LW35) یا \fBdvips\fR \fI-Pbuiltin35\fR (جهت استفاده از قلم‌های توکار) بازنویسی کند. .br تنظیمات معتبر \fItrue\fR / \fIfalse\fR هستند. .P \fBpdftexDownloadBase14\fR .br آیا \fBpdftex\fR باید ۱۴ قلم پایه PDF را بارگیری کند؟ از آنجا که برخی پیکربندی‌ها (ابزارهای ps / pdf / چاپگرها) از قلم‌های پیش‌فرض نامناسب استفاده می‌کنند، ایمن‌تر است که قلم‌ها بارگیری شوند. حجم فایل‌های pdf بیشتر می‌شود، اما این هزینه آن است. .br تنظیمات معتبر عبارتند از \fItrue\fR (بارگیری قلم‌ها) یا \fIfalse\fR (عدم بارگیری قلم‌ها). ادوبی تعبیه (embed) کردن تمام قلم‌ها را توصیه می‌کند. .P \fBpxdviUse\fR .br آیا باید فایل‌های نگاشت اختصاصی برای pxdvi ایجاد شوند؟ pxdvi نسخه‌ای از xdvi با پشتیبانی از خواندن و نمایش فایل‌های تولیدشده توسط خانواده موتورهای ptex است. .br تنظیمات معتبر عبارتند از \fItrue\fR (تولید پیکربندی) یا \fIfalse\fR. برای بحث تفصیلی نشانی http://www.tug.org/texlive/updmap-kanji.html را ببینید. .P \fBkanjiEmbed\fR .br \fBkanjiVariant\fR .br گزینه‌های \fBkanjiEmbed\fR و \fBkanjiVariant\fR جایگزینی‌های خاصی را در خطوط نگاشت مشخص می‌کنند. در یک نگاشت، رشته "@kanjiEmbed@" با مقدار آن گزینه جایگزین خواهد شد؛ به همین ترتیب برای \fBkanjiVariant\fR. به این ترتیب، کاربران TeX ژاپنی می‌توانند قلم‌های متفاوتی را برای گنجاندن در خروجی نهایی انتخاب کنند. .P \fBMap\fR .br به یک فایل نگاشت اشاره می‌کند، که نگاشت از یک قلم (فراخوانی‌شده در سند TeX) به فایل pfb حاوی کد Postscript را توصیف می‌نماید. .br نحوه استفاده: \fBMap\fR filename.map .P سینتکس فایل‌های نگاشت همانند سینتکس مورد استفاده در \fBdvips\fP(1) است؛ بخش "psfonts.map" را در راهنمای \fBdvips\fP(1) مشاهده کنید. .P \fBMixedMap\fR .br مشابه \fBMap\fR. زمانی باید استفاده شود که هم پیاده‌سازی Type1 و هم پیاده‌سازی بیت‌مپ از قلم وجود داشته باشد (مورد دوم بیشتر از Metafont می‌آید). در صورتی که \fBdvipsPreferOutline\fR روی \fIfalse\fR تنظیم شده باشد، این مدخل‌ها در نگاشت پیش‌فرض \fBdvips\fR استفاده نخواهند شد. .br نحوه استفاده: \fBMixedMap\fR filename.map .P \fBKanjiMap\fR .br مشابه \fBMap\fR. این گزینه باید برای قلم‌های کانجی استفاده شود. .br نحوه استفاده: \fBKanjiMap\fR filename.map .P علامت \fB#\fR در ابتدای یک نظر (کامنت) قرار می‌گیرد. .P فایل‌های نگاشتی که نباید استفاده شوند، باید با استفاده از رشته \fB#!\fR در ابتدای خط کامنت شوند. چنین مدخل‌هایی را می‌توان با استفاده از \fBupdmap\fR با گزینه‌های \fI--enable\fR و \fI--disable\fR به‌ترتیب (غیر)فعال کرد. .SH "همچنین ببینید (SEE ALSO)" updmap(1), dvips(1). .SH "سپاسگزاری (THANKS TO)" Frank Kuester, Thomas Esser. .SH "نویسندگان (AUTHORS)" این صفحه راهنما توسط Hilmar Preusse نوشته شده و توسط Norbert Preining برای سیستم دبیان گنو/لینوکس با رونوشت‌برداری ساده از نظرات درون \fBupdmap.cfg\fR و بازنویسی برخی از آن‌ها گسترش یافته است. این سند می‌تواند توسط سایر توزیع‌ها بدون نیاز به تماس با نویسنده استفاده شود. .SH "گزارش اشکالات (BUGS)" .PP گزارش‌های اشکال را به نشانی (فهرست پستی عمومی) ایمیل کنید.