tlmgr - Daring di Awan

PROGRAM:

NAMA

tlmgr - Manajer Langsung TeX

RINGKASAN

tlmgr [Option] ... tindakan [Option]...[operan] ...

DESKRIPSI

tlmgr.dll mengelola instalasi TeX Live yang ada, baik paket maupun opsi konfigurasi.
Untuk informasi tentang mengunduh dan menginstal TeX Live pada awalnya, lihat
<http://tug.org/texlive/acquire.html>.

Versi terbaru dari dokumentasi ini (diperbarui setiap malam dari pengembangan
sumber) tersedia dihttp://tug.org/texlive/tlmgr.html>, beserta prosedur untuk
memperbarui "tlmgr" itu sendiri dan informasi tentang versi pengujian.

PERINGATAN: tlmgr di Debian selalu berjalan dalam mode pengguna

TeX Live diatur menjadi beberapa level teratas skema, yang masing-masing ditentukan sebagai
set berbeda koleksi dan paket, di mana koleksi adalah sekumpulan paket, dan a
paket adalah apa yang berisi file aktual. Skema biasanya berisi campuran koleksi dan
paket, tetapi setiap paket termasuk dalam satu koleksi, tidak lebih dan tidak kurang. A
Instalasi TeX Live dapat disesuaikan dan dikelola di level mana pun.

Lihathttp://tug.org/texlive/doc> untuk semua dokumentasi TeX Live yang tersedia.

CONTOH

Setelah berhasil menginstal TeX Live, berikut adalah beberapa operasi umum dengan "tlmgr":

"penyimpanan opsi tlmgr http://mirror.ctan.org/systems/texlive/tlnet"
Beri tahu "tlmgr" untuk menggunakan cermin CTAN terdekat untuk pembaruan di masa mendatang; berguna jika Anda menginstal
TeX Live dari gambar DVD dan ingin melanjutkan pembaruan.

"tlmgr pembaruan --daftar"
Laporkan apa yang akan diperbarui tanpa benar-benar memperbarui apa pun.

"tlmgr pembaruan --semua"
Jadikan instalasi TeX lokal Anda sesuai dengan apa yang ada di repositori paket
(biasanya berguna saat memperbarui dari CTAN).

"info tlmgr" apa
Menampilkan informasi rinci tentang sebuah paket apa, seperti status penginstalan dan
deskripsi, pencarian untuk apa di semua paket.

Untuk semua kemampuan dan detail "tlmgr", silakan baca yang banyak berikut ini
informasi.

PILIHAN

Opsi berikut untuk "tlmgr" adalah opsi global, tidak spesifik untuk tindakan apa pun. Semua
opsi, apakah global atau spesifik tindakan, dapat diberikan di mana saja di baris perintah, dan
dalam urutan apa pun. Argumen non-opsi pertama akan menjadi tindakan utama. Dalam semua kasus,
"-"Option dan "-"Option setara, dan "=" adalah opsional antara nama opsi dan
nilainya.

