INSTALL-TL(1) User Contributed Perl Documentation INSTALL-TL(1)

install-tl - نصب‌کننده چندسکویی TeX Live

install-tl [گزینه]...

install-tl-windows.bat [گزینه]...

این نصب‌کننده یک نسخه اجرایی از TeX Live را از رسانه‌های مختلف، شامل شبکه، دیسک سخت محلی، DVD و غیره ایجاد می‌کند. این نصب‌کننده روی تمام سکوهای پشتیبانی‌شده توسط TeX Live کار می‌کند. برای کسب اطلاعات درباره دریافت اولیه TeX Live، به https://tug.org/texlive/acquire.html مراجعه کنید.

ایده بنیادین نصب TeX Live بر این است که یکی از طرح‌ها (schemes) سطح بالا را انتخاب کنید؛ هر یک از این طرح‌ها شامل مجموعه‌ای از مجموعه‌ها (collections) و بسته‌ها (packages) تعریف شده است، که در آن هر مجموعه دربرگیرنده گروهی از بسته‌هاست و هر بسته حاوی فایل‌های واقعی است. هر بسته دقیقاً در یک مجموعه قرار دارد، در حالی که طرح‌ها می‌توانند ترکیبی دلخواه از بسته‌ها و مجموعه‌ها باشند.

در داخل محیط نصب‌کننده، می‌توانید یک طرح را برگزینید و مجموعه بسته‌های نصبی را سفارشی‌سازی کنید، اما نمی‌توانید بسته‌های درون مجموعه‌ها را تک‌به‌تک انتخاب نمایید. برای کار در سطح بسته‌ها، پس از اتمام نصب اولیه از "tlmgr" (اشاره‌شده در ادامه) استفاده کنید.

طرح پیش‌فرض "scheme-full" است که تمام اجزا را نصب می‌کند و اکیداً توصیه می‌شود.

