これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、または MAC OS オンライン エミュレーターなどの複数の無料オンライン ワークステーションの XNUMX つを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド tlmgr です。
プログラム：
NAME
tlmgr - TeX Live マネージャー
SYNOPSIS
tlmgr [オプション] ... アクション [オプション] ... [オペランド] ...
DESCRIPTION
tlmgr 既存の TeX Live インストール (パッケージと構成オプションの両方) を管理します。
TeX Live の最初のダウンロードとインストールについては、次を参照してください。
<http://tug.org/texlive/acquire.html>.
このドキュメントの最新バージョン (開発から毎晩更新)
ソース）は、次の場所で入手できます。http://tug.org/texlive/tlmgr.html>の手順とともに、
「tlmgr」自体とテストバージョンの情報を更新します。
警告: Debian の tlmgr は常にユーザー モードで実行されます
TeX Live はいくつかのトップレベルに編成されています スキーム、それぞれは次のように指定されます。
の異なるセット コレクション と パッケージここで、コレクションはパッケージのセットであり、
パッケージには実際のファイルが含まれています。 通常、スキームにはコレクションとコレクションが混在しています。
ただし、各パッケージは XNUMX つのコレクションに含まれており、それ以上でもそれ以下でもありません。 あ
TeX Live インストールは、どのレベルでもカスタマイズおよび管理できます。
見るhttp://tug.org/texlive/doc> 利用可能なすべての TeX Live ドキュメントを参照してください。
例
TeX Live を正常にインストールしたら、「tlmgr」を使用した一般的な操作をいくつか示します。
「tlmgr オプション リポジトリ」 http://mirror.ctan.org/systems/texlive/tlnet"
今後の更新に近くの CTAN ミラーを使用するように「tlmgr」に指示します。 インストールしていれば便利
DVD イメージから TeX Live を入手し、継続的なアップデートを希望します。
「tlmgr update --list」
実際には何も更新せずに、何が更新されるかを報告します。
「tlmgr update --all」
ローカル TeX インストールをパッケージ リポジトリ内の内容に対応させる
(通常、CTAN から更新する場合に便利です)。
「tlmgr情報」 何
パッケージに関する詳細情報を表示する 何インストール状況や
説明、検索の 何 すべてのパッケージに含まれています。
「tlmgr」のすべての機能と詳細については、次の膨大な資料をお読みください。
情報を表示します。
OPTIONS
「tlmgr」の次のオプションはグローバル オプションであり、アクションに固有のものではありません。 全て
オプションは、グローバルかアクション固有かに関係なく、コマンドラインのどこにでも指定できます。
任意の順序で。 最初の非オプション引数がメインのアクションになります。 すべての場合において、
「-」オプション と "-"オプション は同等であり、オプション名とオプションの間の「=」はオプションです。
その価値。
-リポジトリ URL|パス
パッケージのインストールまたは更新元となるパッケージ リポジトリを指定します。
インストールの TeX Live パッケージにあるデフォルトのパッケージ リポジトリをオーバーライドする
データベース (別名 TLPDB、ファイル「tlpkg/texlive.tlpdb」で完全に定義)。 の
「install-tl」のドキュメントにこれに関する詳細が記載されています
(<http://tug.org/texlive/doc/install-tl.html>）。
「--repository」は、現在の実行に対してのみリポジトリの場所を変更します。 作ります
永続的な変更の場合は、「オプション リポジトリ」を使用します (「オプション」アクションを参照)。
下位互換性と便宜のため、「--location」と「--repo」は次のように受け入れられます。
このオプションのエイリアス。
--gui [アクション]
「tlmgr」にはコマンドラインインターフェースのほかにグラフィカルインターフェースもあります。 与えることができます
このオプション「--gui」は、
GUI の各画面。 たとえば、ランニング
tlmgr --gui 更新
アップデート画面から直接起動します。 アクションが指定されていない場合、GUI は次のようになります。
メイン画面から起動しました。
--gui-lang llコード
デフォルトでは、GUI は環境 (Windows では
レジストリ、Unix では「LC_MESSAGES」経由)。 それが失敗した場合は、別の方法を選択できます
このオプションに言語コード (ISO 639-1 に基づく) を指定することにより、言語を設定します。 現在
サポートされている (ただし完全に翻訳されている必要はない) は次のとおりです: 英語 (en、デフォルト)、
チェコ語 (cs)、ドイツ語 (de)、フランス語 (fr)、イタリア語 (it)、日本語 (ja)、オランダ語 (nl)、ポーランド語
(pl)、ブラジル系ポルトガル語 (pt_BR)、ロシア語 (ru)、スロバキア語 (sk)、スロベニア語 (sl)、セルビア語
(sr)、ウクライナ語 (uk)、ベトナム語 (vi)、簡体字中国語 (zh_CN)、および繁体字中国語
中国語 (zh_TW)。
--デバッグ-翻訳
GUI モードでは、このスイッチは「tlmgr」に未翻訳 (または欠落) を報告するように指示します。
メッセージを標準エラーに送信します。 これは、翻訳者がやるべきことが残っていることを確認するのに役立ちます。
-機械可読
人間による消費を目的とした通常の出力の代わりに、(標準に) を書き込みます。
出力) 機械解析により適した固定形式。 「機械読み取り可能」を参照してください。
以下の「出力」セクションを参照してください。
--no-execute-actions
tlpsrc ファイルで定義されている実行アクションの実行を抑制します。
これはデバッグでのみ役立つため、完全を期すためにのみ文書化されています。
-- パッケージログファイル file
「tlmgr」は、すべてのパッケージアクション (インストール、削除、更新、失敗した更新、失敗した) をログに記録します。
復元) を別のログ ファイル (デフォルトでは「TEXMFSYSVAR/web2c/tlmgr.log」) に保存します。 これ
オプションを使用すると、ログに別のファイルを指定できます。
- 一時停止
このオプションにより、「tlmgr」は終了する前にユーザー入力を待機します。 Windows で便利な機能
コマンド ウィンドウが消えないようにします。
--persistent-downloads
--no-persistent-downloads
ネットワークベースのインストールの場合、このオプション (デフォルトでオン) により、「tlmgr」が設定を試行します。
永続的な接続を確立します (「LWP」Perl モジュールを使用)。 アイデアは、開いて、
コンピュータとサーバー間のセッションごとに XNUMX つの接続のみを再利用します。
各パッケージの新しいダウンロードを開始します。
これが不可能な場合、「tlmgr」は「wget」の使用に戻ります。 これらを無効にするには
永続的な接続の場合は、「--no-persistent-downloads」を使用します。
--ピンファイル
ピン留めファイルの場所を「TEXMFLOCAL/tlpkg/pinning.txt」から変更します (「ピン留め」を参照)
下）。 これはデバッグでのみ役立つため、完全を期すためにのみ文書化されています。
-- ユーザーモード
この「tlmgr」の実行に対してユーザー モードをアクティブにします。 以下の「ユーザーモード」を参照してください。
--usertree DIR
あなたが使用します DIR ユーザーモードのツリーの場合。 以下の「ユーザーモード」を参照してください。
TeX Live プログラムの標準オプション「--help/-h/-?」、「--version」、
「-q」 (情報メッセージなし)、「-v」 (デバッグ メッセージ、繰り返し可能)。 のために
これらの詳細については、「TeXLive::TLUtils」ドキュメントを参照してください。
「--version」オプションは、TeX Live リリースと
「tlmgr」スクリプト自体。 "-v" も指定した場合、ロードされた TeX Live のリビジョン番号
Perl モジュールも表示されます。
ACTIONS
助けます
このヘルプ情報を表示して終了します (「--help」と同じで、Web では次の場所にあります)。
<http://tug.org/texlive/doc/tlmgr.html>)。 場合によっては、「perldoc」および/または「PAGER」プログラム
システム上に問題があるため、制御文字が文字通り出力されます。 これ
常に検出できるわけではありませんが、「NOPERLDOC」環境変数を設定して、
「perldoc」は使用されません。
バージョン
バージョン情報を提供します (「--version」と同じ)。
「-v」が指定されている場合は、使用されているモジュールのリビジョンも報告されます。
バックアップ [--クリーン[=N]] [--バックアップディレクトリ DIR] [ - 全て | pkg] ...
「--clean」オプションが指定されていない場合、このアクションは指定されたファイルのバックアップを作成します。
パッケージ、または「--all」を指定したすべてのパッケージ。 これらのバックアップは、
「--backupdir」オプション (それが既存の書き込み可能なディレクトリの場合)。 「--backupdir」が
指定されていない場合は、TLPDB 内の「backupdir」オプション設定が使用されます (存在する場合)。 両方ある場合
欠落しているため、バックアップは作成されません。
「--clean」オプションが指定されている場合、バックアップは保存されずにプルーニング (削除) されます。 の
オプションの整数値 N バックアップの数を設定するために指定できます。
クリーニング時に保持されます。 「N」が指定されていない場合は、「autobackup」オプションの値が使用されます。
両方が欠落している場合は、エラーが発行されます。 バックアップ プルーニングの詳細については、を参照してください。
「オプション」アクション。
オプション：
--backupdir ディレクトリにジョブを開始します。
TLPDB の「backupdir」オプション設定をオーバーライドします。 の ディレクトリにジョブを開始します。 引数は
必須であり、バックアップを作成する既存の書き込み可能なディレクトリを指定する必要があります
置いた。
- すべて
「--clean」が指定されていない場合は、TeX Live 内のすべてのパッケージのバックアップを作成します。
インストール; これにはかなりのスペースと時間がかかります。 「--clean」の場合
指定すると、すべてのパッケージが削除されます。
- 掃除[=N]
説明したように、バックアップを作成する代わりに、古いバックアップのバックアップ ディレクトリを削除します。
その上。 オプションの整数引数 N で設定された「自動バックアップ」オプションをオーバーライドします。
TLPDB。 次のように、「--all」またはパッケージのリストをこのオプションと一緒に使用する必要があります。
欲しい。
-ドライラン
実際には何もバックアップまたは削除されません。 代わりに、実行されるアクションは次のとおりです。
端末に書き込まれます。
候補 pkg
候補 pkg
パッケージに利用可能な候補リポジトリを表示します pkg。 「複数」を参照してください。
「リポジトリ」を参照してください。
チェック [オプション] ... [ファイル|依存|実行|実行ファイル|すべて]
インストールの一貫性に関して XNUMX つ (またはすべて) のチェックを実行します。
ファイル
ローカル TLPDB (「texlive.tlpdb」) にリストされているすべてのファイルが実際に
存在し、欠落しているものをリストします。
依存
インストールされたコレクション内で依存関係として発生するが、
それ自体はインストールされておらず、どのコレクションにも含まれていないパッケージです。
「tlmgr check collections」を呼び出すと、代わりにこのテストが実行されます。
「tlmgr」の以前のバージョンではそのように呼ばれていました。
実行
TeX Live データベース内の「execute」ディレクティブによって参照されるファイルが
プレゼント。
実行ファイル
実行ファイル内で複数回出現するファイル名をリストします。
オプション：
--use-svn
ファイルをリストする代わりに、「svn status」の出力を使用します。 TLチェック用
開発リポジトリ。
confに [texmf|tlmgr|updmap [--conffile file] [ - 消去] [キー [値]]]
"conf" のみを指定すると、TeX Live の一般的な設定情報が表示されます。
構成ファイル、パス設定など。 これは「texconfig conf」呼び出しに似ていますが、
サポートされているすべてのプラットフォームで動作します。
「conf texmf」、「conf tlmgr」、または「conf updmap」のいずれかを追加すると、すべてが表示されます
tlmgr 設定「ROOT/texmf.cnf」に保存されたキーと値のペア (つまり、すべての設定)
ファイル (以下を参照)、または最初に見つかった (kpsethat 経由) "updmap.cfg" ファイルをそれぞれ指定します。
If キー が追加で与えられ、その値のみを示します キー それぞれのファイルにあります。 もしも
オプション - 消去 設定ファイルも指定されています -- コメントされただけでなく削除されます
でる！
If 値 さらに与えられる、 キー に設定されています 値 それぞれのファイルにあります。 いいえ エラー
点検 is やりました！
すべての場合において、使用されるファイルはオプション「--conffile」を使用して明示的に指定できます。 ファイル",
別のファイルを操作したい場合に備えて。
実際のアプリケーション: 「\write18」経由で (一部またはすべての) システム コマンドを実行する場合
インストール中に有効のままになっていましたが、後で無効にすることができます。
tlmgr conf texmf シェル_エスケープ 0
より複雑な例: 「TEXMFHOME」ツリー (メインの TeX Live ガイドを参照)
<http://tug.org/texlive/doc.html>) 複数のディレクトリに設定できますが、それらは必ず
中括弧で囲まれ、カンマで区切られているため、値をシェルに引用符で囲むのが適切です。
アイディア。 したがって：
tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}"
警告: 一般的な機能はここにありますが、このように設定をいじるのは非常に困難です。
強く落胆します。 繰り返しますが、キーまたは値のエラー チェックは行われないため、
一種の破損の可能性があります。
ダンプ-tlpdb [--ローカル|--リモート]
完全なローカルまたはリモート TLPDB をそのまま標準出力にダンプします。 出力は次のようになります
「--機械可読」出力。 「機械可読出力」セクションを参照してください。
オプション：
- ローカル
ローカルの tlpdb をダンプします。
-リモート
リモート tlpdb をダンプします。
「--local」と「--remote」のいずれかを指定する必要があります。
どちらの場合も、出力の最初の行はリポジトリの場所を指定します。
フォーマット：
"location-url" "\t" 場所
ここで、「location-url」はリテラルのフィールド名で、その後にタブが続きます。 場所 は
リポジトリへのファイルまたは URL。
現在のプラットフォームに応じて、行末は LF または CRLF のいずれかになります。
生成する [オプション] ... 何
生成する 言語
生成する 言語.dat
生成する 言語.定義
生成する 言語.dat.lua
「生成」アクションは、それぞれのファイルに加えられた手動の変更を上書きします。
インストールされているパッケージの情報とローカルのパッケージに基づいて、それらを最初から再作成します。
適応。 TeX Live インストーラーと "tlmgr" は、これらすべてに対して定期的に "generate" を呼び出します。
ファイル。
独自のフォントを管理するには、「updmap --help」情報をお読みください。
<http://tug.org/fonts/fontinstall.html>.
独自の形式の管理については、「fmtutil --help」の情報をお読みください。
詳細: 「generate」は、設定ファイル「 language.dat 」のいずれかを再作成します。
ローカル TLPDB に存在する情報からの「 language.def 」および「 language.dat.lua 」、
さらにローカルで管理されているファイルも含まれます。
ローカルで管理されるファイルは、「 language-local.dat 」、「 language-local.def 」、または
「 language-local.dat.lua 」。それぞれのディレクトリの「TEXMFLOCAL」で検索されます。 もしも
ローカルの追加が存在し、最終ファイルはメイン ファイルから開始して作成されます。
ローカル ファイルで無効に指定されているエントリをすべて省略し、最後に追加します。
ローカルファイル。
(履歴メモ: 以前にサポートされていた「updmap-local.cfg」と「fmtutil-local.cnf」はサポートされていません。
「updmap」と「fmtutil」が複数の構成を読み取ってサポートするようになったため、読む時間が長くなります。
ファイル。 したがって、ローカルの追加は「fmtutil.cnf」の「updmap.cfg」に入れることができますし、入れる必要があります。
「TEXMFLOCAL」内のファイル。 「updmap の生成」および「fmtutil の生成」アクションは廃止されました。
存在。）
ローカル ファイルでは、無効にするエントリをコメント行で指定します。つまり、次のいずれかです。
％！名前
- ！名前
ここで、「 language.dat 」と「 language.def 」は「%」を使用し、「 language.dat.lua 」は「--」を使用します。 全部で
ケース、 名 は、それぞれの形式名またはハイフネーション パターン識別子です。
例：
％！ドイツ人
--!usenglishmax
(もちろん、これらの特定の項目を実際に無効にする必要はありません。
単なる例です。)
このような無効化行の後に、ローカル ファイルに同じ項目の別のエントリを含めることができます。
別の定義が必要な場合。 一般に、特別な無効化行を除いて、
ローカル ファイルはマスター ファイルと同じ構文に従います。
「言語を生成」というフォームは、「 language.dat 」、「 language.def 」、および「 language.def 」の XNUMX つのファイルすべてを再作成します。
「 language.dat.lua 」。拡張子を持つフォームは指定された言語のみを再作成します。
ファイルにソフトウェアを指定する必要があります。
オプション：
-宛先 出力ファイル
出力ファイルを指定します (デフォルトは「TEXMFSYSVAR」内のそれぞれの場所です)。 もしも
「--dest」は「言語の生成」に指定され、「.dat」のベース名として機能します。
「 language.dat 」出力ファイルの名前には「.def」が追加されます。
「 language.def 」出力ファイルの名前の値と「.dat.lua」が追加されます。
「 language.dat.lua 」ファイルの名前に変更します。 (これは上書きを避けるためだけです。
各出力ファイルに特定の名前が必要な場合は、「tlmgr」を XNUMX 回呼び出すことをお勧めします。)
--localcfg local_conf_file
(オプションの) ローカル追加を指定します (デフォルトは、
「TEXMFLOCAL」）。
--rebuild-sys
構成ファイルが再生成された後に必要なプログラムを実行するように tlmgr に指示します。 これらは
: 「fmtutil-sys --all」、「generate fmtutil」の後、「fmtutil-sys --byhyphen」
「generate language.dat」の後に「.../ language.dat」、および「fmtutil-sys --byhyphen」
「generate language.def」の後に .../ language.def」を実行します。
これらの後続の呼び出しにより、新しく生成されたファイルが実際に有効になります。 これ
これらの呼び出しは長いプロセスであり、実行したくなる場合があるため、デフォルトでは実行されません。
これらのプログラムを呼び出す前に、関連するいくつかの変更を連続して加えました。
それぞれの場所は以下の通りです。
tex/generic/config/ language.dat (および language-local.dat);
tex/generic/config/ language.def (および language-local.def);
tex/generic/config/ language.dat.lua (および language-local.dat.lua);
GUI
グラフィカル ユーザー インターフェイスを起動します。 見る GUI を参照してください。
info [オプション...] [コレクション|スキーム|pkg...]
引数を指定しないと、パッケージ リポジトリで利用可能なすべてのパッケージをリストします。
すでに「i」でインストールされています。
単一の単語「コレクション」または「スキーム」を引数として使用して、リクエストのタイプをリストします。
すべてのパッケージの代わりに。
他の引数を指定すると、次の情報が表示されます。 pkg: 名前、カテゴリ、短いもの、
詳細な説明、インストール状況、TeX Live リビジョン番号。 もしも pkg ではありません
ローカルにインストールされている場合は、リモート インストール ソースを検索します。
If pkg ローカルまたはリモートで見つからない場合は、検索アクションが使用され、一致するものがリストされます。
パッケージとファイル。
また、TeX カタログから取得した情報、つまりパッケージのバージョンも表示されます。
日付とライセンス。 これら、特にパッケージのバージョンは近似値として考慮してください。
単に、さまざまな部分の更新のタイミングのずれによるものです。 対照的に、
「リビジョン」値は TL から直接取得され、信頼性があります。
以前のアクション「show」と「list」はこのアクションにマージされていますが、引き続きサポートされています。
下位互換性のため。
オプション：
- リスト
オプション「--list」がパッケージで指定されている場合、含まれるファイルのリストも
プラットフォーム固有の依存関係も含めて表示されます。 スキームを指定した場合
およびコレクションの場合、「--list」は同様の方法で依存関係を出力します。
--only-インストール済み
このオプションを指定すると、インストール ソースは使用されません。 ローカルのみ
インストールされているパッケージ、コレクション、またはスキームがリストされます。 (リストには機能しません)
今のところパッケージ）
初期化ユーザーツリー
いわゆるユーザー モード管理用の texmf ツリー (デフォルトのユーザー ツリー) をセットアップします。
(「TEXMFHOME」)、またはコマンドラインで「--usertree」で指定されたもの。 「ユーザーモード」を参照してください。
を参照してください。
install [オプション] ... pkg...
それぞれをインストールします pkg まだインストールされていない場合は、コマンドラインで指定します。 (そうではありません
既存のパッケージに触れる。 最新バージョンを入手する方法については、「更新」アクションを参照してください。
パッケージ。）
デフォルトでは、これにより、指定されたパッケージが含まれるすべてのパッケージもインストールされます。 pkgは依存しています。
オプション：
-ドライラン
実際には何もインストールされていません。 代わりに、実行されるアクションは
ターミナル。
- ファイル
インストール リポジトリからパッケージを取得する代わりに、パッケージ ファイルを使用します。
コマンドラインで与えられます。 これらのファイルは、標準の TeX Live パッケージ ファイル (
tlpobj ファイルが含まれています)。
- 力
「tlmgr」自体 (または基本インフラストラクチャの他の部分) に対する更新が存在する場合、
このオプションが指定されていない限り、「tlmgr」は救済され、インストールは実行されません。
推奨しません。
--いいえ、依存します
依存関係をインストールしないでください。 (デフォルトでは、パッケージをインストールすると、すべての
このパッケージの依存関係は満たされています。)
--まったく依存しない
通常、バイナリ ファイルを同梱するパッケージをインストールすると、それぞれのバイナリ
パッケージもインストールされます。 つまり、パッケージ「foo」の場合、パッケージは
「foo.i386-linux」は「i386-linux」システムにもインストールされます。 このオプション
この動作を抑制し、「--no-depends」を暗黙的に指定します。 そうでない場合は使用しないでください
あなたがやっていることは確かです。
-再インストール
すでにそう思われている場合でも、パッケージ (コレクションの依存関係を含む) を再インストールします。
インストールされます (つまり、TLPDB に存在します)。 これは回復に役立ちます
階層内のファイルを誤って削除した場合。
再インストールする場合、通常のパッケージへの依存関係のみが追跡されます (つまり、パッケージの依存関係は追跡されません)。
カテゴリ「スキームまたはコレクション」の)。
--with-doc
--with-src
推奨されませんが、「install-tl」プログラムには省略するオプションが用意されています。
すべてのドキュメントやソース ファイルのインストール。 (デフォルトでは、すべてが
) このようなインストールの後、ドキュメントが必要になる場合があります。
結局のところ、特定のパッケージのソースファイルです。 これらを使用すると入手できます
(「fontspec」パッケージを
例）：
tlmgr install --reinstall --with-doc --with-src fontspec
オプション
オプション [見せる]
オプション すべて表示する
オプション キー [値]
最初の形式は、TLPDB に現在保存されているグローバル TeX Live 設定を表示します。
短い説明とそれを変更するために使用される「キー」を括弧内に示します。
XNUMX 番目の形式は似ていますが、定義できるが定義できないオプションも示します。
現在は任意の値に設定されています。
XNUMX 番目の形式では、 値 が指定されていない場合、 キー 表示されています。 場合 値 is
現在、 キー に設定されています 値.
可能な値 キー (最終的なリストについては「tlmgr option showall」を実行します):
リポジトリ (デフォルトのパッケージ リポジトリ)、
フォーマット (インストール時にフォーマットを作成)、
postcode (postinst コード BLOB を実行)
docfiles (インストールドキュメントファイル)、
srcfiles (インストールソースファイル)、
backupdir (バックアップ用のデフォルトのディレクトリ)、
自動バックアップ (保持するバックアップの数)。
sys_bin (パスアクションによって実行可能ファイルがリンクされるディレクトリ)
sys_man (パスアクションによってマニュアルページがリンクされるディレクトリ)
sys_info (パスアクションによって Info ファイルがリンクされるディレクトリ)
Desktop_integration (Windows のみ: [スタート] メニューのショートカットを作成)
fileassocs (Windows のみ: ファイルの関連付けを変更)
マルチユーザー (Windows のみ: すべてのユーザーにインストール)
「オプション」の一般的な使用法の XNUMX つは、インストールを永続的に変更してさらに効果を高めることです。
最初に DVD からインストールした後、インターネットからアップデートします。 これを行うには、次のように実行できます
tlmgr オプション リポジトリ http://mirror.ctan.org/systems/texlive/tlnet
「install-tl」ドキュメントには、可能な値に関する詳細情報が記載されています。
「リポジトリ」。 (下位互換性のため、「location」は代替名として使用できます)
「リポジトリ」。)
「formats」が設定されている場合 (これがデフォルトです)、次のいずれかのときにフォーマットが再生成されます。
エンジンまたはフォーマット ファイルが変更されました。 自分が何者であるかを理解している場合にのみこれを無効にします
やって。
「postcode」オプションは、パッケージごとのインストール後のアクション コードの実行を制御します。 それ
はデフォルトで設定されており、おそらく次の場合を除いて、無効にすることはあまり重要ではありません。
開発者。
「docfiles」および「srcfiles」オプションは、それぞれのファイルのインストールを制御します。
パッケージの。 デフォルトでは両方が有効になっています (1)。 ディスクの場合、これを無効にすることができます (0 に設定)。
スペースは（非常に）限られています。
オプション「autobackup」および「backupdir」は、アクション「update」のデフォルトを決定します。
"バックアップと復元"。 これら XNUMX つのアクションには、読み取りまたは書き込みを行うディレクトリが必要です。
バックアップ。 コマンドラインで「--backupdir」が指定されていない場合、「backupdir」
オプション値が使用されます (設定されている場合)。
「自動バックアップ」オプションは、バックアップの自動生成を（非）アクティブにします。 その値は、
整数。 「autobackup」の値が「-1」の場合、バックアップは削除されません。 「自動バックアップ」が0の場合
以上の場合は、保持するバックアップの数を指定します。 したがって、次の場合、バックアップは無効になります。
値は 0 です。「バックアップ」アクションの「--clean」モードでは、このオプションは、
保持する番号。
コマンドラインで「自動バックアップ」を「-1」に設定するには、次のコマンドを使用します。
tlmgr オプション -- 自動バックアップ -1
「--」は、「-1」がオプションとして扱われるのを避けます。 (「--」は次の時点でオプションの解析を停止します
それが現れる地点。 これは、ほとんどの Unix プログラムに共通の機能です)。
「sys_bin」、「sys_man」、「sys_info」オプションは、Unix 系システムで制御のために使用されます。
実行可能ファイル、情報ファイル、マニュアルページへのリンクの生成。 「パス」アクションを参照してください。
詳細については。
最後の XNUMX つのオプションは、Windows インストールでの動作を制御します。 もしも
「desktop_integration」が設定されている場合、一部のパッケージはアイテムをそのサブフォルダーにインストールします。
「tlmgr gui」のスタートメニュー、ドキュメントなど。「fileassocs」が設定されている場合は、Windows ファイル
関連付けが行われます (「ポストアクション」アクションも参照)。 最後に、「マルチユーザー」が設定されている場合、
その後、レジストリとメニューへの適応がシステム上のすべてのユーザーに対して行われます。
現在のユーザーのみ。 XNUMX つのオプションはすべてデフォルトでオンになっています。
紙
紙 [a4|文字]
[xdvi|pdftex|dvips|dvipdfmx|context|psutils] 紙 [ペーパーサイズ|--リスト]
引数なし (「tlmgr Paper」) は、既知のすべての用紙サイズのデフォルト設定を表示します。
プログラム。
4 つの引数 (例: "tlmgr Paper aXNUMX") を使用すると、すべての既知のプログラムのデフォルトを次のように設定します。
その紙のサイズ。
最初の引数としてプログラムが指定され、用紙サイズが指定されていない場合 (例: "tlmgr dvips
Paper") は、そのプログラムのデフォルトの用紙サイズを示します。
最初の引数としてプログラムを指定し、最後の引数として用紙サイズを指定します (例:
"tlmgr dvips Paper a4")、そのプログラムのデフォルトをその用紙サイズに設定します。
最初の引数としてプログラムを指定し、最後の引数として「--list」を指定します (例:
"tlmgr dvips Paper --list")、そのプログラムで有効なすべての用紙サイズが表示されます。 最初のサイズ
示されているのはデフォルトです。
ちなみに、「paper」キーワードの前に特定のプログラム名を置くこの構文は、
普通でない。 これは、他のサポートをサポートする長年の「texconfig」スクリプトから継承されています。
一部のプログラム、特に「dvips」の構成設定。 「tlmgr」はそれらをサポートしていません
追加の設定。
path [--w32mode=ユーザー|管理者] [追加|削除]
Unix では、単にバイナリ、マニュアル ページ、情報ページのシンボリック リンクを追加または削除するだけです。
それぞれのオプションで指定されたシステム ディレクトリ (「オプション」の説明を参照)
その上）。 システムまたは個人の初期化ファイルは変更されません。
Windows では、バイナリ ディレクトリが追加または削除されるレジストリ部分が決定されます。
次のようにします。
ユーザーが管理者権限を持っており、オプション「--w32mode」が指定されていない場合、設定は
w32_multi_user 場所を決定します（つまり、システムパス上にある場合はシステムパス、そうでない場合）
ユーザーパスが変更されます)。
ユーザーが管理者権限を持っており、オプション「--w32mode」が指定されている場合、このオプションは
調整するパス。
ユーザーに管理者権限がなく、オプション「--w32mode」が指定されていない場合、
設定 w32_multi_user オフの場合はユーザー パスが変更されますが、設定がオフの場合は
w32_multi_user がオンの場合、呼び出し元に十分な権限がないという警告が発行されます。
ユーザーが管理者権限を持たず、オプション「--w32mode」が指定されている場合は、次のようにする必要があります。
user ユーザーパスが調整されます。 管理者権限のないユーザーがこのオプションを使用した場合
「--w32mode admin」では、呼び出し元に十分な権限がないという警告が発行されます。
固定
「固定」アクションは固定ファイルを管理します。以下の「固定」を参照してください。
「ピンニングショー」
現在のピン留めデータを表示します。
「ピン留め追加」 レポ pkgglob...
に一致するパッケージをピン留めします pkgglob(s) リポジトリへ レポ.
「ピン留め解除」 レポ pkgglob...
ピン留めファイルに記録されているパッケージは、 与えられたもののために
倉庫 レポ 削除されます。
「固定削除」 レポ - 全て"
リポジトリのすべての固定データを削除します レポ.
プラットフォーム リスト|追加|削除 プラットフォーム...
プラットフォーム セッションに プラットフォーム
プラットフォーム セッションに オート
「プラットフォーム リスト」には、すべてのプラットフォーム (別名アーキテクチャ) の TeX Live 名がリストされます。
(「i386-linux」、...) パッケージ リポジトリで入手できます。
「プラットフォームの追加」 プラットフォーム... 指定されたプラットフォームごとに実行可能ファイルを追加します プラットフォーム から
リポジトリからのインストール。
「プラットフォームの削除」 プラットフォーム... 指定されたプラットフォームごとに実行可能ファイルを削除します プラットフォーム
インストール時から削除されますが、いかなる場合でも、現在実行中のプラットフォームは維持されます。
「プラットフォームセット」 プラットフォーム TeX Live を自動ではなく常に指定されたプラットフォームを使用するように切り替えます
検出。
「platform set auto」は TeX Live をプラットフォームの自動検出モードに切り替えます。
プラットフォーム検出は、適切な「xz」、「xzdec」、「wget」バイナリを選択するために必要です。
TeX Live に同梱されています。
「アーチ」は「プラットフォーム」と同義です。
オプション：
-ドライラン
実際には何もインストールされていません。 代わりに、実行されるアクションは
ターミナル。
事後処理 [--w32mode=ユーザー|管理者] [--fileassocmode=1|2] [ - 全て] [インストール|削除]
[ショートカット|ファイル関連付け|スクリプト] [pkg] ...
XNUMX 番目に必要なポストアクション「shortcut」、「fileassoc」、または「script」を実行します。
インストールまたは削除モードの引数 (最初に必要な引数)。
コマンドラインで指定されたパッケージ、または「--all」が指定された場合はすべてのパッケージ。
オプション「--w32mode」に値「user」が指定されている場合、すべてのアクションはのみ実行されます。
レジストリ/ファイルシステムのユーザーがアクセスできる部分で、値「admin」が選択するもの
ファイル関連付けのためのレジストリのシステム全体の部分。 お持ちでない場合は
十分な権限がない場合、「--w32mode=admin」を使用すると成功しません。
「--fileassocmode」は、ファイルの関連付けのアクションを指定します。 1 に設定すると (
デフォルト)、新しい関連付けのみが追加されます。 2 に設定すると、すべての関連付けが に設定されます。
TeX Live プログラム。 (「オプション fileassocs」も参照してください。)
印刷プラットフォーム
検出されたプラットフォーム (ハードウェア/オペレーティング システム) の TeX Live 識別子を出力します。
標準出力に結合して終了します。 「--print-arch」は同義語です。
削除します [オプション] ... pkg...
それぞれを削除します pkg 指定。 コレクションを削除すると、すべてのパッケージの依存関係が削除されます (ただし、
"--no-depends" が指定されています)、そのコレクションのコレクション依存関係は指定されていません。
ただし、パッケージを削除しても、依存関係は削除されません。 オプション:
--いいえ、依存します
依存パッケージは削除しないでください。
--まったく依存しない
上記を参照 install （そして注意してください）。
- 力
デフォルトでは、別のパッケージまたはコレクションの依存関係であるパッケージまたはコレクションを削除します。
コレクションやスキームは許可されません。 このオプションを使用すると、パッケージが削除されます
無条件に。 慎重に使用してください。
「--force」オプションを使用して削除されたパッケージがまだリストに表示されている
インストールされたコレクションまたはスキーム内の は更新されず、次のように記載されます。
強制的に 削除 の出力で tlmgr update - リスト.
-ドライラン
実際には何も削除されません。 代わりに、実行されるアクションは
ターミナル。
倉庫
倉庫 リスト
倉庫 リスト パス|タグ
倉庫 加えます path [タグ]
倉庫 削除します パス|タグ
倉庫 セッションに path[#タグ] [path[#タグ] ...]
このアクションは、リポジトリのリストを管理します。 詳細については、以下の「複数のリポジトリ」を参照してください。
詳しい説明。
最初の形式 (「リスト」) には、構成されているすべてのリポジトリとそれぞれのタグがリストされます。
設定。 「list」キーワードの後にパス、URL、またはタグが指定された場合、次のように解釈されます。
TeX Live データベースを初期化するソースと、含まれるパッケージのリストを取得します。
これは、ローカルとリモートの両方で、現時点では使用されていないリポジトリにすることもできます。 XNUMX つあれば
さらに「-with-platforms」を渡します。パッケージごとに、利用可能なプラットフォーム (存在する場合)
も記載されています。
XNUMX 番目の形式 (「追加」) は、リポジトリを (オプションでタグを付けて) リストに追加します。
リポジトリ。 XNUMX 番目の形式 (「削除」) は、リポジトリを完全に削除します。
パス/URL、またはタグによって。 最後のフォーム (「set」) は、リポジトリのリストをアイテムに設定します。
コマンドラインで指定され、以前の設定は保持されません
いずれの場合も、リポジトリの XNUMX つが「メイン」としてタグ付けされている必要があります。 それ以外の場合はすべて
操作は失敗します!
リストア [--バックアップディレクトリ DIR] [ - 全て | pkg [回転]]
以前に作成したバックアップからパッケージを復元します。
「--all」が指定されている場合は、次の場所にあるすべてのパッケージ バックアップの最新リビジョンの復元を試みます。
バックアップディレクトリ。
それ以外の場合、どちらでもない場合 pkg また 回転 指定されている場合は、すべての利用可能なバックアップ リビジョンをリストします。
パッケージ。 と pkg 与えられたが与えられなかった 回転、利用可能なバックアップ リビジョンをすべてリストします。 pkg.
利用可能なパッケージをリストする場合、tlmgr はリビジョンを表示し、括弧内に作成を表示します。
利用可能な場合は時刻 (yyyy-mm-dd hh:mm 形式)。
両方の場合 (そしてその場合に限り) pkg および有効なリビジョン番号 回転 が指定されている場合は、復元を試みてください
指定されたバックアップからのパッケージ。
オプション：
- すべて
バックアップ内で見つかったすべてのパッケージ バックアップの最新リビジョンの復元を試行します。
ディレクトリ。 追加の非オプション引数 (例: pkg）は許可されません。
--backupdir ディレクトリにジョブを開始します。
バックアップを見つけるディレクトリを指定します。 与えなければ取られます
TLPDB の構成設定から。
-ドライラン
実際には何も復元されません。 代わりに、実行されるアクションは
ターミナル。
- 力
質問しないでください。
サーチ [オプション...] 何
サーチ [オプション...] - ファイル 何
サーチ [オプション...] - すべて 何
デフォルトでは、すべての名前、短い説明、および長い説明をローカルで検索します。
引数に対してインストールされたパッケージ 何、(Perl) 正規表現として解釈されます。
オプション：
- ファイル
を含むすべてのファイル名をリストします。 何.
- すべて
パッケージ名、説明、ファイル名など、すべてを検索します。
- グローバル
ローカルではなく、インストールメディアの TeX Live データベースを検索します。
インストール。
- 言葉
パッケージ名と説明 (ファイル名は除く) の検索を一致するように制限します。
完全な単語のみ。 たとえば、このオプションを使用して「table」を検索すると、出力されません。
「テーブル」という単語を含むパッケージ (パッケージに「テーブル」という単語も含まれている場合を除く)
独自のもの）。
アンインストール
TeX Live インストール全体をアンインストールします。 オプション:
- 力
確認を求めず、すぐに削除してください。
update [オプション] ... [pkg] ...
引数として指定されたパッケージを、次の場所で入手可能な最新バージョンに更新します。
インストール元。 「--all」または少なくとも XNUMX つのいずれか pkg 名前を指定する必要があります。 オプション:
- すべて
「tlmgr」自体を除く、インストールされているすべてのパッケージを更新します。 したがって、「tlmgr」に更新すると、
それ自体が存在する場合、オプション「--force」も指定しない限り、単純にエラーが発生します。
または「--self」が与えられます。 （下記参照。）
インストールされているパッケージの更新に加えて、コレクションの更新中に、
ローカル インストールは (デフォルトで) 上のコレクションのステータスと同期されます。
サーバーへの追加と削除の両方。
これは、パッケージがサーバー上で削除された（したがって、パッケージも削除された）場合を意味します。
それぞれのコレクションから削除されます)、「tlmgr」はローカルのパッケージを削除します
インストール。 これは「自動削除」と呼ばれ、使用時にそのようにアナウンスされます。
オプション「--list」。 この自動削除は、オプションを使用して抑制できます。
「--no-auto-remove」 (推奨されません。オプションの説明を参照してください)。
同様に、パッケージがサーバー上のコレクションに追加された場合、それも
ローカルにインストールされている場合は、ローカル インストールに追加されます。 これはと呼ばれます
「auto-install」であり、オプション「--list」を使用するとそのようにアナウンスされます。 この自動
オプション「--no-auto-install」を使用してインストールを抑制できます。
コレクションの依存関係チェックの例外 (自動インストールを含む)
先ほど述べたパッケージ）は、あなたによって「強制的に削除」されたものです。
つまり、それらに対して「tlmgr delete --force」を呼び出したということです。 (「削除」アクションを参照
このような強制的に削除されたパッケージを再インストールするには、次を使用します。
「--再インストール-強制削除」。
現在の更新実行から一部のパッケージを除外したい場合 (例: 処理速度が遅いため)
リンク)、以下の「--exclude」オプションを参照してください。
- 自己
「tlmgr」自体 (インフラストラクチャ パッケージ) が更新されている場合は更新します。
現在。 Windows では、これには出荷されたプライベート Perl インタープリターの更新が含まれます。
TeX Live内。
このオプションが「--all」またはパッケージのリストとともに指定された場合、
最初に「tlmgr」が更新され、この更新が成功すると新しいバージョンになります。
残りのアップデートを完了するために再起動しました。
要するに：
tlmgr update --self # インフラストラクチャのみを更新します
tlmgr update --self --all # インフラストラクチャとすべてのパッケージを更新します
tlmgr update --force --all # すべてのパッケージを更新しますが、インフラストラクチャは更新しません
# ... 最後は自己責任で、お勧めしません。
-ドライラン
実際には何もインストールされていません。 代わりに、実行されるアクションは
ターミナル。 これは「--list」よりも詳細なレポートです。
- リスト [pkg]
更新、新規インストール、または削除されるパッケージを簡潔にリストします。
実際には何も変更せずに。 「--all」も指定すると、利用可能なすべてのアップデートが表示されます
が列挙されています。 「--self」が指定されているが、「--all」が指定されていない場合は、重要なもののみが更新されます。
パッケージ (tlmgr、texlive インフラストラクチャ、Windows 上の perl など) がリストされます。 もしも
「--all」も「--self」も指定されておらず、さらに pkg が与えられた場合、「--all」
であると想定されます (したがって、「tlmgr update --list」は「tlmgr update --list --all」と同じです)。
「--all」も「--self」も指定されていないが、特定のパッケージ名が指定されている場合、それらは
パッケージの更新がチェックされます。
-除外する pkg
除外する pkg 更新プロセスから。 このオプションを複数回指定すると、
議論が積み重なる。
引数 pkg 両方のパッケージを除外します pkg それ自体とそのすべての関連プラットフォーム-
特定のパッケージ pkg.ARCH。 例えば、
tlmgr update --all --exclude a2ping
「a2ping」、「a2ping.i386-linux」、またはその他の「a2ping」は更新されません。アーチ パッケージ。
このオプションが、そうでなければ自動実行の候補となるパッケージを指定する場合、
強制的に削除されたパッケージ「tlmgr」のインストール、自動削除、または再インストール
エラーメッセージが出て終了します。 このような状況では、除外はサポートされません。
--自動削除なし [pkg] ...
デフォルトでは、「tlmgr」はサーバー上で消失したパッケージを削除しようとします。
上記の「--all」で説明されています。 このオプションは、そのような削除を防止します。
パッケージ (「--all」付き)、または指定されたパッケージのみ pkg 名前。 これにより、次のような問題が発生する可能性があります。
パッケージの名前変更や置き換えが頻繁に行われるため、TeX のインストールに一貫性がない
彼らの著者による。 したがって、これはお勧めできません。
--自動インストールなし [pkg] ...
通常の状況では、「tlmgr」はサーバー上に新しいパッケージをインストールします。
上記の「--all」で説明したとおりです。 このオプションは、そのような自動化を防ぎます。
すべてのパッケージ (「--all」を使用) または指定されたパッケージのインストール pkg 名前。
さらに、これを使用した「tlmgr」の実行が完了すると、
自動インストールされています 意志 be 見なさ as 強制的に 削除。 したがって、「foobar」が
サーバー上に唯一の新しいパッケージがある場合、
tlmgr update --all --no-auto-install
に相当します
tlmgr 更新 --all
tlmgr 削除 --force foobar
--再インストール強制削除
通常の状況では、「tlmgr」は強制的にインストールされたパッケージをインストールしません。
ユーザーによって削除された。 つまり、「remove --force」で削除されたか、そのインストールが
以前のアップデートでは「--no-auto-install」によって禁止されていました。
このオプションにより、「tlmgr」は強制削除を無視し、強制削除をすべて再インストールします。
パッケージ。 これを使用すると、インストールとサーバーのインストールを完全に同期できます。
利用可能なもののアイデア:
tlmgr 更新 --reinstall-強制的に削除 --all
- バックアップ と --backupdir ディレクトリにジョブを開始します。
これら XNUMX つのオプションは、パッケージのバックアップの作成を制御します。 更新; それか
つまり、現在インストールされているパッケージのバックアップです。 これらのオプションのどちらも指定されない場合、
バックアップ パッケージは保存されません。 「--backupdir」が指定され、書き込み可能なディレクトリが指定されている場合
ディレクトリにバックアップが作成されると、その場所にバックアップが作成されます。 「--backup」のみを指定した場合、
その後、「オプション」アクションで以前に設定したディレクトリにバックアップが作成されます。
（下記参照）。 両方を指定すると、指定されたファイルにバックアップが作成されます。 ディレクトリにジョブを開始します。.
「オプション」アクションでオプションを設定し、すべてのバックアップを自動的に作成できます。
パッケージを削除したり、特定の数のバックアップのみを保持したりできます。 「オプション」をご覧ください
詳細についてはアクションを参照してください。
「tlmgr」は、ダウンロードやパッケージの更新時に常に一時的なバックアップを作成します。
アップデート中のその他の障害。 対照的に、この「--backup」オプションの目的は次のとおりです。
実際に問題が発生した場合に備えて永続的なバックアップを保存できるようにします。 コンテンツ 更新の
非互換性が生じるなど、問題が発生します。
「復元」アクションでは、バックアップから復元する方法について説明します。
--いいえ、依存します
通常、パッケージの更新を呼び出すと、依存するすべてのパッケージも更新されます。
更新をチェックし、必要に応じて更新します。 このスイッチはこの動作を抑制します。
--まったく依存しない
上記を参照 install （そして注意してください）。
- 力
「tlmgr」自体を更新せずに、通常のパッケージを強制的に更新します（「--self」を除く）
オプションも与えられます）。 お勧めしません。
また、「update --list」はこのオプションに関係なく実行されます。
サーバー上のパッケージがすでにインストールされているパッケージよりも古い場合 (例:
選択したミラーが古い場合)、「tlmgr」はダウングレードしません。 また、
アンインストールされたプラットフォームはインストールされません。
「tlmgr」は、更新に使用される「texlive.tlpdb」ファイルのコピーをサフィックス付きで保存します。
「tlpkg/texlive.tlpdb」のようにリポジトリ URL を表します。長いハッシュ文字列。 これらはできます
フォールバック情報には役立ちますが、それらが蓄積されるのが好きではない場合（たとえば、
「mirror.ctan.org」を実行すると、新しいホストに解決される可能性があり、その結果、異なるハッシュが生成されます。
削除しても無害です。
USER モード
「tlmgr」は、任意の texmf ツリーを管理するための、「ユーザー モード」と呼ばれる制限された方法を提供します。
メインのインストールと同じ方法で。 たとえば、これにより、書き込みのない人でも使用できるようになります。
パッケージをツリーに更新/インストールするためのインストール場所に対する権限
自分の。
「tlmgr」は、コマンドラインオプション「--usermode」を使用してユーザーモードに切り替えられます。 そうではありません
自動的に切り替わります。また、そのための構成ファイルの設定もありません。 したがって、これは
ユーザーモードをアクティブにするたびに、オプションを明示的に指定する必要があります。
「tlmgr」のこのモードはユーザー ツリーで動作し、デフォルトでは「TEXMFHOME」の値が使用されます。
変数。 これは、コマンド ライン オプション「--usertree」で上書きできます。 の中に
以下、ユーザー ツリーについて話すときは、「TEXMFHOME」または上で指定されたもののいずれかを意味します。
コマンドライン。
ユーザー モードではすべてのアクションが許可されるわけではありません。 「tlmgr」は警告を出しますが、何も実行しません。
問題のある行為。 現在サポートされていません (おそらく今後もサポートされない) のは、
「プラットフォーム」アクション。 「gui」アクションは現在サポートされていませんが、将来サポートされる可能性があります。
リリース。
一部の「tlmgr」アクションは書き込み権限を必要としないため、ユーザー モードでも同様に機能します。
そしてノーマルモード。 現在、これらは「check」、「help」、「list」、「print-platform」、
「検索」、「表示」、「バージョン」。
一方、パッケージ管理を扱うほとんどのアクションでは、次の書き込みが必要です。
権限があるため、以下で説明するように、ユーザー モードでは動作が異なります。
「更新」、「削除」、「オプション」、「用紙」、「生成」、「バックアップ」、「復元」、「アンインストール」、
「シンボリックリンク」。
ユーザーモードで「tlmgr」を使用する前に、ユーザーツリーを設定する必要があります。
「init-usertree」アクション。 これにより、 ユーザーツリー「/web2c」と ユーザーツリー「/tlpkg/tlpobj」、および
最小限の ユーザーツリー「/tlpkg/texlive.tlpdb」。 その時点で、「tlmgr」に次のことを実行するように指示できます。
(サポートされている) アクションは、「--usermode」コマンド ライン オプションを追加することで実行できます。
ユーザーモードでは、ファイル ユーザーツリー「/tlpkg/texlive.tlpdb」には、次のパッケージのみが含まれます。
「tlmgr」を使用してユーザー ツリーにインストールされ、さらに、
「仮想」パッケージ「00texlive.installation」（メインのインストールと同様）
「texlive.tlpdb」）。
ユーザー モードのパッケージに対するすべてのアクションは、次のパッケージに対してのみ実行できます。
「再配置可能」。 これには、実行可能ファイルとその他のいくつかのコアを含むすべてのパッケージが除外されます。
パッケージ。 現在 TeX Live にある 2500 ほどのパッケージのうち、大部分は次のとおりです。
再配置可能で、ユーザー ツリーにインストールできます。
ユーザーモードでのアクションの変更の説明:
ユーザー モード install
ユーザー モードでは、「インストール」アクションにより、パッケージとすべての依存関係がすべて正しいかどうかがチェックされます。
再配置されたか、システムのインストール時にすでにインストールされています。 このような場合は、
ユーザー ツリーにインストールするすべてのコンテナを解凍します (繰り返しになりますが、次のいずれかです)
"TEXMFHOME" または "--usertree" の値) を指定し、それぞれのパッケージをユーザーに追加します
ツリーの「texlive.tlpdb」（必要に応じて作成します）。
現在ユーザー モードでコレクションをインストールすると、すべての依存パッケージがインストールされますが、
通常モードとは対照的に、 依存するコレクションをインストールします。 たとえば、通常の場合
モード「tlmgr install collection-context」は「collection-basic」などをインストールします。
ユーザーモードでのコレクション、 の 「collection-context」で言及されているパッケージは次のとおりです。
インストールされています。
ユーザー モード バックアップ、 戻す、 削除、 update
ユーザー モードでは、これらのアクションにより、操作対象のすべてのパッケージが
続行する前にユーザーツリー。 それ以外の場合は、通常モードと同様に動作します。
ユーザー モード 生成、 オプション、 紙
ユーザー モードでは、これらのアクションはユーザー ツリーの構成ファイルおよび/または上でのみ動作します。
「texlive.tlpdb」。 ユーザーツリーに設定ファイルを作成する
CONFIGURATION FILE FOR TLMGR
コマンド ライン オプションの小さなサブセットは、「tlmgr」の構成ファイルで設定できます。
「TEXMFCONFIG/tlmgr/config」にあります。 デフォルトでは、設定ファイルは次の場所にあります。
"~/.texliveYYYY/texmf-config/tlmgr/config" ("YYYY" を TeX の年に置き換えます)
ライブインストール）。 これは 「TEXMFSYSVAR」。ファイルは単一のファイルに固有です。
ユーザー。
このファイルでは、空行と # で始まる行は無視されます。 他のすべての行は、
のように見える
キー = 値
ここで、許可されるキーは「gui-expertmode」（値 0 または 1）、「persistent-downloads」（値
0 または 1)、「auto-remove」(値 0 または 1)、および「gui-lang」(コマンド ラインのような値)
オプション）。
「persistent-downloads」、「gui-lang」、「auto-remove」はそれぞれのコマンドに対応します。
同じ名前の行オプション。 「gui-expertmode」は、完全な GUI と
重要でよく使用される設定のみを備えた簡素化された GUI。
複数 リポジトリ
メインの TeX Live リポジトリには、膨大な数のパッケージが含まれています。 それにも関わらず、追加で
ローカル リポジトリは、ローカルにインストールされたリソースを提供するのに役立ちます。
独自のフォントとハウススタイル。 また、代替パッケージリポジトリが配布されています
何らかの理由で TeX Live に含めることができない、または含めるべきではないパッケージ。
最も簡単で信頼性の高い方法は、インストール ソースを一時的に任意の場所に設定することです。
リポジトリ (「-repository」または「option repository」コマンド ライン オプションを使用)、および
操作を実行します。
ただし、複数のリポジトリを長期間にわたって使用している場合は、明示的に
それらを切り替えると不便になります。 したがって、「tlmgr」に次のことを伝えることができます。
使用する追加のリポジトリ。 基本的なコマンドは「tlmgr repository add」です。
このセクションの残りの部分でさらに詳しく説明します。
複数のリポジトリを使用する場合、そのうちの XNUMX つをメイン リポジトリとして設定する必要があります。
インストールされているパッケージのほとんどを配布します。 単一リポジトリから切り替える場合
複数のリポジトリにインストールすると、以前の唯一のリポジトリが
メインリポジトリとして設定します。
デフォルトでは、複数のリポジトリが構成されている場合でも、パッケージは まだ の
メインリポジトリからインストールされます。 したがって、単に XNUMX 番目のリポジトリを追加するだけでは、
実際にそこから何かをインストールできるようにします。 また、どれを指定する必要がありますか
パッケージは、いわゆる「ピン留め」を指定して、新しいリポジトリから取得する必要があります。
ルールについては次に説明します。
ピンニング
パッケージ「foo」がリポジトリに固定されている場合、パッケージ「foo」は他のリポジトリにあり、
たとえそれより高いリビジョン番号であっても、インストール可能な候補とは見なされません。
前述したように、デフォルトではすべてがメイン リポジトリに固定されます。 さあ行きましょう
XNUMX 番目のリポジトリをセットアップし、パッケージの更新を有効にする例を通して
それから。
まず、複数のリポジトリがサポートされていること、および XNUMX つのみが有効になっていることを確認します (
デフォルトではそうなります):
$ tlmgr リポジトリ リスト
リポジトリのリスト (設定されている場合はタグ付き):
/var/www/ノーバート/tlnet
Ok。 「tlcontrib」リポジトリを追加しましょう (これは実際のリポジトリであり、
<http://tlcontrib.metatex.org>、Taco Hoekwater et al. によって管理されています)、タグ付き
"tlcontrib":
$ tlmgr リポジトリの追加 http://tlcontrib.metatex.org/2012 tlcontrib
リポジトリ リストをもう一度確認します。
$ tlmgr リポジトリ リスト
リポジトリのリスト (設定されている場合はタグ付き):
http://tlcontrib.metatex.org/2012 (tlcontrib)
/var/www/norbert/tlnet (メイン)
次に、ピン留めエントリを指定して、「tlcontrib」からパッケージ「context」を取得します。
$ tlmgr 固定 tlcontrib コンテキストを追加
「コンテキスト」が見つかることを確認します。
$ tlmgr ショー コンテキスト
tlmgr: パッケージリポジトリ:
...
パッケージ: コンテキスト
リポジトリ: tlcontrib/26867
...
- 「コンテキスト」をインストールします。
$ tlmgr インストールコンテキスト
tlmgr: パッケージリポジトリ:
...
[1/1、??:??/??:??] インストール: context @tlcontrib [
ここの出力では、「context」パッケージが
「tlcontrib」リポジトリ (@tlcontrib)。
最後に、「tlmgr ピンニング」は、特定のパッケージからの特定またはすべてのパッケージの削除もサポートします。
リポジトリ：
$ tlmgr pinning tlcontrib contextを削除 # コンテキストだけを削除
$ tlmgr pinning delete tlcontrib --all # tlcontribから何も取得しません
「tlmgr ピン留め」アクションの概要は上に示しています。
GUI FOR TLMGR
「tlmgr」のグラフィカル ユーザー インターフェイスを使用するには、Perl/Tk がインストールされている必要があります。 Windows の場合、
他のすべての (つまり Unix ベースの) システム用に必要なモジュールは TeX Live 内に同梱されています
Perl/Tk (もちろん Perl も) をインストールする必要があります。
<http://tug.org/texlive/distro.html#perltk> には、いくつかのディストリビューションの呼び出しのリストがあります。
「tlmgr gui」で起動すると、グラフィカルユーザーインターフェースが表示されます。 メインウィンドウ
メニュー バー、メイン ディスプレイ、および通常はメッセージが表示されるステータス領域が含まれます。
コンソールが表示されます。
メインディスプレイ内には、「ディスプレイ設定」エリア、「ディスプレイ設定」エリアの XNUMX つの主要な部分があります。
パッケージのリストとアクション ボタン。
また、右上には現在ロードされているリポジトリが表示されます。 これは、
ボタンをクリックすると、デフォルトのリポジトリのロードが試行されます。 別のものをロードするには
リポジトリについては、「tlmgr」メニュー項目を参照してください。
最後に、ウィンドウの下部にあるステータス領域に、次の追加情報が表示されます。
何が起こっている。
メイン ディスプレイ
ディスプレイ の監視 エリア
メイン表示の最初の部分では、どのパッケージを指定 (フィルター) することができます。
示されています。 デフォルトでは、すべてが表示されます。 ここでの変更はすぐに反映されます。
状況
すべてのパッケージ (デフォルト) を表示するか、インストールされているパッケージのみを表示するか、インストールされているパッケージのみを表示するかを選択します。
インストールされているか、アップデートが利用可能なもののみ。
カテゴリー
表示するカテゴリ (パッケージ、コレクション、スキーム) を選択します。 これらは
上記の「説明」セクションで簡単に説明しました。
一致
特定のパターンに一致するパッケージを選択します。 デフォルトでは、両方を検索します。
説明とファイル名。 検索対象のサブセットを選択することもできます。
選択
選択されているパッケージ、選択されていないパッケージ、またはすべてのパッケージを選択します。 ここでは「選択」
は、パッケージの行の先頭にあるチェックボックスがオンになっていることを意味します。
設定ボタンを表示する
右側には XNUMX つのボタンがあります: すべてのパッケージを選択、何も選択しません (別名)
すべての選択を解除して)、これらすべてのフィルターをデフォルトにリセットします。つまり、利用可能なものをすべて表示します。
パッケージ リスト エリア
XNUMX 番目のメイン表示には、インストールされているすべてのパッケージがリストされます。 リポジトリが
ロードされている場合、使用可能だがインストールされていないものもリストされます。
パッケージ行をダブルクリックすると、詳細を示す情報ウィンドウがポップアップ表示されます。
長い説明、含まれるファイルなど。
パッケージ リストの各行は次の項目で構成されます。
チェックボックス
特定のパッケージを選択するために使用されます。 一部のアクション ボタン (下記を参照) のみ機能します
選択したパッケージについて。
パッケージ名
データベースに指定されているパッケージの名前 (識別子)。
ローカル リビジョン (およびバージョン)
パッケージがインストールされている場合は、インストールされているパッケージの TeX Live リビジョン番号
が表示されます。 このデータベースに指定されたカタログ バージョンがある場合
パッケージの場合は括弧内に表示されます。 ただし、カタログ版とは異なり、
TL リビジョンは、実際にインストールされている内容を反映しているとは保証されません。
リモート リビジョン (およびバージョン)
リポジトリがロードされている場合は、リポジトリ内のパッケージのリビジョン (
現在）が表示されます。 ローカル コラムと同様、カタログ バージョンが提供されている場合は、
と表示されます。 また、ローカルコラムと同様に、カタログ版は
古くなった。
簡単な説明
パッケージの簡単な説明。
メイン ディスプレイ アクション ボタン
パッケージのリストの下には、いくつかのボタンがあります。
インストールされているすべてを更新する
これは「tlmgr update --all」を呼び出します。つまり、利用可能なすべてのパッケージの更新を試みます。 下
このボタンは、以前に削除したパッケージを一部として再インストールできるようにするための切り替えボタンです。
このアクションの。
他の XNUMX つのボタンは、選択したパッケージ、つまり、
パッケージ行の先頭にあるチェックボックスがオンになっています。
更新
選択したパッケージのみを更新します。
インストールを開始する
選択したパッケージをインストールします。 「tlmgr install」のように動作します。つまり、インストールも行われます。
依存関係。 したがって、コレクションをインストールすると、そのコレクションを構成するすべてのパッケージがインストールされます。
削除します
選択したパッケージを削除します。 「tlmgr delete」と同様に動作します。つまり、削除も行われます。
コレクションの依存関係 (ただし、通常のパッケージの依存関係は対象外)。
バックアップ
選択したパッケージのバックアップを作成します。 「tlmgrバックアップ」のように機能します。 このアクションには必要なものがあります
オプション「backupdir」が設定されています（「オプション - 「一般」>を参照）。
メニュー バー
メニュー バーには次のエントリがあります。
「tlmgr」メニュー
ここの項目はさまざまなリポジトリをロードします: TeX Live で指定されているデフォルト
データベース、デフォルトのネットワーク リポジトリ、コマンド ラインで指定されたリポジトリ
(存在する場合)、および任意に手動で入力されたもの。 非常に必要な「辞める」機能もあります
操作。
「オプションメニュー」
いくつかのオプション グループへのアクセスを提供します: 「用紙」(デフォルトの用紙の構成)
サイズ)、「プラットフォーム」(Unix のみ、サポート/インストールされている構成)
プラットフォーム)、「GUI 言語」(GUI インターフェースで使用される言語を選択)、および「全般」
（ほかのすべて）。
いくつかのトグルもここにあります。 XNUMX つ目は「エキスパート オプション」です。これは、
デフォルト。 これをオフにすると、次回 GUI を起動したときに簡略化された画面が表示されます。
最も重要な機能のみを表示することが表示されます。 この設定は
「tlmgr」の設定ファイルに保存されます。 詳細については、「TLMGR の設定ファイル」を参照してください。
詳細。
他のトグルはデフォルトですべてオフになっています。デバッグ出力の場合、
新しいパッケージの自動インストール、および自動削除を無効にします。
パッケージがサーバーから削除されました。 何があるか、何がそうでないかの選択肢で遊ぶ
インストールすると、TeX Live のインストールに一貫性がなくなる可能性があります。 たとえば、パッケージが
名前が変更されました。
「アクションメニュー」
いくつかのアクションへのアクセスを提供します: ファイル名データベースの更新 (別名「ls-R」、
"mktexlsr"、"texhash")、すべての形式を再構築 ("fmtutil-sys --all")、フォント マップを更新
データベース (「updmap-sys」)、パッケージのバックアップからの復元、およびシンボリック リンクの使用
システム ディレクトリ内 (Windows 上ではありません)。
最後のアクションは、TeX Live インストール全体を削除することです (これも Windows 上では削除されません)。
「ヘルプメニュー」
TeX Live マニュアルへのアクセスを提供します (Web 上にもあります:
<http://tug.org/texlive/doc.html>) そして通常の「About」ボックス。
機械可読 出力
「--machine-readable」オプションを使用すると、「tlmgr」は固定行指向で stdout に書き込みます。
ここで説明されている形式、および人間が使用するための通常の情報メッセージは次のとおりです。
stderr に書き込まれます (通常は stdout に書き込まれます)。 アイデアは、プログラムができるということです。
標準出力を読み取ることで、必要な情報をすべて取得します。
現在、このオプションは更新、インストール、および「オプション」アクションにのみ適用されます。
機械可読 "アップデート" と "インストール" 出力
出力形式は次のとおりです。
フィールド名「\t」値
...
「ヘッダーの終わり」
pkgname ステータス localrev serverrev サイズ ランタイム esttot
...
「アップデートの終了」
ポストアクションからのその他の出力（機械可読形式ではない）
現在、ヘッダー セクションには XNUMX つのフィールドがあります: "location-url" (リポジトリ ソース
どの更新が描画されるか)、および「total-bytes」(描画される合計バイト数)
ダウンロードしました）。
この ローカルレブ と サーバーrev 各パッケージのフィールドは、ローカルのリビジョン番号です。
それぞれインストールとサーバーリポジトリです。 の サイズ フィールドはバイト数です
ダウンロードするファイル、つまりネットワーク インストール用の圧縮 tar ファイルのサイズ、
開梱後のサイズではありません。 runtime フィールドと esttot フィールドは、更新されたフィールドと esttot フィールドにのみ存在します。
自動インストール パッケージ、および開始からの現在の経過時間が含まれます。
インストール/アップデートと推定合計時間。
現在のプラットフォームに応じて、行末は LF または CRLF のいずれかになります。
「場所-URL」 場所
この 場所 URL (「file:///foo/bar/...」を含む) またはディレクトリ名です。
(「/foo/bar」)。 新しいパッケージ情報が取得されたパッケージ リポジトリです。
描かれた。
「合計バイト数」 カウント
この カウント は単なる XNUMX 進数で、すべてのパッケージのサイズの合計です。
更新またはインストールが必要です (後でリストします)。
次に、リテラル文字列「end-of-header」のみを含む行が続きます。
リテラル文字列「end-of-updates」を含む行が XNUMX つのレポートを報告するまで、後続の各行
パッケージ。 各行のフィールドはタブで区切られています。 ここにフィールドがあります。
パッケージ名
TeX Live パッケージの識別子。実行可能ファイルのプラットフォーム接尾辞も付けられます。 ために
たとえば、「pdftex」と「pdftex.i386-linux」は XNUMX つの別個のパッケージとして提供されます。
各行。
status
パッケージのアップデートのステータス。 次のような XNUMX 文字:
"d" パッケージはサーバー上で削除されました。
"f" コレクションが存在していても、パッケージはローカル インストールで削除されました。
それに依存していた。 (たとえば、ユーザーは「tlmgr delete --force」を実行しました。)
"u" 通常のアップデートが必要です。
"r" 逆非更新: ローカルにインストールされたバージョンは、そのバージョンよりも新しいです
サーバー上で
"a" インストールの必要性が自動的に判断され、パッケージは新しいものになります。
これは (おそらく) インストールされたコレクションの一部です。
「i」パッケージはインストールされますが、ローカル インストールには存在しません (アクション
インストール）。
「I」パッケージはすでに存在しますが、再インストールされます (アクションインストール)。
ローカルレブ
インストールされているパッケージのリビジョン番号。ローカルに存在しない場合は「-」。
サーバーrev
サーバー上のパッケージのリビジョン番号。サーバー上に存在しない場合は「-」。
サーバー。
サイズ
サーバー上のパッケージのサイズ (バイト単位)。 すべてのパッケージのサイズの合計は、
前述の「total-bytes」ヘッダー フィールドで指定されます。
ランタイム
インストールまたはアップデートの開始からの実行時間。
エストット
推定合計時間。
機械可読 "オプション" 出力
出力形式は次のとおりです。
キー「\t」の値
値がデータベースに保存されていない場合は、文字列「(not set)」が表示されます。
この出力を使用するプログラムを開発していて、変更が次のようになることを発見した場合、
役に立ちますので、遠慮せずにメーリング リストに書き込んでください。
作者 そして COPYRIGHT
このスクリプトとそのドキュメントは、TeX Live ディストリビューション用に作成されました。
(<http://tug.org/texlive>)、両方とも GNU General Public License に基づいてライセンスされています。
バージョン2以降。
onworks.net サービスを使用してオンラインで tlmgr を使用する