--gudang url|jalur
Menentukan repositori paket dari mana paket harus diinstal atau diperbarui,
mengganti repositori paket default yang ditemukan di TeX Live Package instalasi
Database (alias TLPDB, didefinisikan seluruhnya dalam file "tlpkg/texlive.tlpdb"). NS
dokumentasi untuk "install-tl" memiliki detail lebih lanjut tentang ini
(<http://tug.org/texlive/doc/install-tl.html>).

"--repository" mengubah lokasi repositori hanya untuk proses saat ini; untuk membuat sebuah
perubahan permanen, gunakan "repositori opsi" (lihat tindakan "opsi").

Untuk kompatibilitas dan kenyamanan mundur, "--location" dan "--repo" diterima sebagai
alias untuk opsi ini.

--gui [tindakan]
"tlmgr" memiliki antarmuka grafis serta antarmuka baris perintah. Kamu bisa memberi
opsi ini, "--gui", bersama dengan tindakan yang akan dibawa langsung ke
layar masing-masing GUI. Misalnya lari

tlmgr --pembaruan gui

memulai Anda langsung di layar pembaruan. Jika tidak ada tindakan yang diberikan, GUI akan menjadi
dimulai di layar utama.

--gui-lang kode ll
Secara default, GUI mencoba menyimpulkan bahasa Anda dari lingkungan (di Windows melalui
registri, di Unix melalui "LC_MESSAGES"). Jika gagal, Anda dapat memilih yang lain
bahasa dengan memberikan opsi ini dengan kode bahasa (berdasarkan ISO 639-1). Saat ini
didukung (tetapi tidak harus sepenuhnya diterjemahkan) adalah: Bahasa Inggris (en, default),
Ceko (cs), Jerman (de), Prancis (fr), Italia (it), Jepang (ja), Belanda (nl), Polandia
(pl), Portugis Brasil (pt_BR), Rusia (ru), Slovakia (sk), Slovenia (sl), Serbia
(sr), Ukraina (uk), Vietnam (vi), Tionghoa Sederhana (zh_CN), dan tradisional
Cina (zh_TW).

--debug-terjemahan
Dalam mode GUI, sakelar ini memberi tahu "tlmgr" untuk melaporkan semua yang tidak diterjemahkan (atau hilang)
pesan ke kesalahan standar. Ini dapat membantu penerjemah untuk melihat apa yang masih harus dilakukan.

--dapat dibaca oleh mesin
Alih-alih output normal yang ditujukan untuk konsumsi manusia, tulis (menurut standar
output) format tetap lebih cocok untuk penguraian mesin. Lihat bagian "DAPAT DIBACA MESIN
OUTPUT" di bawah.

--tanpa-eksekusi-tindakan
Menekan eksekusi tindakan eksekusi seperti yang didefinisikan dalam file tlpsrc.
Didokumentasikan hanya untuk kelengkapan, karena ini hanya berguna dalam debugging.

--paket-logfile fillet
"tlmgr" mencatat semua tindakan paket (instal, hapus, perbarui, pembaruan yang gagal, gagal
restore) ke file log terpisah, secara default "TEXMFSYSVAR/web2c/tlmgr.log". Ini
opsi memungkinkan Anda untuk menentukan file yang berbeda untuk log.

--berhenti sebentar
Opsi ini membuat "tlmgr" menunggu input pengguna sebelum keluar. Berguna di Windows untuk
menghindari hilangnya jendela perintah.

--persisten-downloads
--no-persisten-downloads
Untuk instalasi berbasis jaringan, opsi ini (diaktifkan secara default) membuat "tlmgr" mencoba menyetel
koneksi persisten (menggunakan modul Perl "LWP"). Idenya adalah untuk membuka dan
gunakan kembali hanya satu koneksi per sesi antara komputer Anda dan server, alih-alih
memulai unduhan baru untuk setiap paket.

Jika ini tidak memungkinkan, "tlmgr" akan kembali menggunakan "wget". Untuk menonaktifkan ini
koneksi persisten, gunakan "--no-persistent-downloads".

--pin-file
Ubah lokasi file penyematan dari "TEXMFLOCAL/tlpkg/pinning.txt" (lihat "Menyematkan"
di bawah). Didokumentasikan hanya untuk kelengkapan, karena ini hanya berguna dalam debugging.

--mode pengguna
Mengaktifkan mode pengguna untuk menjalankan "tlmgr" ini; lihat "MODE PENGGUNA" di bawah.

--pohon pengguna dir
penggunaan dir untuk pohon dalam mode pengguna; lihat "MODE PENGGUNA" di bawah.

Opsi standar untuk program TeX Live juga diterima: "--help/-h/-?", "--version",
"-q" (tidak ada pesan informasional), "-v" (pesan debug, dapat diulang). Untuk
detail tentang ini, lihat dokumentasi "TeXLive::TLUtils".

Opsi "--version" menampilkan informasi versi tentang rilis TeX Live dan tentang
skrip "tlmgr" itu sendiri. Jika "-v" juga diberikan, nomor revisi untuk TeX Live yang dimuat
Modul Perl juga ditampilkan.

TINDAKAN

membantu
Tampilkan informasi bantuan ini dan keluar (sama seperti "--help", dan di web di
<http://tug.org/texlive/doc/tlmgr.html>). Terkadang program "perldoc" dan/atau "PAGER"
pada sistem mengalami masalah, yang mengakibatkan karakter kontrol menjadi keluaran secara harfiah. Ini
tidak selalu dapat dideteksi, tetapi Anda dapat mengatur variabel lingkungan "NOPERLDOC" dan
"perldoc" tidak akan digunakan.

versi
Memberikan informasi versi (sama dengan "--version").

Jika "-v" telah diberikan, revisi modul yang digunakan juga dilaporkan.

backup [--bersih[= .]N]] [--cadangandir dir] [--semua | pkg] ...
Jika opsi "--clean" tidak ditentukan, tindakan ini membuat cadangan dari yang diberikan
paket, atau semua paket yang diberikan "--all". Cadangan ini disimpan ke nilai
Opsi "--backupdir", jika itu adalah direktori yang ada dan dapat ditulis. Jika "--backupdir" adalah
tidak diberikan, pengaturan opsi "backupdir" di TLPDB digunakan, jika ada. Jika keduanya
hilang, tidak ada cadangan yang dibuat.

Jika opsi "--clean" ditentukan, cadangan dipangkas (dihapus) alih-alih disimpan. NS
nilai bilangan bulat opsional N dapat ditentukan untuk mengatur jumlah cadangan yang akan
tertahan saat dibersihkan. Jika "N" tidak diberikan, nilai opsi "autobackup" digunakan.
Jika keduanya tidak ada, akan terjadi kesalahan. Untuk detail lebih lanjut tentang pemangkasan cadangan, lihat:
tindakan "pilihan".

Pilihan:

--cadangandir direktori
Mengganti pengaturan opsi "backupdir" di TLPDB. NS direktori argumen adalah
diperlukan dan harus menentukan direktori yang ada dan dapat ditulis di mana backup akan dilakukan
ditempatkan.

--semua
Jika "--clean" tidak ditentukan, buat cadangan semua paket di TeX Live
instalasi; ini akan memakan cukup banyak ruang dan waktu. Jika "--bersih" adalah
ditentukan, semua paket dipangkas.

--membersihkan[=N]
Alih-alih membuat cadangan, pangkas direktori cadangan dari cadangan lama, seperti yang dijelaskan
di atas. Argumen integer opsional N menimpa opsi "pencadangan otomatis" yang diatur di
TLPDB. Anda harus menggunakan "--all" atau daftar paket bersama dengan opsi ini, karena
diinginkan.

--lari-kering
Tidak ada yang benar-benar dicadangkan atau dihapus; sebaliknya, tindakan yang harus dilakukan adalah
ditulis ke terminal.

calon pkg
calon pkg
Menunjukkan repositori kandidat yang tersedia untuk paket pkg. Lihat "GANDA
REPOSITORY" di bawah ini.

memeriksa [Option] ... [berkas|tergantung|mengeksekusi|runfile|semua]
Jalankan satu (atau semua) pemeriksaan pada konsistensi instalasi.

arsip
Memeriksa apakah semua file yang terdaftar di TLPDB lokal ("texlive.tlpdb") benar-benar
hadir, dan daftar mereka yang hilang.

tergantung
Mencantumkan paket-paket yang muncul sebagai dependensi dalam koleksi yang diinstal, tetapi
sendiri tidak diinstal, dan paket-paket yang tidak terkandung dalam koleksi apa pun.

Jika Anda memanggil "kumpulan cek tlmgr" tes ini akan dilakukan sebagai gantinya karena
versi sebelumnya untuk "tlmgr" menyebutnya demikian.

mengeksekusi
Periksa apakah file yang dirujuk oleh perintah "eksekusi" di TeX Live Database adalah
menyajikan.

file run
Buat daftar nama file yang muncul lebih dari satu kali di file run.

Pilihan:

--gunakan-svn
Gunakan output dari "svn status" alih-alih membuat daftar file; untuk memeriksa TL
gudang pengembangan.

conf [texmf|tlmgr|updmap [--conffile fillet] [--menghapus] [kunci [nilai]]]
Dengan hanya "conf", tampilkan informasi konfigurasi umum untuk TeX Live, termasuk aktif
file konfigurasi, pengaturan jalur, dan banyak lagi. Ini seperti panggilan "texconfig conf", tapi
bekerja pada semua platform yang didukung.

Dengan "conf texmf", "conf tlmgr", atau "conf updmap" diberikan sebagai tambahan, menampilkan semua
pasangan kunci/nilai (yaitu, semua pengaturan) seperti yang disimpan di "ROOT/texmf.cnf", konfigurasi tlmgr
file (lihat di bawah), atau yang pertama ditemukan (melalui kpsewhich) masing-masing file "updmap.cfg".

If kunci diberikan sebagai tambahan, menunjukkan nilai hanya itu kunci dalam file yang bersangkutan. Jika
Option --menghapus juga diberikan, file konfigurasi -- dihapus, bukan hanya dikomentari
di luar!

If nilai diberikan sebagai tambahan, kunci diatur ke nilai dalam file yang bersangkutan. Tidak kesalahan
memeriksa is selesai!

Dalam semua kasus, file yang digunakan dapat ditentukan secara eksplisit melalui opsi "--conffile mengajukan",
dalam kasus seseorang ingin beroperasi pada file yang berbeda.

Aplikasi praktis: jika eksekusi (beberapa atau semua) perintah sistem melalui "\write18"
dibiarkan diaktifkan selama instalasi, Anda dapat menonaktifkannya setelah itu:

tlmgr conf texmf shell_escape 0

Contoh yang lebih rumit: pohon "TEXMFHOME" (lihat panduan utama TeX Live,
<http://tug.org/texlive/doc.html>) dapat diatur ke beberapa direktori, tetapi harus
diapit dalam kurung kurawal dan dipisahkan dengan koma, jadi mengutip nilai ke shell adalah bagus
ide. Dengan demikian:

tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}"

Peringatan: Fasilitas umum ada di sini, tetapi mengutak-atik pengaturan dengan cara ini sangat
sangat putus asa. Sekali lagi, tidak ada pemeriksaan kesalahan pada kunci atau nilai yang dilakukan, jadi apa pun
semacam kerusakan adalah mungkin.

dump-tlpdb [--lokal|--jarak jauh]
Buang TLPDB lokal atau jarak jauh lengkap ke output standar, apa adanya. Outputnya analog dengan
keluaran "--mesin-terbaca"; lihat bagian "OUTPUT YANG DAPAT DIBACA MESIN".

Pilihan:

--lokal
Buang tlpdb lokal.

--terpencil
Buang tlpdb jarak jauh.

Tepat satu dari "--local" dan "--remote" harus diberikan.

Dalam kedua kasus, baris pertama dari output menentukan lokasi repositori, dalam hal ini
format:

"lokasi-url" "\t" lokasi

di mana "location-url" adalah nama bidang literal, diikuti oleh tab, dan tempat adalah
file atau url ke repositori.

Ujung baris dapat berupa LF atau CRLF tergantung pada platform saat ini.

menghasilkan [Option] ... apa
menghasilkan bahasa
menghasilkan bahasa.dat
menghasilkan bahasa.def
menghasilkan bahasa.dat.lua

Tindakan "hasilkan" menimpa semua perubahan manual yang dibuat di masing-masing file: it
membuatnya kembali dari awal berdasarkan informasi dari paket yang diinstal, ditambah lokal
adaptasi. Pemasang TeX Live dan "tlmgr" secara rutin memanggil "hasilkan" untuk semua ini
file.

Untuk mengelola font Anda sendiri, silakan baca informasi "updmap --help" dan/atau
<http://tug.org/fonts/fontinstall.html>.

Untuk mengelola format Anda sendiri, silakan baca informasi "fmtutil --help".

Lebih detail: "generate" membuat ulang salah satu file konfigurasi "language.dat",
"language.def", dan "language.dat.lua" dari informasi yang ada di TLPDB lokal,
ditambah file yang dikelola secara lokal.

File yang dikelola secara lokal adalah "language-local.dat", "language-local.def", atau
"language-local.dat.lua", cari di "TEXMFLOCAL" di direktori masing-masing. Jika
tambahan lokal hadir, file akhir dibuat dengan memulai dengan file utama,
menghilangkan entri apa pun yang ditentukan oleh file lokal untuk dinonaktifkan, dan akhirnya menambahkan
berkas lokal.

(Catatan sejarah: "updmap-local.cfg" dan "fmtutil-local.cnf" yang sebelumnya didukung bukan
dibaca lebih lama, karena "updmap" dan "fmtutil" sekarang membaca dan mendukung banyak konfigurasi
file. Dengan demikian, tambahan lokal dapat dan harus dimasukkan ke dalam "updmap.cfg" dari "fmtutil.cnf"
file dalam "TEXMFLOCAL". Tindakan "hasilkan updmap" dan "hasilkan fmtutil" tidak lagi
ada.)

File lokal menentukan entri yang akan dinonaktifkan dengan baris komentar, yaitu salah satunya:

%!NAMA
--!NAMA

di mana "language.dat" dan "language.def" menggunakan "%", dan "language.dat.lua" menggunakan "--". Secara keseluruhan
kasus, nama adalah nama format masing-masing atau pengidentifikasi pola tanda hubung.
contoh:

%!Jerman
--!useenglishmax

(Tentu saja, Anda tidak mungkin benar-benar ingin menonaktifkan item tertentu. Mereka adalah
contoh saja.)

Setelah baris penonaktifan seperti itu, file lokal dapat menyertakan entri lain untuk item yang sama,
jika definisi yang berbeda diinginkan. Secara umum, kecuali untuk jalur penonaktifan khusus,
file lokal mengikuti sintaks yang sama dengan file master.

Formulir "hasilkan bahasa" membuat ulang ketiga file "bahasa.dat", "bahasa.def", dan
"language.dat.lua", sedangkan formulir dengan ekstensi hanya membuat ulang bahasa yang diberikan
file.

Pilihan:

--tujuan berkas keluaran
menentukan file output (default ke lokasi masing-masing di "TEXMFSYSVAR"). Jika
"--dest" diberikan untuk "menghasilkan bahasa", ini berfungsi sebagai nama dasar di mana ".dat"
akan ditambahkan untuk nama file keluaran "language.dat", ".def" akan menjadi
ditambahkan ke nilai untuk nama file keluaran "language.def", dan ".dat.lua"
dengan nama file "language.dat.lua". (Ini hanya untuk menghindari penimpaan; jika
Anda menginginkan nama spesifik untuk setiap file keluaran, kami sarankan untuk menggunakan "tlmgr" dua kali.)

--localfg local_conf_file
menentukan tambahan lokal (opsional) (default ke lokasi masing-masing di
"TEKSMFLOKAL").

--membangun kembali-sys
memberitahu tlmgr untuk menjalankan program yang diperlukan setelah file konfigurasi dibuat ulang. Ini
adalah: "fmtutil-sys --all" setelah "generate fmtutil", "fmtutil-sys --byhyphen
.../language.dat" setelah "generate language.dat", dan "fmtutil-sys --byhyphen
.../language.def" setelah "generate language.def".

Panggilan berikutnya ini menyebabkan file yang baru dibuat benar-benar berlaku. Ini
tidak dilakukan secara default karena panggilan itu adalah proses yang panjang dan orang mungkin ingin
membuat beberapa perubahan terkait berturut-turut sebelum menjalankan program ini.

Lokasi masing-masing adalah sebagai berikut:

tex/generic/config/language.dat (dan language-local.dat);
tex/generic/config/language.def (dan language-local.def);
tex/generic/config/language.dat.lua (dan language-local.dat.lua);

gui
Mulai antarmuka pengguna grafis. Lihat GUI di bawah.

Info [Option...] [koleksi|skema|pkg...]
Tanpa argumen, daftar semua paket yang tersedia di repositori paket, awali itu
sudah diinstal dengan "i".

Dengan satu kata "koleksi" atau "skema" sebagai argumen, cantumkan jenis permintaan
alih-alih semua paket.

Dengan argumen lain, tampilkan informasi tentang pkg: nama, kategori, pendek dan
deskripsi panjang, status instalasi, dan nomor revisi TeX Live. Jika pkg tidak
diinstal secara lokal, mencari di sumber instalasi jarak jauh.

If pkg tidak ditemukan secara lokal atau jarak jauh, tindakan pencarian digunakan dan daftar yang cocok
paket dan file.

Ini juga menampilkan informasi yang diambil dari Katalog TeX, yaitu versi paket,
tanggal, dan lisensi. Pertimbangkan ini, terutama versi paket, sebagai perkiraan
hanya, karena kemiringan waktu pembaruan dari bagian yang berbeda. Sebaliknya,
nilai "revisi" datang langsung dari TL dan dapat diandalkan.

Tindakan sebelumnya "tampilkan" dan "daftar" digabungkan ke dalam tindakan ini, tetapi masih didukung
untuk kompatibilitas mundur.

Pilihan:

--Daftar
Jika opsi "--list" diberikan dengan sebuah paket, daftar file yang ada juga
ditampilkan, termasuk untuk dependensi khusus platform. Ketika diberikan dengan skema
dan koleksi, "--list" mengeluarkan dependensinya dengan cara yang sama.

--hanya-dipasang
Jika opsi ini diberikan, sumber instalasi tidak akan digunakan; hanya secara lokal
paket, koleksi, atau skema yang diinstal terdaftar. (Tidak berfungsi untuk daftar
paket untuk saat ini)

init-usertree
Menyiapkan pohon texmf untuk apa yang disebut manajemen mode pengguna, baik pohon pengguna default
("TEXMFHOME"), atau yang ditentukan pada baris perintah dengan "--usertree". Lihat "MODE PENGGUNA"
di bawah.

install [Option] ... pkg...
Pasang masing-masing pkg diberikan pada baris perintah, jika belum diinstal. (Itu tidak
sentuh paket yang ada; lihat tindakan "perbarui" untuk cara mendapatkan versi terbaru a
paket.)

Secara default ini juga menginstal semua paket yang diberikan pkgs tergantung.
Pilihan:

--lari-kering
Tidak ada yang benar-benar diinstal; sebagai gantinya, tindakan yang akan dilakukan ditulis ke
terminal.

--mengajukan
Alih-alih mengambil paket dari repositori instalasi, gunakan file paket
diberikan pada baris perintah. File-file ini harus berupa file paket TeX Live standar (dengan
berisi file tlpobj).

--memaksa
Jika pembaruan untuk "tlmgr" itu sendiri (atau bagian lain dari infrastruktur dasar) ada,
"tlmgr" akan keluar dan tidak melakukan instalasi kecuali opsi ini diberikan.
Tidak direkomendasikan.

--tidak-tergantung
Jangan menginstal dependensi. (Secara default, menginstal paket memastikan bahwa semua
dependensi paket ini terpenuhi.)

--tidak-tergantung-sama sekali
Biasanya, ketika Anda menginstal paket yang mengirimkan file biner, biner masing-masing
paket juga akan diinstal. Artinya, untuk paket "foo", paket
"foo.i386-linux" juga akan diinstal pada sistem "i386-linux". Pilihan ini
menekan perilaku ini, dan juga menyiratkan "--tidak-tergantung". Jangan menggunakannya kecuali Anda
yakin dengan apa yang Anda lakukan.

--instal ulang
Instal ulang paket (termasuk dependensi untuk koleksi) meskipun sepertinya sudah
untuk diinstal (yaitu, ada di TLPDB). Ini berguna untuk pulih dari
penghapusan file secara tidak sengaja dalam hierarki.

Saat menginstal ulang, hanya dependensi pada paket normal yang diikuti (yaitu, bukan itu
kategori Skema atau Koleksi).

--dengan-dok
--dengan-src
Meskipun tidak disarankan, program "install-tl" menyediakan opsi untuk menghilangkan
instalasi semua dokumentasi dan/atau file sumber. (Secara default, semuanya adalah
diinstal.) Setelah instalasi seperti itu, Anda mungkin menemukan bahwa Anda menginginkan dokumentasi
atau file sumber untuk paket tertentu. Anda bisa mendapatkannya dengan menggunakan ini
opsi dalam hubungannya dengan "--reinstall", seperti pada (menggunakan paket "fontspec" sebagai
contoh):

tlmgr instal --instal ulang --dengan-doc --dengan-src fontpec

Option
Option [menunjukkan]
Option tunjukkan semua
Option kunci [nilai]

Formulir pertama menunjukkan pengaturan TeX Live global yang saat ini disimpan di TLPDB dengan a
deskripsi singkat dan "kunci" yang digunakan untuk mengubahnya dalam tanda kurung.

Bentuk kedua serupa, tetapi juga menunjukkan opsi yang dapat ditentukan tetapi tidak
saat ini disetel ke nilai apa pun.

Dalam bentuk ketiga, jika nilai tidak diberikan, pengaturan untuk kunci ditampilkan. Jika nilai is
hadiah, kunci diatur ke nilai.

Nilai yang mungkin untuk kunci are (jalankan "tlmgr option showall" untuk daftar definitif):

repositori (repositori paket default),
format (membuat format pada saat instalasi),
kode pos (jalankan gumpalan kode postinst)
docfiles (instal file dokumentasi),
srcfiles (menginstal file sumber),
backupdir (direktori default untuk backup),
autobackup (jumlah cadangan yang harus disimpan).
sys_bin (direktori tempat executable ditautkan oleh aksi jalur)
sys_man (direktori ke mana halaman manual ditautkan oleh aksi jalur)
sys_info (direktori tempat file Info ditautkan oleh tindakan jalur)
desktop_integration (Khusus Windows: buat pintasan menu Mulai)
fileassocs (Khusus Windows: ubah asosiasi file)
multiuser (hanya Windows: instal untuk semua pengguna)

Salah satu penggunaan umum "opsi" adalah mengubah instalasi secara permanen untuk melangkah lebih jauh
update dari Internet, setelah awalnya menginstal dari DVD. Untuk melakukan ini, Anda dapat menjalankan

repositori opsi tlmgr http://mirror.ctan.org/systems/texlive/tlnet

Dokumentasi "install-tl" memiliki lebih banyak informasi tentang kemungkinan nilai untuk
"gudang". (Untuk kompatibilitas mundur, "lokasi" dapat digunakan sebagai nama alternatif untuk
"gudang".)

Jika "format" disetel (ini adalah default), maka format akan dibuat ulang saat
mesin atau format file telah berubah. Nonaktifkan ini hanya ketika Anda tahu siapa Anda
perbuatan.

Opsi "kode pos" mengontrol eksekusi kode tindakan pascainstalasi per paket. Dia
diatur secara default, dan sekali lagi penonaktifan sepertinya tidak menarik kecuali mungkin untuk
pengembang.

Opsi "docfiles" dan "srcfiles" mengontrol penginstalan file masing-masing
dari sebuah paket. Secara default keduanya diaktifkan (1). Ini dapat dinonaktifkan (diatur ke 0) jika disk
ruang (sangat) terbatas.

Opsi "autobackup" dan "backupdir" menentukan default untuk tindakan "update",
"cadangkan" dan "kembalikan". Ketiga tindakan ini memerlukan direktori untuk membaca atau menulis
cadangan. Jika "--backupdir" tidak ditentukan pada baris perintah, "backupdir"
nilai opsi digunakan (jika disetel).

Opsi "pencadangan otomatis" (nonaktifkan) mengaktifkan pembuatan cadangan otomatis. Nilainya adalah
bilangan bulat. Jika nilai "autobackup" adalah "-1", tidak ada cadangan yang dihapus. Jika "autobackup" adalah 0
atau lebih, ini menentukan jumlah cadangan yang harus disimpan. Dengan demikian, pencadangan dinonaktifkan jika
nilainya adalah 0. Dalam mode "--clean" dari tindakan "cadangan" opsi ini juga menentukan
nomor yang akan disimpan.

Untuk mengatur "autobackup" ke "-1" pada baris perintah, gunakan:

opsi tlmgr -- pencadangan otomatis -1

"--" menghindari "-1" diperlakukan sebagai opsi. ("--" berhenti menguraikan opsi di
titik di mana ia muncul; ini adalah fitur umum di sebagian besar program Unix.)

Opsi "sys_bin", "sys_man", dan "sys_info" digunakan pada sistem mirip Unix untuk mengontrol
pembuatan tautan untuk file yang dapat dieksekusi, file info, dan halaman manual. Lihat aksi "jalan"
untuk rincian.

Tiga opsi terakhir mengontrol perilaku pada penginstalan Windows. Jika
"desktop_integration" diatur, kemudian beberapa paket akan menginstal item dalam sub-folder dari
Menu mulai untuk "tlmgr gui", dokumentasi, dll. Jika "fileassocs" diatur, file Windows
asosiasi dibuat (lihat juga tindakan "pasca tindakan"). Terakhir, jika "multiuser" disetel,
kemudian adaptasi ke registri dan menu dilakukan untuk semua pengguna di sistem sebagai gantinya
hanya dari pengguna saat ini. Ketiga opsi diaktifkan secara default.

kertas
kertas [a4|surat]
[xdvi|pdftex|dvips|dvipdfmx|konteks|psutils] kertas [ukuran kertas|--daftar]

Tanpa argumen ("tlmgr paper"), menunjukkan pengaturan ukuran kertas default untuk semua yang diketahui
program.

Dengan satu argumen (misalnya, "tlmgr paper a4"), setel default untuk semua program yang dikenal ke
ukuran kertas itu.

Dengan program yang diberikan sebagai argumen pertama dan tidak ada ukuran kertas yang ditentukan (mis., "tlmgr dvips
kertas"), menunjukkan ukuran kertas default untuk program itu.

Dengan program yang diberikan sebagai argumen pertama dan ukuran kertas sebagai argumen terakhir (mis.
"tlmgr dvips paper a4"), atur default untuk program itu ke ukuran kertas itu.

Dengan program yang diberikan sebagai argumen pertama dan "--list" diberikan sebagai argumen terakhir (mis.
"tlmgr dvips paper --list"), menunjukkan semua ukuran kertas yang valid untuk program itu. Ukuran pertama
ditampilkan adalah default.

Kebetulan, sintaks memiliki nama program tertentu sebelum kata kunci "kertas" adalah
tidak biasa. Itu diwarisi dari skrip "texconfig" lama, yang mendukung lainnya
pengaturan konfigurasi untuk beberapa program, terutama "dvips". "tlmgr" tidak mendukung itu
pengaturan tambahan.

path [--w32mode=pengguna|admin] [tambahkan|hapus]
Di Unix, cukup tambahkan atau hapus symlink untuk binari, halaman manual, dan halaman info di
direktori sistem yang ditentukan oleh opsi masing-masing (lihat deskripsi "opsi"
di atas). Tidak mengubah file inisialisasi apa pun, baik sistem maupun pribadi.

Di Windows, bagian registri tempat direktori biner ditambahkan atau dihapus ditentukan
dengan cara berikut:

Jika pengguna memiliki hak admin, dan opsi "--w32mode" tidak diberikan, pengaturan
w32_multi_pengguna menentukan lokasi (yaitu, jika ada di jalur sistem, jika tidak
jalur pengguna diubah).

Jika pengguna memiliki hak admin, dan opsi "--w32mode" diberikan, opsi ini menentukan
jalan yang akan disesuaikan.

Jika pengguna tidak memiliki hak admin, dan opsi "--w32mode" tidak diberikan, dan
pengaturan w32_multi_pengguna dimatikan, jalur pengguna diubah, sedangkan jika pengaturan
w32_multi_pengguna aktif, peringatan dikeluarkan bahwa penelepon tidak memiliki hak yang cukup.

Jika pengguna tidak memiliki hak admin, dan opsi "--w32mode" diberikan, itu harus
pemakai dan jalur pengguna akan disesuaikan. Jika pengguna tanpa hak admin menggunakan opsi
"--w32mode admin" peringatan dikeluarkan bahwa pemanggil tidak memiliki hak yang cukup.

menjepit
Tindakan "menyematkan" mengelola file menyematkan, lihat "Menyematkan" di bawah.

"pertunjukan pin"
Menampilkan data penyematan saat ini.

"menyematkan tambah" repo pkgglob...
Sematkan paket yang cocok dengan pkgglob(s) ke repositori repo.

"penjepit hapus" repo pkgglob...
Paket apa pun yang direkam dalam file penyematan yang cocok dengan s untuk yang diberikan
gudang repo dihapus.

"menyematkan menghapus repo --semua"
Hapus semua data penyematan untuk repositori repo.

Platform daftar|tambah|hapus Platform...
Platform set Platform
Platform set mobil
"daftar platform" mencantumkan nama TeX Live dari semua platform (alias arsitektur),
("i386-linux", ...) tersedia di repositori paket.

"tambahan platform" Platform... menambahkan executable untuk setiap platform yang diberikan Platform ke
instalasi dari repositori.

"penghapusan platform" Platform... menghapus executable untuk setiap platform yang diberikan Platform
dari instalasi, tetapi tetap menjalankan platform yang sedang berjalan dalam hal apa pun.

"set platform" Platform mengalihkan TeX Live untuk selalu menggunakan platform yang diberikan alih-alih otomatis
deteksi.

"platform set auto" mengalihkan TeX Live ke mode deteksi otomatis untuk platform.

Deteksi platform diperlukan untuk memilih biner "xz", "xzdec" dan "wget" yang tepat yang
dikirimkan dengan TeX Live.

"lengkungan" adalah sinonim untuk "platform".

Pilihan:

--lari-kering
Tidak ada yang benar-benar diinstal; sebagai gantinya, tindakan yang akan dilakukan ditulis ke
terminal.

pascaaksi [--w32mode=pengguna|admin] [--fileassocmode=1|2] [--semua] [instal|hapus]
[pintasan|fileassoc|skrip] [pkg] ...
Lakukan "pintasan" pasca-aksi, "fileassoc", atau "skrip" yang diberikan sebagai persyaratan kedua
argumen dalam mode instal atau hapus (yang merupakan argumen pertama yang diperlukan), baik untuk
paket yang diberikan pada baris perintah, atau untuk semua jika "--semua" diberikan.

Jika opsi "--w32mode" diberi nilai "pengguna", semua tindakan hanya akan dilakukan
di bagian registri/sistem file yang dapat diakses pengguna, sedangkan nilai "admin" memilih
bagian seluruh sistem dari registri untuk asosiasi file. Kalau kamu tidak punya
izin yang cukup, menggunakan "--w32mode=admin" tidak akan berhasil.

"--fileassocmode" menentukan tindakan untuk asosiasi file. Jika disetel ke 1 (
default), hanya asosiasi baru yang ditambahkan; jika diatur ke 2, semua asosiasi diatur ke
program TeX Live. (Lihat juga "option fileassocs".)

platform cetak
Cetak pengenal TeX Live untuk platform yang terdeteksi (perangkat keras/sistem operasi)
kombinasi ke output standar, dan keluar. "--print-arch" adalah sinonim.

menghapus [Option] ... pkg...
Hapus masing-masing pkg ditentukan. Menghapus koleksi menghapus semua dependensi paket (kecuali
"--no-depends" ditentukan), tetapi bukan dependensi koleksi apa pun dari koleksi itu.
Namun, saat menghapus sebuah paket, dependensi tidak pernah dihapus. Pilihan:

--tidak-tergantung
Jangan hapus paket dependen.

--tidak-tergantung-sama sekali
Lihat di atas di bawah install (dan berhati-hatilah).

--memaksa
Secara default, penghapusan paket atau koleksi yang merupakan ketergantungan dari yang lain
pengumpulan atau skema tidak diperbolehkan. Dengan opsi ini, paket akan dihapus
tanpa syarat. Gunakan dengan hati-hati.

Paket yang telah dihapus menggunakan opsi "--force" karena masih terdaftar
dalam koleksi atau skema yang diinstal tidak akan diperbarui, dan akan disebutkan sebagai
secara paksa dihapus dalam keluaran tlmgr.dll memperbarui --Daftar.

--lari-kering
Tidak ada yang benar-benar dihapus; sebagai gantinya, tindakan yang akan dilakukan ditulis ke
terminal.

gudang
gudang daftar
gudang daftar jalur|tag
gudang menambahkan path [label]
gudang menghapus jalur|tag
gudang set path[#label] [path[#label] ...]
Tindakan ini mengelola daftar repositori. Lihat "MULTIPLE REPOSITORIES" di bawah untuk
penjelasan rinci.

Formulir pertama ("daftar") mencantumkan semua repositori yang dikonfigurasi dan tag masing-masing jika
mengatur. Jika jalur, url, atau tag diberikan setelah kata kunci "daftar", itu ditafsirkan sebagai
sumber dari mana untuk menginisialisasi TeX Live Database dan daftar paket yang ada.
Ini juga bisa menjadi repositori yang saat ini tidak digunakan, baik secara lokal maupun jarak jauh. Jika satu
berikan tambahan "--with-platforms", untuk setiap paket platform yang tersedia (jika ada)
terdaftar juga.

Bentuk ketiga ("tambahkan") menambahkan repositori (opsional melampirkan tag) ke daftar
repositori. Formulir keempat ("hapus") menghapus repositori, baik secara penuh
jalur/url, atau dengan tag. Formulir terakhir ("set") mengatur daftar repositori ke item
diberikan pada baris perintah, tidak menyimpan pengaturan sebelumnya

Dalam semua kasus, salah satu repositori harus ditandai sebagai "utama"; jika tidak, semua
operasi akan gagal!

mengembalikan [--cadangandir dir] [--semua | pkg [putaran]]
Pulihkan paket dari cadangan yang dibuat sebelumnya.

Jika "--semua" diberikan, coba pulihkan revisi terbaru dari semua cadangan paket yang ditemukan di
direktori cadangan.

Jika tidak, jika tidak pkg maupun putaran diberikan, daftar revisi cadangan yang tersedia untuk semua
paket. Dengan pkg diberikan tapi tidak putaran, daftar semua revisi cadangan yang tersedia dari pkg.

Saat mendaftar paket yang tersedia, tlmgr menunjukkan revisi, dan dalam tanda kurung pembuatannya
waktu jika tersedia (dalam format yyyy-mm-dd jj:mm).

Jika (dan hanya jika) keduanya pkg dan nomor revisi yang valid putaran ditentukan, coba pulihkan
paket dari cadangan yang ditentukan.

Pilihan:

--semua
Coba pulihkan revisi terbaru dari semua cadangan paket yang ditemukan di cadangan
direktori. Argumen non-opsi tambahan (seperti pkg) tidak diizinkan.

--cadangandir direktori
Tentukan direktori tempat cadangan dapat ditemukan. Jika tidak diberikan akan diambil
dari pengaturan konfigurasi di TLPDB.

--lari-kering
Tidak ada yang benar-benar dipulihkan; sebagai gantinya, tindakan yang akan dilakukan ditulis ke
terminal.

--memaksa
Jangan bertanya.

Cari [Option...] apa
Cari [pilihan...] --mengajukan apa

Cari [pilihan...] --semua apa

Secara default, cari nama, deskripsi singkat, dan deskripsi panjang dari semua secara lokal
paket yang diinstal untuk argumen apa, ditafsirkan sebagai ekspresi reguler (Perl).

Pilihan:

--mengajukan
Daftar semua nama file yang mengandung apa.

--semua
Cari semuanya: nama paket, deskripsi, dan nama file.

--global
Cari TeX Live Database dari media instalasi, bukan lokal
instalasi.

--kata
Batasi pencarian nama dan deskripsi paket (tetapi bukan nama file) agar sesuai
hanya kata-kata penuh. Misalnya, mencari "tabel" dengan opsi ini tidak akan ditampilkan
paket yang berisi kata "tabel" (kecuali jika juga mengandung kata "tabel" di
miliknya).

uninstall
Menghapus seluruh instalasi TeX Live. Pilihan:

--memaksa
Jangan minta konfirmasi, langsung hapus.

memperbarui [Option] ... [pkg] ...
Memperbarui paket yang diberikan sebagai argumen ke versi terbaru yang tersedia di
sumber instalasi. Entah "--semua" atau setidaknya satu pkg nama harus ditentukan. Pilihan:

--semua
Perbarui semua paket yang diinstal kecuali untuk "tlmgr" itu sendiri. Jadi, jika pembaruan ke "tlmgr"
sendiri hadir, ini hanya akan memberikan kesalahan, kecuali juga opsi "--force"
atau "--self" diberikan. (Lihat di bawah.)

Selain memperbarui paket yang diinstal, selama pembaruan koleksi
instalasi lokal (secara default) disinkronkan dengan status koleksi di
server, baik untuk penambahan dan penghapusan.

Ini berarti bahwa jika sebuah paket telah dihapus di server (dan dengan demikian juga telah
dihapus dari koleksi masing-masing), "tlmgr" akan menghapus paket di lokal
instalasi. Ini disebut ``hapus otomatis'' dan diumumkan seperti itu saat menggunakan
opsi "--daftar". Penghapusan otomatis ini dapat ditekan menggunakan opsi
"--no-auto-remove" (tidak disarankan, lihat deskripsi opsi).

Analoginya, jika sebuah paket telah ditambahkan ke koleksi di server yang juga
diinstal secara lokal, itu akan ditambahkan ke instalasi lokal. Ini disebut
``instal otomatis'' dan diumumkan seperti itu saat menggunakan opsi "--list". Otomatis ini
instalasi dapat ditekan menggunakan opsi "--no-auto-install".

Pengecualian untuk pemeriksaan ketergantungan koleksi (termasuk penginstalan otomatis dari
paket yang baru saja disebutkan) adalah yang telah ``dihapus secara paksa'' oleh Anda, itu
adalah, Anda memanggil "tlmgr remove --force" pada mereka. (Lihat tindakan "hapus"
dokumentasi.) Untuk menginstal ulang paket yang dihapus secara paksa, gunakan
"--instal ulang-dihapus paksa".

Jika Anda ingin mengecualikan beberapa paket dari menjalankan pembaruan saat ini (misalnya, karena lambat
link), lihat opsi "--exclude" di bawah.

--diri sendiri
Perbarui "tlmgr" itu sendiri (yaitu, paket infrastruktur) jika pembaruan itu
hadiah. Di Windows, ini termasuk pembaruan untuk penerjemah Perl pribadi yang dikirimkan
di dalam TeX Live.

Jika opsi ini diberikan bersama dengan "--all" atau daftar paket, maka
"tlmgr" akan diperbarui terlebih dahulu dan, jika pembaruan ini berhasil, versi baru akan
restart untuk menyelesaikan sisa pembaruan.

Singkatnya:

tlmgr update --self # update infrastruktur saja
tlmgr update --self --all # update infrastruktur dan semua paket
tlmgr update --force --all # update semua paket tapi *bukan* infrastruktur
# ... ini risiko Anda sendiri, tidak disarankan!

--lari-kering
Tidak ada yang benar-benar diinstal; sebagai gantinya, tindakan yang akan dilakukan ditulis ke
terminal. Ini adalah laporan yang lebih rinci daripada "--list".

--Daftar [pkg]
Cantumkan secara ringkas paket-paket yang akan diperbarui, baru diinstal, atau dihapus,
tanpa benar-benar mengubah apa pun. Jika "--semua" juga diberikan, semua pembaruan tersedia
terdaftar. Jika "--self" diberikan, tetapi tidak "--all", hanya pembaruan ke kritis
paket (tlmgr, infrastruktur texlive, perl di Windows, dll.) terdaftar. Jika
baik "--all" atau "--self" tidak diberikan, dan sebagai tambahan tidak pkg diberikan, maka "--semua"
diasumsikan (dengan demikian, "tlmgr update --list" sama dengan "tlmgr update --list --all").
Jika "--all" atau "--self" tidak diberikan, tetapi nama paket tertentu diberikan, itu
paket diperiksa untuk pembaruan.

--mengecualikan pkg
Mengecualikan pkg dari proses pembaruan. Jika opsi ini diberikan lebih dari sekali, itu
argumen menumpuk.

Sebuah argumen pkg tidak termasuk kedua paket pkg itu sendiri dan semua platform terkait-
paket tertentu pkg.ARCH. Sebagai contoh,

pembaruan tlmgr --semua --kecualikan a2ping

tidak akan memperbarui "a2ping", "a2ping.i386-linux", atau "a2ping" lainnya.LENGKUNGAN paket.

Jika opsi ini menentukan paket yang akan menjadi kandidat untuk auto-
penginstalan, penghapusan otomatis, atau penginstalan ulang paket yang dihapus secara paksa, "tlmgr"
berhenti dengan pesan kesalahan. Pengecualian tidak didukung dalam situasi ini.

--no-hapus-otomatis [pkg] ...
Secara default, "tlmgr" mencoba menghapus paket yang hilang di server, sebagai
dijelaskan di atas di bawah "--semua". Opsi ini mencegah penghapusan tersebut, baik untuk semua
paket (dengan "--semua"), atau hanya yang diberikan pkg nama. Hal ini dapat menyebabkan
instalasi TeX tidak konsisten, karena paket tidak jarang berganti nama atau diganti
oleh penulis mereka. Oleh karena itu hal ini tidak direkomendasikan.

--tanpa-instal otomatis [pkg] ...
Dalam keadaan normal "tlmgr" akan menginstal paket-paket yang baru di server,
seperti dijelaskan di atas di bawah "--semua". Opsi ini mencegah otomatis
instalasi, baik untuk semua paket (dengan "--semua"), atau yang diberikan pkg nama.

Selanjutnya, setelah "tlmgr" dijalankan menggunakan ini selesai, paket-paket yang akan
telah terinstal otomatis akan be dianggap as secara paksa dihapus. Jadi, jika "foobar" adalah
satu-satunya paket baru di server, lalu

pembaruan tlmgr --all --no-auto-install

adalah setara dengan

pembaruan tlmgr --semua
tlmgr hapus --force foobar

--instal ulang-dihapus paksa
Dalam keadaan normal "tlmgr" tidak akan menginstal paket yang telah di paksa
dihapus oleh pengguna; yaitu, dihapus dengan "remove --force", atau yang pemasangannya
dilarang oleh "--no-auto-install" selama pembaruan sebelumnya.

Opsi ini membuat "tlmgr" mengabaikan penghapusan paksa dan menginstal ulang semua itu
paket. Ini dapat digunakan untuk sepenuhnya menyinkronkan instalasi dengan server
ide tentang apa yang tersedia:

pembaruan tlmgr --instal ulang-dihapus paksa --semua

--cadangan dan --cadangandir direktori
Kedua opsi ini mengontrol pembuatan cadangan paket sebelum memperbarui; itu
adalah, mem-backup paket-paket yang saat ini diinstal. Jika tidak satu pun dari opsi ini diberikan,
tidak ada paket cadangan yang akan disimpan. Jika "--backupdir" diberikan dan menentukan yang dapat ditulis
direktori maka cadangan akan dibuat di lokasi itu. Jika hanya "--backup" yang diberikan,
kemudian cadangan akan dibuat ke direktori yang sebelumnya disetel melalui tindakan "opsi"
(Lihat di bawah). Jika keduanya diberikan maka cadangan akan dibuat untuk yang ditentukan direktori.

Anda dapat mengatur opsi melalui tindakan "opsi" untuk secara otomatis membuat cadangan untuk semua
paket, dan/atau hanya menyimpan sejumlah cadangan tertentu. Silakan lihat "opsi"
tindakan untuk rincian.

"tlmgr" selalu membuat cadangan sementara saat memperbarui paket, jika Anda mengunduh atau
kegagalan lainnya selama pembaruan. Sebaliknya, tujuan dari opsi "--cadangan" ini adalah
untuk memungkinkan Anda menyimpan cadangan persisten dalam kasus yang sebenarnya Konten dari pembaruan
menyebabkan masalah, misalnya, menimbulkan ketidakcocokan.

Tindakan "pulihkan" menjelaskan cara memulihkan dari cadangan.

--tidak-tergantung
Jika Anda menelepon untuk memperbarui paket biasanya semua paket tergantung juga akan
diperiksa untuk pembaruan dan diperbarui jika perlu. Switch ini menekan perilaku ini.

--tidak-tergantung-sama sekali
Lihat di atas di bawah install (dan berhati-hatilah).

--memaksa
Memaksa pembaruan paket normal, tanpa memperbarui "tlmgr" itu sendiri (kecuali "--self"
pilihan juga diberikan). Tidak direkomendasikan.

Juga, "update --list" masih dilakukan terlepas dari opsi ini.

Jika paket di server lebih lama dari paket yang sudah diinstal (misalnya, jika
cermin yang dipilih kedaluwarsa), "tlmgr" tidak diturunkan. Juga, paket untuk
platform yang dihapus tidak diinstal.

"tlmgr" menyimpan salinan file "texlive.tlpdb" yang digunakan untuk pembaruan dengan akhiran
mewakili url repositori, seperti dalam "tlpkg/texlive.tlpdb."hash-string panjang. Ini bisa
berguna untuk informasi fallback, tetapi jika Anda tidak suka informasi tersebut terakumulasi (mis
menjalankan "mirror.ctan.org" mungkin menyelesaikan ke Host baru, menghasilkan hash yang berbeda), itu
tidak berbahaya untuk menghapusnya.

PENGGUNA MODE

"tlmgr" menyediakan cara terbatas, yang disebut ``mode pengguna'', untuk mengelola pohon texmf arbitrer
dengan cara yang sama seperti instalasi utama. Misalnya, ini memungkinkan orang tanpa menulis
izin di lokasi instalasi untuk memperbarui/menginstal paket ke dalam pohon mereka
sendiri.

"tlmgr" dialihkan ke mode pengguna dengan opsi baris perintah "--usermode". Itu tidak
beralih secara otomatis, juga tidak ada pengaturan file konfigurasi untuk itu. Jadi, ini
opsi harus diberikan secara eksplisit setiap kali mode pengguna diaktifkan.

Mode "tlmgr" ini bekerja pada pohon pengguna, secara default nilai "TEXMFHOME"
variabel. Ini dapat diganti dengan opsi baris perintah "--usertree". Dalam
berikut ketika kami berbicara tentang pohon pengguna yang kami maksud adalah "TEXMFHOME" atau yang diberikan pada
baris perintah.

Tidak semua tindakan diizinkan dalam mode pengguna; "tlmgr" akan memperingatkan Anda dan tidak melakukan apa pun
tindakan bermasalah. Saat ini tidak didukung (dan mungkin tidak akan pernah) adalah
tindakan "platform". Tindakan "gui" saat ini tidak didukung, tetapi mungkin di masa mendatang
lepaskan.

Beberapa tindakan "tlmgr" tidak memerlukan izin menulis apa pun dan dengan demikian berfungsi sama dalam mode pengguna
dan modus biasa. Saat ini ini adalah: "periksa", "bantuan", "daftar", "platform cetak",
"cari", "tampilkan", "versi".

Di sisi lain, sebagian besar tindakan yang berhubungan dengan manajemen paket memang perlu menulis
izin, dan dengan demikian berperilaku berbeda dalam mode pengguna, seperti yang dijelaskan di bawah ini: "instal",
"perbarui", "hapus", "opsi", "kertas", "hasilkan", "cadangan", "pulihkan", "uninstall",
"symlink".

Sebelum menggunakan "tlmgr" dalam mode pengguna, Anda harus mengatur pohon pengguna dengan
tindakan "init-usertree". Ini menciptakan pohon pengguna"/ web2c" dan pohon pengguna"/tlpkg/tlpobj", dan a
minimal pohon pengguna"/tlpkg/texlive.tlpdb". Pada saat itu, Anda dapat memberi tahu "tlmgr" untuk melakukan
(didukung) tindakan dengan menambahkan opsi baris perintah "--usermode".

Dalam mode pengguna file pohon pengguna"/tlpkg/texlive.tlpdb" hanya berisi paket-paket yang memiliki
telah diinstal ke pohon pengguna menggunakan "tlmgr", ditambah opsi tambahan dari
Paket ``virtual'' "00texlive.installation" (mirip dengan instalasi utama
"texlive.tlpdb").

Semua tindakan pada paket dalam mode pengguna hanya dapat dilakukan pada paket yang dikenal sebagai
"dapat dipindahkan". Ini tidak termasuk semua paket yang berisi executable dan beberapa inti lainnya
paket. Dari 2500 atau lebih paket yang saat ini ada di TeX Live, sebagian besar adalah
relocatable dan dapat diinstal ke pohon pengguna.

Deskripsi perubahan tindakan dalam mode pengguna:

Pengguna mode install
Dalam mode pengguna, tindakan "instal" memeriksa apakah paket dan semua dependensi sudah lengkap
baik direlokasi atau sudah terpasang di sistem instalasi. Jika ini masalahnya, itu
membongkar semua wadah untuk dipasang ke pohon pengguna (untuk mengulang, itu juga
"TEXMFHOME" atau nilai "--usertree") dan tambahkan paket masing-masing ke pengguna
"texlive.tlpdb" pohon (membuatnya jika perlu).

Saat ini menginstal koleksi dalam mode pengguna menginstal semua paket dependen, tetapi dalam
kontras dengan mode normal, bukan? tidak instal koleksi dependen. Misalnya, dalam biasa
mode "tlmgr install collection-context" akan menginstal "collection-basic" dan lainnya
koleksi, saat dalam mode pengguna, hanya paket-paket yang disebutkan dalam "konteks koleksi" adalah
diinstal.

Pengguna mode cadangan mengembalikan, menghapus, memperbarui
Dalam mode pengguna, tindakan ini memeriksa apakah semua paket yang akan ditindaklanjuti telah diinstal di
pohon pengguna sebelum melanjutkan; jika tidak, mereka berperilaku seperti dalam mode normal.

Pengguna mode menghasilkan, pilihan, kertas
Dalam mode pengguna, tindakan ini hanya beroperasi pada file konfigurasi pohon pengguna dan/atau
"texlive.tlpdb". membuat file konfigurasi di pohon pengguna

KONFIGURASI FILE UNTUK TLMGR

Sebagian kecil dari opsi baris perintah dapat diatur dalam file konfigurasi untuk "tlmgr" yang
berada di "TEXMFCONFIG/tlmgr/config". Secara default, file konfigurasi ada di
"~/.texliveYYYY/texmf-config/tlmgr/config" (mengganti "YYYY" dengan tahun TeX Anda
Instalasi langsung). Ini adalah tidak "TEXMFSYSVAR", sehingga file tersebut khusus untuk satu
pengguna.

Dalam file ini, baris kosong dan baris yang dimulai dengan # diabaikan. Semua jalur lain harus
terlihat seperti

kunci = nilai

di mana kunci yang diizinkan adalah "gui-expertmode" (nilai 0 atau 1), "persistent-downloads" (nilai
0 atau 1), "auto-remove" (nilai 0 atau 1), dan "gui-lang" (nilai seperti di baris perintah
pilihan).

"persistent-downloads", "gui-lang", dan "auto-remove" sesuai dengan perintah masing-masing
opsi baris dengan nama yang sama. "gui-expertmode" beralih antara GUI lengkap dan a
GUI yang disederhanakan hanya dengan pengaturan penting dan paling sering digunakan.

GANDA REPOSITORI

Repositori TeX Live utama berisi beragam paket. Namun demikian, tambahan
repositori lokal dapat berguna untuk menyediakan sumber daya yang diinstal secara lokal, seperti
font berpemilik dan gaya rumah. Juga, repositori paket alternatif mendistribusikan
paket yang tidak dapat atau tidak boleh disertakan dalam TeX Live, karena alasan apa pun.

Metode paling sederhana dan paling dapat diandalkan adalah untuk sementara mengatur sumber instalasi ke sembarang
repositori (dengan opsi baris perintah "-repository" atau "option repository"), dan
melakukan operasi Anda.

Namun, ketika Anda menggunakan beberapa repositori dalam waktu yang berkelanjutan, secara eksplisit
beralih di antara mereka menjadi tidak nyaman. Jadi, mungkin untuk memberi tahu "tlmgr" tentang
repositori tambahan yang ingin Anda gunakan. Perintah dasarnya adalah "tlmgr repositori add".
Sisa bagian ini menjelaskan lebih lanjut.

Saat menggunakan beberapa repositori, salah satunya harus ditetapkan sebagai repositori utama, yang
mendistribusikan sebagian besar paket yang diinstal. Saat Anda beralih dari satu repositori
instalasi ke instalasi beberapa repositori, repositori tunggal sebelumnya adalah
ditetapkan sebagai repositori utama.

Secara default, bahkan jika beberapa repositori dikonfigurasi, paket tetap masih hanya
diinstal dari repositori utama. Jadi, hanya menambahkan repositori kedua tidak
benar-benar mengaktifkan instalasi apa pun dari sana. Anda juga harus menentukan yang mana
paket harus diambil dari repositori baru, dengan menentukan apa yang disebut ``pinning''
aturan, dijelaskan selanjutnya.

Menyematkan
Ketika paket "foo" disematkan ke repositori, paket "foo" di repositori lain,
bahkan jika memiliki nomor revisi yang lebih tinggi, tidak akan dianggap sebagai kandidat yang dapat diinstal.

Seperti disebutkan di atas, secara default semuanya disematkan ke repositori utama. Ayo pergi sekarang
melalui contoh pengaturan repositori kedua dan mengaktifkan pembaruan paket
dari situ.

Pertama, periksa apakah kami memiliki dukungan untuk beberapa repositori, dan hanya satu yang diaktifkan (sebagai
adalah kasusnya secara default):

$tlmgr daftar repositori
Daftar repositori (dengan tag jika disetel):
/var/www/norbert/tlnet

Oke. Mari tambahkan repositori "tlcontrib" (ini adalah repositori nyata, dihosting di
<http://tlcontrib.metatex.org>, dikelola oleh Taco Hoekwater et al.), dengan tag
"tlcontrib":

$ tlmgr repositori tambahkan http://tlcontrib.metatex.org/2012 kontribusi

Periksa kembali daftar repositori:

$tlmgr daftar repositori
Daftar repositori (dengan tag jika disetel):
http://tlcontrib.metatex.org/2012 (tlkontrib)
/var/www/norbert/tlnet (utama)

Sekarang kita tentukan entri penyematan untuk mendapatkan paket "konteks" dari "tlcontrib":

$ tlmgr menyematkan menambahkan konteks tlcontrib

Periksa apakah kami dapat menemukan "konteks":

$tlmgr tampilkan konteks
tlmgr: repositori paket:
...
paket: konteks
repositori: tlcontrib/26867
...

- instal "konteks":

$ tlmgr instal konteks
tlmgr: repositori paket:
...
[1/1, ??:??/??:??] instal: konteks @tlcontrib [

Pada output di sini Anda dapat melihat bahwa paket "konteks" telah diinstal dari
repositori "tlcontrib" (@tlcontrib).

Akhirnya, "tlmgr pinning" juga mendukung penghapusan paket tertentu atau semua dari yang diberikan
gudang:

$ tlmgr menyematkan menghapus konteks tlcontrib # menghapus konteks saja
$ tlmgr menyematkan menghapus tlcontrib --all # tidak mengambil apa pun dari tlcontrib

Ringkasan tindakan "tlmgr menyematkan" diberikan di atas.

GUI UNTUK TLMGR

Antarmuka pengguna grafis untuk "tlmgr" membutuhkan Perl/Tk untuk diinstal. Untuk Windows
modul yang diperlukan dikirimkan dalam TeX Live, untuk semua sistem lain (yaitu, berbasis Unix)
Perl/Tk (dan juga Perl tentunya) harus diinstal.
<http://tug.org/texlive/distro.html#perltk> memiliki daftar permintaan untuk beberapa distro.

Ketika dimulai dengan "tlmgr gui", antarmuka pengguna grafis akan ditampilkan. Jendela utama
berisi bilah menu, tampilan utama, dan area status tempat pesan biasanya ditampilkan
konsol ditampilkan.

Di dalam tampilan utama ada tiga bagian utama: area "Konfigurasi tampilan",
daftar paket, dan tombol tindakan.

Juga, di kanan atas repositori yang sedang dimuat ditampilkan; ini juga bertindak sebagai
tombol dan ketika diklik akan mencoba memuat repositori default. Untuk memuat yang berbeda
repositori, lihat item menu "tlmgr".

Terakhir, area status di bagian bawah jendela memberikan informasi tambahan tentang
apa yang sedang terjadi.

Utama pameran
Display konfigurasi daerah

Bagian pertama dari tampilan utama memungkinkan Anda untuk menentukan (filter) paket mana yang
ditampilkan. Secara default, semua ditampilkan. Perubahan di sini tercermin segera.

Status
Pilih apakah akan menampilkan semua paket (default), hanya yang terinstal, hanya yang
tidak diinstal, atau hanya yang memiliki pembaruan yang tersedia.

Kategori
Pilih kategori mana yang ditampilkan: paket, koleksi, dan/atau skema. Ini adalah
dijelaskan secara singkat di bagian "DESKRIPSI" di atas.

Cocok
Pilih paket yang cocok untuk pola tertentu. Secara default, ini mencari keduanya
deskripsi dan nama file. Anda juga dapat memilih subset untuk pencarian.

Seleksi
Pilih paket untuk yang dipilih, yang tidak dipilih, atau semuanya. Di sini, ``dipilih''
berarti kotak centang di awal baris paket dicentang.

Tampilkan tombol konfigurasi
Di sebelah kanan ada tiga tombol: pilih semua paket, pilih tidak ada (alias
hapus semua), dan setel ulang semua filter ini ke default, yaitu, tampilkan semua yang tersedia.

Paket daftar daerah

Yang kedua adalah daftar tampilan utama semua paket yang diinstal. Jika repositori adalah
dimuat, yang tersedia tetapi tidak diinstal juga terdaftar.

Mengklik dua kali pada baris paket akan memunculkan jendela informasi dengan perincian lebih lanjut:
deskripsi panjang, file yang disertakan, dll.

Setiap baris daftar paket terdiri dari item berikut:

kotak centang
Digunakan untuk memilih paket tertentu; beberapa tombol aksi (lihat di bawah) hanya berfungsi
pada paket yang dipilih.

nama paket
Nama (pengidentifikasi) paket seperti yang diberikan dalam database.

revisi lokal (dan versi)
Jika paket diinstal, nomor revisi TeX Live untuk paket yang diinstal
akan ditampilkan. Jika ada versi katalog yang diberikan dalam database untuk ini
paket, itu akan ditampilkan dalam tanda kurung. Namun, versi katalog, tidak seperti
Revisi TL, tidak dijamin mencerminkan apa yang sebenarnya diinstal.

revisi jarak jauh (dan versi)
Jika repositori telah dimuat, revisi paket dalam repositori (jika
hadir) ditampilkan. Seperti halnya kolom lokal, jika versi katalog disediakan, itu
akan ditampilkan. Dan juga seperti kolom lokal, versi katalog mungkin
basi.

Deskripsi Singkat
Deskripsi singkat paket.

Utama pameran tindakan tombol

Di bawah daftar paket ada beberapa tombol:

Perbarui semua yang diinstal
Ini memanggil "tlmgr update --all", yaitu, mencoba memperbarui semua paket yang tersedia. Di bawah
tombol ini adalah sakelar untuk mengizinkan penginstalan ulang paket yang sebelumnya dihapus sebagai bagian
dari tindakan ini.

Empat tombol lainnya hanya berfungsi pada paket yang dipilih, yaitu paket yang
kotak centang di awal baris paket dicentang.

Memperbarui
Perbarui hanya paket yang dipilih.

Install
Instal paket yang dipilih; bertindak seperti "tlmgr install", yaitu, juga menginstal
dependensi. Jadi, menginstal koleksi menginstal semua paket konstituennya.

Hapus
Menghapus paket yang dipilih; bertindak seperti "tlmgr remove", yaitu, itu juga akan menghapus
dependensi koleksi (tetapi bukan dependensi paket normal).

backup
Membuat cadangan dari paket yang dipilih; bertindak seperti "cadangan tlmgr". Tindakan ini membutuhkan
set opsi "backupdir" (lihat "Opsi -" Umum>).

menu bar
Entri berikut dapat ditemukan di bilah menu:

menu "tlmgr"
Item di sini memuat berbagai repositori: default seperti yang ditentukan dalam TeX Live
database, repositori jaringan default, repositori yang ditentukan pada baris perintah
(jika ada), dan yang dimasukkan secara manual. Juga memiliki "berhenti" yang sangat diperlukan
operasi.

"Menu Opsi"
Menyediakan akses ke beberapa grup opsi: "Kertas" (konfigurasi kertas default
ukuran), "Platform" (hanya di Unix, konfigurasi yang didukung/diinstal
platform), "Bahasa GUI" (pilih bahasa yang digunakan dalam antarmuka GUI), dan "Umum"
(yang lainnya).

Beberapa sakelar juga ada di sini. Yang pertama adalah "Opsi ahli", yang diatur oleh
bawaan. Jika Anda mematikan ini, lain kali Anda memulai GUI layar yang disederhanakan
akan ditampilkan bahwa hanya menampilkan fungsionalitas yang paling penting. Pengaturan ini adalah
disimpan dalam file konfigurasi "tlmgr"; lihat "FILE KONFIGURASI UNTUK TLMGR" untuk
rincian.

Matikan lainnya semuanya mati secara default: untuk men-debug output, untuk menonaktifkan
penginstalan otomatis paket baru, dan untuk menonaktifkan penghapusan otomatis dari
paket dihapus dari server. Bermain dengan pilihan apa yang ada atau tidak
diinstal dapat menyebabkan instalasi TeX Live yang tidak konsisten; misalnya, ketika sebuah paket adalah
berganti nama.

"Menu tindakan"
Menyediakan akses ke beberapa tindakan: perbarui database nama file (alias "ls-R",
"mktexlsr", "texhash"), bangun kembali semua format ("fmtutil-sys --all"), perbarui peta font
database ("updmap-sys"), pulihkan dari cadangan paket, dan penggunaan tautan simbolis
di direktori sistem (bukan di Windows).

Tindakan terakhir adalah menghapus seluruh instalasi TeX Live (juga tidak pada Windows).

"Menu bantuan"
Menyediakan akses ke manual TeX Live (juga di web di
<http://tug.org/texlive/doc.html>) dan kotak ``Tentang'' yang biasa.

DAPAT DIBACA MESIN KELUARAN

Dengan opsi "--machine-readable", "tlmgr" menulis ke stdout dalam orientasi saluran tetap
format yang dijelaskan di sini, dan pesan informasi yang biasa untuk konsumsi manusia adalah
ditulis ke stderr (biasanya ditulis ke stdout). Idenya adalah bahwa sebuah program dapat
dapatkan semua informasi yang dibutuhkan dengan membaca stdout.

Saat ini opsi ini hanya berlaku untuk tindakan pembaruan, penginstalan, dan "opsi".

Dapat dibaca oleh mesin "memperbarui" dan "Install" keluaran
Format keluarannya adalah sebagai berikut:

nama bidang "\t" nilai
...
"tajuk akhir"
pkgname status localrev serverrev ukuran runtime esttot
...
"akhir pembaruan"
keluaran lain dari tindakan pos, bukan dalam bentuk yang dapat dibaca mesin

Bagian header saat ini memiliki dua bidang: "location-url" (sumber repositori dari
pembaruan mana yang sedang diambil), dan "total-byte" (jumlah total byte yang akan
diunduh).

lokalrev dan serverrev bidang untuk setiap paket adalah nomor revisi di lokal
instalasi dan repositori server, masing-masing. NS ukuran bidang adalah jumlah byte
yang akan diunduh, yaitu ukuran file tar terkompresi untuk instalasi jaringan,
bukan ukuran yang dibongkar. Bidang runtime dan esttot hanya ada untuk yang diperbarui dan
paket instal otomatis, dan berisi waktu yang telah berlalu sejak awal
instalasi/pembaruan dan perkiraan total waktu.

Ujung baris dapat berupa LF atau CRLF tergantung pada platform saat ini.

"lokasi-url" tempat
tempat mungkin berupa url (termasuk "file:///foo/bar/..."), atau nama direktori
("/ foo/bar"). Ini adalah repositori paket dari mana informasi paket baru itu
ditarik.

"total-byte" menghitung
menghitung hanyalah angka desimal, jumlah dari ukuran semua paket yang
perlu memperbarui atau menginstal (yang tercantum kemudian).

Kemudian muncul baris dengan hanya string literal "end-of-header".

Setiap baris berikut hingga baris dengan string literal "akhir pembaruan" dilaporkan pada satu baris
kemasan. Bidang pada setiap baris dipisahkan oleh tab. Berikut adalah bidangnya.

nama pkg
Pengidentifikasi paket TeX Live, dengan kemungkinan akhiran platform untuk executable. Untuk
contoh, "pdftex" dan "pdftex.i386-linux" diberikan sebagai dua paket terpisah, satu di
setiap baris.

status
Status pembaruan paket. Satu karakter, sebagai berikut:

"d" Paket telah dihapus di server.

"f" Paket telah dihapus di instalasi lokal, meskipun koleksi
tergantung padanya. (Misalnya, pengguna menjalankan "tlmgr remove --force".)

"u" Pembaruan normal diperlukan.

"r" Terbalik non-update: versi yang diinstal secara lokal lebih baru dari versi
di server.

"a" Kebutuhan instalasi yang ditentukan secara otomatis, paket baru di
server dan (kemungkinan besar) merupakan bagian dari koleksi yang diinstal.

Paket "i" akan diinstal dan tidak ada di instalasi lokal (tindakan
Install).

Paket "I" sudah ada tetapi akan diinstal ulang (action install).

lokalrev
Nomor revisi paket yang diinstal, atau "-" jika tidak ada secara lokal.

serverrev
Nomor revisi paket di server, atau "-" jika tidak ada di
Server.

ukuran
Ukuran dalam byte paket di server. Jumlah semua ukuran paket adalah
diberikan di bidang header "total-byte" yang disebutkan di atas.

runtime
Waktu berjalan sejak dimulainya penginstalan atau pembaruan.

esttot
Perkiraan total waktu.

Dapat dibaca oleh mesin "pilihan" keluaran
Format keluarannya adalah sebagai berikut:

nilai kunci "\t"

Jika nilai tidak disimpan dalam database, string "(not set)" akan ditampilkan.

Jika Anda sedang mengembangkan program yang menggunakan output ini, dan menemukan bahwa perubahannya adalah
membantu, jangan ragu untuk menulis milis.

PENULIS DAN HAK CIPTA

Skrip ini dan dokumentasinya ditulis untuk distribusi TeX Live
(<http://tug.org/texlive>) dan keduanya dilisensikan di bawah Lisensi Publik Umum GNU
Versi 2 atau lebih baru.

Gunakan tlmgr online menggunakan layanan onworks.net