پیکربندی پس از نصب، به‌روزرسانی بسته‌ها و سایر موارد از طریق tlmgr(1)، مدیر بسته TeX Live (https://tug.org/texlive/tlmgr.html) انجام می‌شود.

تازه‌ترین نسخه این مستندات روی اینترنت در نشانی https://tug.org/texlive/doc/install-tl.html در دسترس است.

برای دستورالعمل‌های گام‌به‌گام، به https://tug.org/texlive/quickinstall.html مراجعه کنید.

برای مطالعه مستندات کامل TeX Live، به https://tug.org/texlive/doc مراجعه نمایید.

بدون مشخص کردن گزینه‌ها، "install-tl" وارد یک منوی تعاملی می‌شود که در آن تقریباً تمام تنظیمات پیش‌فرض قابل تغییرند. با گزینه‌ها، می‌توانید تنظیمات را به شیوه‌های گوناگون مقداردهی اولیه کنید، یا نصب را بدون تعامل انجام دهید. چند مثال:

"install-tl --paper=letter"
تنظیم اندازه کاغذ پیش‌فرض. تنها مقادیر مجاز "letter" و (پیش‌فرض) "a4" هستند.
"install-tl --scheme" scheme
مقداردهی اولیه طرح نصب؛ پیش‌فرض "full" است. برای مشاهده فهرست طرح‌ها، منوی تعاملی "S" را بررسی کنید.
"install-tl --no-interaction"
انجام فوری فرایند نصب بلافاصله پس از پردازش گزینه‌ها، بدون ورود به منوی تعاملی.
"install-tl --profile" texlive.profile
نصب خودکار و بدون تعامل بر اساس فایل پروفایل TL داده‌شده؛ به بخش «پروفایل‌ها (PROFILES)» در ادامه مراجعه کنید. برای مقداردهی اولیه از روی پروفایل و سپس ورود به منوی تعاملی، گزینه "--init-from-profile" را اضافه نمایید.

مستندات کامل در ادامه آمده است.

طبق معمول، تمام گزینه‌ها را می‌توان به هر ترتیبی و با پیشوند "-" یا "--" مشخص کرد. مقدار آرگومان را می‌توان با فاصله یا علامت "=" از گزینه جدا کرد.

گزینه‌های مربوط به سفارشی‌سازی نصب را می‌توان در منوهای نصب تعاملی (گرافیکی یا متنی) نیز انتخاب کرد.

اگر هیچ moduleای مشخص نشود، نصب‌کننده رابط کاربری گرافیکی Tcl/Tk (در ادامه آمده) را اجرا می‌کند.

اگر module مشخص شود، ماژول نصب‌کننده تعیین‌شده را بارگذاری می‌کند. در حال حاضر ماژول‌های زیر پشتیبانی می‌شوند:

"text"
رابط کاربری حالت متنی (پیش‌فرض در سیستم‌های یونیکس، شامل مک). معادل گزینه "-no-gui" است.
"tcl" (or "perltk" or "wizard" or "expert" or nothing)
رابط کاربری Tcl/Tk (پیش‌فرض در ویندوز). این رابط با تعداد اندکی از گزینه‌های پیکربندی آغاز می‌شود که تقریباً معادل گزینه پیشین wizard است، اما دکمه "Advanced" شما را به صفحه‌ای با گزینه‌هایی تقریباً مشابه رابط قدیمی "perltk" می‌برد.

رابط کاربری گرافیکی پیش‌فرض نیازمند Tcl/Tk است. این ابزار در سیستم‌های مک به صورت استاندارد وجود داشت، اما در نسخه‌های جدید macOS حذف شده است. این ابزار اغلب در توزیع‌های گنو/لینوکس از قبل نصب است یا به سادگی از طریق مدیر بسته توزیع قابل نصب می‌باشد. برای ویندوز، TeX Live محیط زمان اجرای Tcl/Tk را ارائه می‌دهد.

به طور پیش‌فرض، رابط گرافیکی Tcl از قابلیت تشخیص زبان درونی Tcl/Tk استفاده می‌کند. در صورت عدم موفقیت، می‌توانید با مشخص کردن این گزینه همراه با یک کد زبان (بر اساس ISO 639-1) زبان متفاوتی را برگزینید. در حال حاضر زبان‌های زیر پشتیبانی می‌شوند (هرچند لزوماً به طور کامل ترجمه نشده‌اند): انگلیسی (en، پیش‌فرض)، چکی (cs)، آلمانی (de)، فرانسوی (fr)، ایتالیایی (it)، ژاپنی (ja)، هلندی (nl)، لهستانی (pl)، پرتغالی برزیل (pt_BR)، روسی (ru)، اسلواکی (sk)، اسلوونیایی (sl)، صربی (sr)، اوکراینی (uk)، ویتنامی (vi)، چینی ساده‌شده (zh_CN)، و چینی سنتی (zh_TW).
تعیین مخزن بسته‌ای که به عنوان منبع نصب استفاده می‌شود. به طور خلاصه، این مقدار می‌تواند نام یک دایرکتوری یا یک نشانی اینترنتی با پروتکل‌های http(s)، ftp یا scp باشد. مستندات "tlmgr" شامل جزئیات بیشتر است (https://tug.org/texlive/doc/tlmgr.html#OPTIONS).

برای نصب، پیش‌فرض این است که یک آینه (mirror) به طور خودکار از طریق https://mirror.ctan.org/systems/texlive/tlnet انتخاب شود؛ سپس آینه انتخاب‌شده برای کل فرایند بارگیری به کار می‌رود. می‌توانید از آرگومان ویژه "ctan" به عنوان مخفف این نشانی استفاده کنید. (برای اطلاعات بیشتر در مورد CTAN و آینه‌های آن، به https://ctan.org مراجعه کنید).

پس از اتمام نصب، می‌توانید از آن نصب به عنوان مخزنی برای نصب دیگری استفاده کنید. اگر طرحی کمتر از طرح کامل را نصب کرده باشید، فهرست طرح‌های دردسترس به همان نسبت تنظیم خواهد شد.

این گزینه به شما امکان می‌دهد آینه خاصی را از فهرست فعلی آینه‌های فعال CTAN انتخاب کنید. این گزینه در حالت‌های نصب "text" و "gui" پشتیبانی می‌شود، و همچنین امکان نصب از رسانه محلی (در صورت وجود) یا از مخزن مشخص‌شده در خط فرمان را پیشنهاد می‌دهد. این گزینه زمانی مفید است که هدایت خودکار (پیش‌فرض) میزبان مناسبی را برای شما انتخاب نمی‌کند.
معمولاً گزینه‌هایی که به سکوی فعلی مربوط نیستند نمایش داده نمی‌شوند (برای مثال، هنگام اجرا در یونیکس، گزینه‌های مختص ویندوز حذف می‌شوند). مشخص کردن این گزینه خط فرمان امکان پیکربندی چنین تنظیمات ناسازگاری را فراهم می‌سازد.
اگر باینری‌های TeX Live خود را ساخته‌اید (مثلاً به این دلیل که باینری‌های از پیش کامپایل‌شده توسط TL برای سکوی شما ارائه نشده است)، این گزینه به شما اجازه می‌دهد تا path دایرکتوری حاوی باینری‌های سیستم جاری را تعیین کنید. نصب به صورت عادی ادامه می‌یابد، اما در پایان تمامی فایل‌های موجود در path به مسیر "bin/custom/" در زیر دایرکتوری نصب شما کپی می‌شوند و این دایرکتوری "bin/custom/" همان مسیری است که برای اقدامات پس از نصب به متغیر PATH افزوده می‌شود. برای نصب چندین مجموعه باینری سفارشی، پیش از هر نصب پوشه "custom" را به صورت دستی تغییر نام دهید.

برای اطلاعات بیشتر در مورد باینری‌های سفارشی، به https://tug.org/texlive/custom-bin.html مراجعه کنید. برای اطلاعات عمومی در مورد ساخت TeX Live، به https://tug.org/texlive/build.html مراجعه نمایید.

تظاهر به انجام یک نصب تحت شبکه. این گزینه صرفاً برای آزمایش کدهای مدیریت بارگیری‌های ناقص، از طریق جابجایی فایل‌های بسته در ساختار آینه tlnet کاربرد دارد.
چاپ مقادیر نهایی متغیرهای دایرکتوری؛ برای اطلاعات اشکال‌زدایی بیشتر درباره نحوه تنظیم آن‌ها، گزینه "-v" را نیز مشخص کنید.
در حالت‌های رابط گرافیکی پیشین Perl/Tk، این گزینه پیام‌های مفقود یا ترجمه‌نشده را در خروجی خطای استاندارد گزارش می‌کرد. این مورد هنوز برای رابط Tcl پیاده‌سازی نشده است. برای مترجمان جهت مشاهده مواردی که باید ترجمه شوند مفید است.
به جای تشخیص خودکار سکوی فعلی، از platform استفاده شود. باینری‌های مربوط به این سکو باید در مسیر "bin/"platform"/" حاضر و قابل اجرا باشند، در غیر این صورت نصب با شکست مواجه می‌شود. گزینه "-force-arch" مترادف این گزینه است.
نمایش این راهنما و خروج. (این راهنما روی وب نیز در نشانی https://tug.org/texlive/doc/install-tl.html موجود است). گاهی برنامه‌های "perldoc" یا "PAGER" روی سیستم دچار مشکل می‌شوند و ممکن است کاراکترهای کنترلی را به صورت خام چاپ کنند. این حالت همیشه قابل تشخیص نیست، اما می‌توانید متغیر محیطی "NOPERLDOC" را تنظیم کنید تا از "perldoc" استفاده نشود.
گزینه‌ای سریع برای نصب در مواقعی که یک نسخه rsync یا checkout از مخزن svn متعلق به TeX Live در اختیار دارید. این گزینه از همان نسخه بدون تغییر استفاده می‌کند و فقط مراحل لازم پس از نصب را اجرا می‌نماید. توجه داشته باشید که فایل "tlpkg/texlive.tlpdb" ممکن است بازنویسی شود، حذف فایل‌ها باید به صورت دستی انجام گیرد و تنها راه واقع‌بینانه برای نگهداری این نصب، انجام مجدد آن در بازه‌های زمانی مختلف است. این گزینه در رابط‌های گرافیکی نصب‌کننده در دسترس نیست. مسئولیت استفاده بر عهده کاربر است.
مشابه گزینه -profile (به بخش «پروفایل‌ها (PROFILES)» در ادامه مراجعه کنید)، اما فقط پیکربندی نصب را از profile_file مقداردهی اولیه کرده و سپس نشست تعاملی عادی را آغاز می‌کند. متغیرهای محیطی نادیده گرفته نمی‌شوند.
نوشتن تمامی پیام‌ها (اطلاعاتی، اشکال‌زدایی، هشدارها) در file علاوه بر خروجی استاندارد یا خطای استاندارد.

اگر این گزینه مشخص نشود، نصب‌کننده یک فایل گزارش (log) در ریشه درخت نصب قابل نوشتن ایجاد می‌کند؛ برای مثال، "/usr/local/texlive/YYYY/install-tl.log" برای انتشار سال YYYY.

فقط برای نصب‌کننده حالت متنی: هنگام ورود به یک منوی جدید صفحه را پاک نمی‌کند. برای اهداف اشکال‌زدایی.
خروج زودهنگام در صورت شکست نصب یک بسته غیر اصلی (non-core).

به طور پیش‌فرض، ابتدا چند بسته اصلی نصب می‌شوند؛ سپس، شکست در نصب هر بسته دیگری (غیر اصلی) ثبت می‌شود، اما مانع ادامه نصب نمی‌گردد. نصب بسته‌های شکست‌خورده یک بار دیگر مجدداً تلاش می‌شود.

اگر تلاش مجدد نیز با شکست روبرو شود، به طور پیش‌فرض نصب‌کننده فرض می‌کند که این یک مشکل موقتی شبکه بوده و نصب مجدد بعداً با موفقیت انجام خواهد شد و فرایند نصب را به پایان می‌برد. در صورت مشخص کردن این گزینه، با شکست تلاش مجدد، فرایند نصب لغو می‌شود.

عدم نصب مستندات یا فایل‌های بسته سورس، هم در نصب جاری و هم برای به‌روزرسانی‌های آتی. پس از نصب، فعال‌سازی مجدد دریافت فایل‌های doc/src از طریق "tlmgr" امکان‌پذیر است: 
tlmgr option docfiles 1
tlmgr option srcfiles 1

اگر بعداً متوجه شدید که به فایل‌های doc/src بسته‌ای که بدون آن‌ها نصب شده نیاز دارید، می‌توانید آن‌ها را به این صورت دریافت کنید (با استفاده از بسته "fontspec" به عنوان مثال):

tlmgr install --reinstall --with-doc --with-src fontspec

فایل‌های سورس ذکرشده در اینجا مربوط به بسته‌های TeX هستند، مانند فایل‌های ".dtx". سورس‌هایی که برای کامپایل باینری‌ها استفاده می‌شوند به صورت جداگانه در دسترس هستند: به https://tug.org/texlive/svn مراجعه کنید.

هیچ نصبی را انجام ندهید. این گزینه برای اشکال‌زدایی روال‌های مقداردهی اولیه و راه‌اندازی بدون دستکاری دیسک است.
وارد منوی تعاملی نشوید؛ بلافاصله پس از مقداردهی اولیه و پردازش گزینه‌ها نصب را اجرا کنید. همچنین بررسی نصب قبلی و پرسش درباره وارد کردن تنظیمات پیشین را نادیده بگیرید.
برای نصب‌های تحت شبکه، فعال کردن این گزینه باعث می‌شود نصب‌کننده تلاش کند با استفاده از ماژول پرل "LWP" یک اتصال پایدار (persistent) برقرار نماید. این کار در هر نشست تنها یک اتصال بین رایانه شما و سرور باز می‌کند و از آن مجدداً بهره می‌برد، به جای آنکه برای هر بسته یک اتصال دانلود جدید ایجاد کند، که معمولاً سرعت را به شکل چشمگیری افزایش می‌دهد.

این گزینه به صورت پیش‌فرض فعال است و در صورت عدم امکان، برنامه نصب به استفاده از "wget" متوسل خواهد شد. برای غیرفعال کردن استفاده از LWP و اتصالات پایدار، از "-no-persistent-downloads" استفاده کنید.

به طور پیش‌فرض، اگر باینری "gpg" متعلق به GnuPG در متغیر PATH یافت شود، بارگیری‌ها با استفاده از امضای رمزنگاری اعتبارسنجی می‌شوند. این گزینه اعتبارسنجی را غیرفعال می‌کند. شرح کامل در بخش Cryptographic Verification مستندات "tlmgr" آمده است؛ برای مثال: https://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION
فقط برای ویندوز: پیکربندی فقط برای کاربر جاری انجام شود، نه برای تمام کاربران.
تنظیم اندازه کاغذ پیش‌فرض برای تمامی برنامه‌های TeX Live بر اساس مقدار تعیین‌شده. پیش‌فرض "a4" است. اندازه کاغذ را می‌توان پس از نصب با دستور "tlmgr paper" تغییر داد.
نصب برای استفاده پرتابل (قابل‌حمل)، مانند فلش مموری USB. برای جزئیات به بخش مربوط به "instopt_portable" در ادامه مراجعه کنید.
شناسه TeX Live برای سکوی شناسایی‌شده (ترکیب سخت‌افزار/سیستم‌عامل) را در خروجی استاندارد چاپ کرده و خارج می‌شود. "-print-arch" مترادف این گزینه است.
بارگذاری profile_file و انجام نصب بدون هیچ‌گونه تعامل با کاربر، یعنی نصب دسته‌ای (غیرحضوری). متغیرهای محیطی نادیده گرفته می‌شوند. به بخش «پروفایل‌ها (PROFILES)» در ادامه مراجعه کنید.
صرف‌نظر از نمایش پیام‌های اطلاعاتی عادی.
طرح‌ها (schemes) بالاترین سطح گروه‌بندی بسته‌ها در TeX Live هستند؛ حالت پیش‌فرض استفاده از طرح "full" است که همه چیز را شامل می‌شود. این گزینه تنظیم پیش‌فرض را بازنویسی می‌کند. مقدار آرگومان scheme می‌تواند به صورت اختیاری دارای پیشوند "scheme-" باشد. فهرست نام‌های طرح‌های پشتیبانی‌شده به موارد موجود در مخزن بسته شما بستگی دارد؛ منوی تعاملی را بررسی کنید.
تعیین دایرکتوری نصب سیستمی؛ پیش‌فرض "/usr/local/texlive/YYYY" برای نسخه YYYY است. مشخص کردن این گزینه همچنین باعث می‌شود که دایرکتوری‌های "TEXMFLOCAL"، "TEXMFSYSCONFIG" و "TEXMFSYSVAR" به عنوان زیردایرکتوری‌های dir تنظیم شوند، بنابراین نیازی به تنظیم جداگانه آن‌ها نیست.

خلاصه‌ای از این درخت‌های دایرکتوری در بخش «درخت‌های دایرکتوری (DIRECTORY TREES)» در ادامه آمده است؛ برای مشاهده جزئیات درخت‌های تنظیم‌شده به طور پیش‌فرض و کاربرد مورد نظر آن‌ها، به مستندات اصلی TeX Live در نشانی https://tug.org/texlive/doc مراجعه کنید.

تعیین دایرکتوری نصب کاربری؛ پیش‌فرض "~/.texliveYYYY" است (به جز سیستم‌های مک که در آن نقطه آغازین وجود ندارد). تعیین این گزینه همچنین باعث می‌شود دایرکتوری‌های "TEXMFHOME"، "TEXMFCONFIG" و "TEXMFVAR" به عنوان زیردایرکتوری‌های dir تنظیم شوند.
تعیین دایرکتوری "TEXMFLOCAL"؛ پیش‌فرض "/usr/local/texlive/texmf-local" است، یعنی یک سطح بالاتر از محل نصب اصلی. بدین ترتیب بسته‌های نصب‌شده به صورت محلی می‌توانند به راحتی در میان نسخه‌های مختلف استفاده شوند که معمولاً مطلوب است. مشخص کردن گزینه "-texdir" این تنظیم را تغییر داده و "TEXMFLOCAL" را در زیر درخت اصلی قرار می‌دهد. گزینه "-texmflocal" می‌تواند برای تعیین یک دایرکتوری صریح به کار رود.

هر چیزی که در اینجا نصب می‌شود باید از ساختار دایرکتوری TeX یا همان TDS پیروی کند؛ مانند: "TEXMFHOME/tex/latex/mypkg/mypkg.sty". مرجع TDS: https://tug.org/tds.

تعیین دایرکتوری "TEXMFHOME"؛ پیش‌فرض "~/texmf" است، مگر در سیستم‌های مک که "~/Library/texmf" می‌باشد. مشابه با "TEXMFLOCAL"، گزینه "-texuserdir" این مقدار پیش‌فرض را تغییر می‌دهد.

همچنین همانند "TEXMFLOCAL"، هر موردی که در اینجا نصب می‌شود باید از TDS پیروی کند.

تعیین دایرکتوری‌های سیستمی "TEXMFSYSCONFIG" و "TEXMFSYSVAR".
تعیین دایرکتوری‌های کاربری "TEXMFCONFIG" و "TEXMFVAR". مقادیر پیش‌فرض "~/.texliveYYYY/texmf-{config,var}" است، مگر در سیستم‌های مک که در آن‌ها نقطه آغازین حذف می‌شود ("~/texliveYYYY/...").
افزودن پیام‌های اشکال‌زدایی پرجزئیات؛ برای حداکثر سطح اشکال‌زدایی تکرار کنید: "-v -v". (تکرارهای بیشتر پذیرفته شده اما نادیده گرفته می‌شوند).
نمایش اطلاعات نسخه و خروج. در صورت ارائه "-v"، نسخه ماژول‌های TeX Live استفاده‌شده نیز گزارش می‌شود.

یک فایل profile معمولاً شامل تمام مقادیر لازم برای انجام یک نصب است. پس از پایان یک نصب عادی، پروفایلی برای همان نصب دقیق در فایل "tlpkg/texlive.profile" نوشته می‌شود. علاوه بر این، در منوی متنی می‌توان در هر زمان با فشردن کلید "P" پیکربندی فعلی را به عنوان یک پروفایل ذخیره کرد. این‌ها فایل‌های متنی کوچکی هستند؛ در صورت تمایل می‌توانید آن‌ها را مطابق نیازهای خود بررسی و ویرایش کنید.

چنین فایل پروفایلی می‌تواند به عنوان آرگومان به "-profile" داده شود، برای مثال برای تکرار دقیق همان نصب روی یک سیستم متفاوت. علاوه بر این، می‌توانید از یک پروفایل سفارشی استفاده کنید که ساده‌ترین راه ایجاد آن، شروع از یک پروفایل تولیدشده و تغییر مقادیر آن است. یک فایل پروفایل خالی باعث می‌شود نصب‌کننده از مقادیر پیش‌فرض استفاده کند.

همان‌طور که در بالا ذکر شد، نصب‌کننده تنها از انتخاب بر اساس طرح و مجموعه‌ها پشتیبانی می‌کند و نه بسته‌های منفرد، بنابراین بسته‌ها را نمی‌توان در فایل‌های پروفایل نیز مشخص کرد. برای کار در سطح بسته‌ها از "tlmgr" استفاده نمایید.

درون یک فایل پروفایل، هر خط شامل ساختار زیر است:

متغیر [مقدار]

به جز خطوط توضیحات که با "#" شروع می‌شوند. نام‌های متغیرهای مجاز در زیر فهرست شده‌اند. مقادیر، در صورت وجود، برای متغیرهای بولی برابر با 0 یا 1 و یا رشته‌های متنی هستند (که باید بدون هیچ نویسه کوتیشنی مشخص شوند). فاصله‌های ابتدایی خطوط نادیده گرفته می‌شوند.

اگر متغیر "selected_scheme" تعریف شده باشد و هیچ متغیر مجموعه‌ای تعریف نشده باشد، مجموعه‌های مورد نیاز طرح مشخص‌شده (که ممکن است به مرور زمان تغییر کند) بدون نیاز به ذکر صریح آن‌ها نصب می‌شوند. این ویژگی نگهداری فایل‌های پروفایل را آسان می‌کند. با این حال، اگر هرگونه مجموعه‌ای در یک پروفایل مشخص شود، طرح نادیده گرفته شده و تمام مجموعه‌های مورد نظر باید به طور صریح ارائه گردند.

برای مثال، خط:

selected_scheme scheme-small

همراه با تعاریف دایرکتوری‌های نصب (ارائه‌شده در زیر تحت عنوان «گزینه‌های مسیر») برای نصب طرح «small» با تمامی گزینه‌های پیش‌فرض کفایت می‌کند. طرح‌ها در منوی "S" نصب‌کننده متنی یا معادل آن توصیف شده‌اند.

علاوه بر "selected_scheme"، نام متغیرهای دیگری که در یک پروفایل پشتیبانی می‌شوند در اینجا آورده شده است:

گزینه‌های مجموعه (collection options) (پیشوند "collection-")

مجموعه‌ها با نام متغیری با پیشوند "collection-" به همراه نام مجموعه مشخص می‌شوند؛ مقداری وجود ندارد. به عنوان مثال، "collection-basic". مجموعه‌ها در منوی "C" توصیف شده‌اند.

طرح‌ها و مجموعه‌ها (و بسته‌ها) در نهایت توسط فایل‌های موجود در دایرکتوری سورس "tlpkg/tlpsrc/" تعریف می‌شوند.

گزینه‌های مسیر (path options)

بهتر است تمام این موارد تعریف شوند، حتی اگر در یک نصب خاص استفاده نشوند، تا از دریافت ناخواسته مقدار پیش‌فرضی که ممکن است بعداً مشکل‌ساز شود جلوگیری به عمل آید.

TEXDIR
TEXMFLOCAL
TEXMFSYSCONFIG
TEXMFSYSVAR
TEXMFCONFIG
TEXMFVAR
TEXMFHOME

گزینه‌های نصب‌کننده (installer options) (پیشوند "instopt_")

"instopt_adjustpath" (default 0 on Unix, 1 on Windows)
تنظیم متغیر محیطی "PATH".
"instopt_adjustrepo" (default 1)
تنظیم مخزن راه دور به یک آینه چندگانه CTAN پس از نصب؛ به بخش "-repository" در بالا مراجعه کنید.
"instopt_letter" (default 0)
تنظیم اندازه کاغذ پیش‌فرض بر روی letter به جای a4.
"instopt_portable" (default 0)
نصب برای استفاده قابل‌حمل (مانند فلش‌مموری USB) بدون اعمال تغییر روی سیستم میزبان. به طور خاص، این گزینه دایرکتوری‌های کاربری "TEXMFHOME"، "TEXMFCONFIG" و "TEXMFVAR" را وادار می‌کند تا به ترتیب دقیقاً معادل دایرکتوری‌های سیستمی "TEXMFLOCAL"، "TEXMFSYSCONFIG" و "TEXMFSYSVAR" باشند (صرف‌نظر از سایر گزینه‌ها و متغیرهای محیطی).

علاوه بر این، در ویندوز اقداماتی چون ادغام با میزکار، تنظیم متغیر PATH و پیوندهای پسوند فایل‌ها را غیرفعال می‌سازد.

"instopt_write18_restricted" (default 1)
فعال‌سازی "\write18" برای مجموعه محدودی از برنامه‌ها.

گزینه‌های tlpdb (پیشوند "tlpdbopt_")

فهرست قطعی در فایل "tlpkg/TeXLive/TLConfig.pm" در هش %TeXLive::TLConfig::TLPDBOptions همراه با توضیحات آورده شده است. تمام موارد ذکرشده در آنجا به جز "tlpdbopt_location" را می‌توان تعیین کرد. در اینجا فهرست فعلی آورده شده است:

tlpdbopt_autobackup
tlpdbopt_backupdir
tlpdbopt_create_formats
tlpdbopt_desktop_integration
tlpdbopt_file_assocs
tlpdbopt_generate_updmap
tlpdbopt_install_docfiles
tlpdbopt_install_srcfiles
tlpdbopt_post_code
tlpdbopt_sys_bin
tlpdbopt_sys_info
tlpdbopt_sys_man
tlpdbopt_w32_multi_user

گزینه‌های سکو (platform options) (پیشوند "binary_")

برای هر سکوی پشتیبانی‌شده در TeX Live (دایرکتوری‌های زیر "bin/")، می‌توان متغیر "binary_"PLATFORM را با مقدار 1 مقداردهی کرد. برای مثال:

binary_x86_64-linux 1

اگر هیچ تنظیماتی برای "binary_" صورت نگیرد، حالت پیش‌فرض همان سکویی خواهد بود که ماشین فعلی در حال اجرای آن است.

در نسخه‌های پیش از ۲۰۱۷، بسیاری از متغیرهای پروفایل نام‌های متفاوتی داشتند (که در اینجا ذکر نشده‌اند؛ به سورس‌کد "install-tl" مراجعه کنید). آن‌ها پذیرفته شده و به نام‌های ارائه‌شده در بالا تبدیل می‌شوند. هنگام ذخیره یک پروفایل، همواره از نام‌های فوق استفاده می‌شود.

برای جزئیات بیشتر در مورد تمام گزینه‌های بالا، به راهنمای نصب TeX Live که در نشانی https://tug.org/texlive/doc پیوند داده شده است مراجعه فرمایید.

جهت سهولت در اسکریپت‌نویسی و اشکال‌زدایی، "install-tl" متغیرهای محیطی زیر را بررسی می‌کند. این متغیرها برای نصب‌های عادی کاربران کاربردی ندارند.

"NOPERLDOC"
تلاش برای اجرای پیام "--help" از طریق "perldoc" انجام نشود.
"TEXLIVE_DOWNLOADER"
"TL_DOWNLOAD_PROGRAM"
"TL_DOWNLOAD_ARGS"
"TEXLIVE_PREFER_OWN"
این متغیرها انتخاب عادی برنامه‌های بارگیری و سایر ابزارهای کمکی را بازنویسی می‌کنند؛ به مستندات "tlmgr" مراجعه کنید؛ برای مثال: https://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES.
"TEXLIVE_INSTALL_ENV_NOCHECK"
بررسی متغیرهای محیطی حاوی رشته متنی "tex" را نادیده بگیرید. توسعه‌دهندگان نرم‌افزارهای مرتبط با TeX احتمالاً متغیرهای زیادی از این دست دارند.
"TEXLIVE_INSTALL_NO_CONTEXT_CACHE"
صرف‌نظر از ایجاد حافظه پنهان ConTeXt. این گزینه برای بازتوزیع‌کنندگان (redistributors) مفید است.
"TEXLIVE_INSTALL_NO_DISKCHECK"
در صورت تنظیم روی 1، بررسی فضای خالی دیسک انجام نمی‌شود. به طور پیش‌فرض، اگر برنامه "df" سازگار با استاندارد POSIX (با پشتیبانی از "-Pk") موجود باشد، نصب‌کننده فضای خالی دیسک در محل نصب انتخابی را بررسی کرده و در صورت ناکافی بودن فضا (به همراه حاشیه امن ۱۰۰ مگابایت)، نصب را متوقف می‌کند. بررسی معادلی نیز در ویندوز (بدون استفاده از "df") صورت می‌پذیرد.
"TEXLIVE_INSTALL_NO_RESUME"
صرف‌نظر از بررسی نصب روی یک نسخه پیشین و عدم پرسش در مورد وارد کردن تنظیمات قبلی.
"TEXLIVE_INSTALL_NO_WELCOME"
صرف‌نظر از چاپ پیام خوش‌آمدگویی پس از نصب موفقیت‌آمیز، مثلاً هنگام آزمایش و بررسی خودکار.
"TEXLIVE_INSTALL_PAPER"
تنظیم اندازه کاغذ پیش‌فرض برای تمامی برنامه‌های مرتبط؛ باید "letter" یا "a4" باشد. پیش‌فرض "a4" است.
"TEXLIVE_INSTALL_PREFIX"
"TEXLIVE_INSTALL_TEXMFCONFIG"
"TEXLIVE_INSTALL_TEXMFVAR"
"TEXLIVE_INSTALL_TEXMFHOME"
"TEXLIVE_INSTALL_TEXMFLOCAL"
"TEXLIVE_INSTALL_TEXMFSYSCONFIG"
"TEXLIVE_INSTALL_TEXMFSYSVAR"
تعیین دایرکتوری‌های مربوطه. مقدار پیش‌فرض "TEXLIVE_INSTALL_PREFIX" برابر با "/usr/local/texlive" است. تمام مقادیر پیش‌فرض را می‌توان با اجرای تعاملی نصب‌کننده و سپس فشردن کلید "D" برای منوی دایرکتوری مشاهده کرد.

گزینه‌های مختلف خط فرمان برای تعیین دایرکتوری‌ها، این متغیرهای محیطی را بازنویسی می‌کنند؛ از آنجا که تعیین همزمان هر دو مورد معمولاً ناخواسته است، در صورت تفاوت مقادیر، یک هشدار نمایش داده می‌شود.

راه‌های متعددی برای مشخص کردن درخت‌های دایرکتوری پرتعداد مورد استفاده TeX Live وجود دارد. تا به حال ساده‌ترین و توصیه‌شده‌ترین رویکرد این است که هیچ چیزی تغییر داده نشود. مقادیر پیش‌فرض برای اکثریت قریب به اتفاق موارد نصب کفایت می‌کند.

اما برای توضیح بیشتر، در اینجا جدولی از درخت‌ها و گزینه‌های خط فرمان برای تغییر آن‌ها آمده است. گروه سه تایی اول دایرکتوری‌های سیستمی هستند و گروه سه تایی دوم دایرکتوری‌های کاربری؛ این دو گروه کاملاً مشابه‌اند.

+----------------+--------------------------------------+--------------+------------------+
|    tree        | default                              | group change | single change    |
+----------------+--------------------------------------+--------------+------------------+
| TEXMFLOCAL     | /usr/local/texlive/texmf-local       | --texdir     | --texmflocal     |
| TEXMFSYSVAR    | /usr/local/texlive/YYYY/texmf-var    | --texdir     | --texmfsysvar    |
| TEXMFSYSCONFIG | /usr/local/texlive/YYYY/texmf-config | --texdir     | --texmfsysconfig |
+----------------+--------------------------------------+--------------+------------------+
| TEXMFHOME      | ~/texmf                              | --texuserdir | --texmfhome      |
| TEXMFVAR       | ~/.texliveYYYY/texmf-var             | --texuserdir | --texmfvar       |
| TEXMFCONFIG    | ~/.texliveYYYY/texmf-config          | --texuserdir | --texmfconfig    |
+----------------+--------------------------------------+--------------+------------------+

علاوه بر این، همان‌طور که در بخش قبل ذکر شد، هر درخت دارای یک متغیر محیطی "TEXLIVE_INSTALL_"tree است که پیش‌فرض را بازنویسی می‌کند؛ تنظیمات خط فرمان و پروفایل هر دو تنظیمات متغیرهای محیطی را لغو می‌کنند.

مقادیر پیش‌فرض در سیستم‌های مک کمی متفاوت است، همان‌طور که در بالا در بخش «گزینه‌ها (OPTIONS)» توضیح داده شد.

برای درخت‌های کاربری، مقدار پیش‌فرض از "~" استفاده می‌کند، و این مقدار به صورت لفظی "~" در "texmf.cnf" باقی می‌ماند. بدین ترتیب هر کاربر می‌تواند "TEXMFHOME" اختصاصی خود را داشته باشد، همان‌گونه که انتظار می‌رود. از سوی دیگر، برای درخت‌های سیستمی، اگر در طول فرایند نصب از "~" استفاده شود، فرض بر این است که صرفاً یک مخفف تایپی است و دایرکتوری خانگی بازشده در "texmf.cnf" نوشته می‌شود، زیرا داشتن دایرکتوری‌های سیستمی مختص یک کاربر توجیه ندارد.

برای اطلاعات بیشتر در مورد درخت‌های دایرکتوری و کاربرد در نظر گرفته شده برای آن‌ها، به مستندات اصلی TeX Live در نشانی https://tug.org/texlive/doc مراجعه کنید.

اسکریپت "install-tl" خود را در درخت نصب‌شده کپی می‌کند. معمولاً می‌توان آن را از همان‌جا اجرا کرد و از درخت نصب‌شده به عنوان منبع برای نصب دیگری استفاده نمود. با این حال، گاهی ممکن است ناسازگاری‌هایی در کدهای نسخه جدید "install-tl" و زیرساخت رخ دهد که منجر به خطاهای (احتمالاً) نامفهوم پرل گردد. راه‌حل این است که "install-tl" را مستقیماً از بسته نصب‌کننده ("install-tl-unx.tar.gz" یا "install-tl.zip") اجرا کنید نه از نسخه نصب‌شده. همچنین در صورت تمایل مشکل را گزارش دهید؛ معمولاً می‌توان کدها را مجدداً به آسانی همگام کرد.

در ضمن، سعی نکنید از "install-tl" برای تنظیم گزینه‌ها یا بسته‌های نصب‌شده در یک درخت نصب موجود استفاده کنید. به جای آن از "tlmgr" استفاده کنید.

این اسکریپت و مستندات آن برای توزیع TeX Live (https://tug.org/texlive) نوشته شده‌اند و هر دو تحت مجوز عمومی گنو (GNU GPL) نسخه ۲ یا بالاتر منتشر شده‌اند.

$Id: install-tl 74223 2025-02-23 16:38:14Z karl $

2025-02-23 perl v5.42.0