TeX Live

2023-06-12T16:29:56Z

Ecto0310: texlive-mostをtexliveに変更

[[Category:TeX]]
[[en:TeX Live]]
[[fa:LaTeX]]
[[it:TeX Live]]
[[zh-hans:TeX Live]]
{{Related articles start}}
{{Related4|TeX Live FAQ}}
{{Related|TeX Live/CJK}}
{{Related|Tectonic}}
{{Related articles end}}
[[Wikipedia:TeX Live|Wikipedia]] により:

:'''TeX Live''' は、[[Wikipedia:TeX|TeX]] 植字システムのためのフリーソフトウェア配布で、主要な TeX 関連プログラム、マクロパッケージ、およびフォントを含んでいます。

TeX Live には {{man|1|tex}} と {{man|1|pdftex}} プログラム、[[Wikipedia:LaTeX|LaTeX]] と [[Wikipedia:ConTeXt|ConTeXt]] TeX マクロパッケージ、[[Wikipedia:XeTeX|XeTeX]] と [[Wikipedia:LuaTeX|LuaTeX]] TeX エンジンが含まれています。

== インストール ==

* {{Grp|texlive}} グループには、ほとんどの Tex Live パッケージが含まれています。
** {{Pkg|texlive-core}} は必須のパッケージであり、上流の ''medium'' インストールスキームに基づいています (その他のパッケージは全て上流のコレクションに基づいています)。このパッケージには、''mktexlsr''、''fmtutil''、''updmap'' を自動化する [[pacman フック]]が含まれています。
** {{Pkg|texlive-bin}} にはバイナリとライブラリが含まれています ({{Pkg|texlive-core}} の依存パッケージです)。
** {{Pkg|texlive-latexextra}} には、{{ic|polyglossia}}、{{ic|amsmath}}、{{ic|graphicx}} などの便利なパッケージが多く含まれています。
* {{Grp|texlive-lang}} グループには、非ラテン文字の言語のための文字セットと機能を提供するパッケージが含まれています。
** {{Pkg|texlive-langextra}} は、アフリカの言語、アラビア語、アルメニア語、クロアチア語、ヘブライ語、インド語群、モンゴル語、チベット語、ベトナム語の言語サポートを提供します。
* {{Pkg|texlive-bibtexextra}} には、追加の BibTex と [https://ctan.org/pkg/biblatex BibLaTeX] スタイル、および参考文献データベースが含まれています。
* {{Pkg|texlive-fontsextra}} には、追加のフォントが含まれています ([https://www.tug.org/FontCatalogue/ LaTeX Font Catalogue] で見られます)。
* {{Pkg|biber}} は、BibLaTex のための代替の参考文献処理バックエンドを提供します。
* {{AUR|texlive-latexindent-meta}} メタパッケージは、''latexindent'' を実際に使うために必要になるすべての依存パッケージを提供します。

それぞれの ''texlive-'' パッケージにどの [https://www.ctan.org/ CTAN] パッケージが含まれているか調べるには、{{ic|/var/lib/texmf/arch/installedpkgs/<package>_<revnr>.pkgs}} のファイルを見てください。

{{Note|Tex Live に含まれている一部のツールとユーティリティは、{{Pkg|ghostscript}} や {{Pkg|perl}}、{{Pkg|python}}、{{Pkg|ruby}} に依存しています。詳細は、それぞれのパッケージの任意の依存パッケージを見てください。}}

{{Tip|[[アプリケーション一覧/ドキュメント#Tex editors|Tex エディタ]]をインストールすると良いかもしれません。}}

=== tllocalmgr ===

{{AUR|tllocalmgr}} によって提供されている ''tllocalmgr'' ユーティリティは、[[pacman]] パッケージとして CTAN からパッケージをインストールできるようにします。詳細は [https://github.com/hv15/tllocalmgr/blob/master/tllocalmgr#L835 使用方法] ({{ic|-h}}) を見てください。

=== tlmgr ===

{{Note|
* {{Pkg|texlive-core}} は ''TEXMFDIST'' 内に [https://www.tug.org/texlive/tlmgr.html tlmgr] スクリプトを提供しますが、これは壊れています。以下で説明されているように修正するか、あるいは代わりに [[#tllocalmgr|tllocalmgr]] を使用することができます。
* {{man|1|texconfig}} コマンドは、部分的に ''tlmgr'' に依存しているため、ほぼ壊れています ({{Bug|59094}})。{{ic|texconfig}} のインタラクティブモードには {{Pkg|dialog}} が必要です。
}}

{{Accuracy|以下の修正は {{Pkg|texlive-core}} パッケージに組み込まれるべきです。''TEXMFDIST'' 内のファイルを編集しても、パッケージをアップグレードすると変更が上書きされてしまいます。}}

''tlmgr'' ユーティリティは、CTAN からパッケージをインストール、アップデートする標準的な方法です。以下のように小さな修正が必要となります:

まず、{{ic|''TEXMFDIST''/scripts/texlive/tlmgr.pl}} を編集して {{ic|1=$Master = "$Master/../..";}} を {{ic|1=$Master = "${Master}/../../..";}} に置き換えてください。パスのプレフィックス ''TEXMFDIST'' は、事前に定義された環境変数ではなく、この記事の以下で定義されたものです。このプレフィックスは正しい値に置き換えてください。

その perl スクリプトのエイリアスを作成してください (シェルの init ファイルに追加できます)。

alias tlmgr='''TEXMFDIST''/scripts/texlive/tlmgr.pl --usermode'

これで、ユーザモードで初期化できます (インストールプレフィックスとして {{ic|~/texmf}} を使用します):

$ tlmgr init-usertree

自由に[https://www.ctan.org/mirrors ミラー]を設定してください。例えば:

<nowiki>$ tlmgr option repository http://mirrors.rit.edu/CTAN/systems/texlive/tlnet</nowiki>

これで、CTAN パッケージを通常通りインストールできるようになりました:

$ tlmgr install ''package_name''

=== パッケージのドキュメント ===

公式リポジトリ内のパッケージには、フォント/マクロのパッケージのドキュメントやソースファイルが含まれていません。

{{ic|texdoc}} でオフラインアクセスするには、Tex Live のドキュメント全体とソースファイルを {{AUR|texlive-most-doc}} で[[インストール]]するか、あるいは ''tllocalmgr'' で特定のパッケージのドキュメントをインストールすることで可能です。

また、オンラインでドキュメントにアクセスすることもできます:

* https://tug.org/texlive/Contents/live/doc.html
* https://ctan.org/ – Tex 関連の全種類の資料の中心的な場所
* https://texdoc.net/{{Dead link|2022|09|23|status=SSL error}} ({{ic|<nowiki>http://texdoc.net/pkg/</nowiki>''packagename''}} は、関連する PDF を直接生成します)

=== 手動インストール ===

上流のインストーラで Tex Live をインストールすることもできます。これは {{AUR|texlive-installer}} としてパッケージングされています。詳細は [[wikibooks:LaTeX/Installation#Custom_installation_with_TeX_Live|LaTeX Wikibook]] や [https://tug.org/texlive/doc/texlive-en/texlive-en.html#x1-140003 TeX Live Guide] を見てください。

== 使用方法 ==

以下のリソースを参照してください:

* [[Wikibooks:LaTeX]]
* [https://tobi.oetiker.ch/lshort/lshort.pdf The Not So Short Introduction to LaTeX 2ε]
* [https://www.andy-roberts.net/writing/latex Getting to Grips with LaTeX – Andrew Roberts]
* [https://www.texfaq.org/ The TeX FAQ]

=== texmf ツリーと Kpathsea ===

texmf ツリー (''texmf'' は TeX と [[Wikipedia:ja:METAFONT|Metafont]] の略) は [https://tug.org/tds/ TeX Directory Structure] に従う必要があります。さもないと、ファイルを見つけられない場合があります。[https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-110002.3]

Tex Live は [https://tug.org/texinfohtml/kpathsea.html Kpathsea] ライブラリを使用して、複数の texmf ツリーと現在の作業ディレクトリにまたがってファイル名でパスを探索します。

Kpathsea は以下の変数を逆順で検索します (後のツリーは前のものを上書きします)。

{| class="wikitable"
! 変数 !! Arch のデフォルト <sup>1)</sup> !! その変数を使用するもの [https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-110002.3]
|-
| {{ic|TEXMFDIST}} || {{ic|/usr/share/texmf-dist}} || 元のディストリビューションのファイル
|-
| {{ic|TEXMFLOCAL}} || {{ic|/usr/local/share/texmf:/usr/share/texmf}} || 追加およびアップデートされたマクロ、フォントなどをシステム全体にインストールするために管理者が使用
|-
| {{ic|TEXMFSYSVAR}} || {{ic|/var/lib/texmf}} || (キャッシュされた) ランタイムデータを保管するために updmap と fmtutil (ユーザモード) が使用
|-
| {{ic|TEXMFSYSCONFIG}} || {{ic|/etc/texmf}} || 変更された設定データを保管するために updmap と fmtutil (ユーザモード) が使用
|-
| {{ic|TEXMFHOME}} || {{ic|~/texmf}} || 追加およびアップデートされたマクロ、フォントなどをユーザ個別にインストールするためにユーザが使用
|-
| {{ic|TEXMFVAR}} || {{ic|~/.texlive/texmf-var}} || (キャッシュされた) ランタイムデータを保管するために updmap と fmtutil (システムモード) が使用
|-
| {{ic|TEXMFCONFIG}} || {{ic|~/.texlive/texmf-config}} || 変更された設定データを保管するために updmap と fmtutil (システムモード) が使用
|-
| {{ic|TEXMFCACHE}} || {{ic|$TEXMFSYSVAR;$TEXMFVAR}} || (キャッシュされた) ランタイムデータを保管するために ConTeXt MkIV と LuaLaTeX が使用
|}

{{Note|デフォルトの値は {{ic|/etc/texmf/web2c/texmf.cnf}}[https://github.com/archlinux/svntogit-packages/blob/packages/texlive-core/trunk/texmf.cnf] で定義されています。それらの値は[[環境変数]]によって上書きできます。}}

Kpathsea は、パスを探索するための {{man|1|kpsewhich}} コマンドを提供します。{{ic|1=--var-brace-value=''VARIABLE''}} 引数で実行すれば、変数の値も表示できます。

Kpathsea はファイル名データベース ({{ic|ls-R}}) を使用して、システム全体の texmf ツリー ({{ic|TEXMFDBS}} 変数で設定される) での検索を高速化させます。つまり、システム全体のファイルツリーが変更された際に {{man|1|mktexlsr}} か {{ic|texhash}} (シンボリックリンク) を [[ユーザーとグループ#概要|root]] として実行する必要があるということです。幸い、{{Pkg|texlive-core}} は、{{ic|/usr/local/share/texmf}} を除くすべてのデフォルトのシステム全体ツリーを対象とする [[pacman フック]]で自動化します。[https://github.com/archlinux/svntogit-packages/blob/packages/texlive-core/trunk/mktexlsr.hook] なので、システム全体に [[pacman]] を通してパッケージをインストールする限り、あなたが ''mktexlsr'' や ''texhash'' を実行する必要は全くないはずです。

{{Tip|ローカルリポジトリをセットアップするために、{{ic|~/texmf/tex/{format}/}} ディレクトリ構造を作成することができます ({{ic|{format} }} は通常 {{ic|latex}} です)。カスタムクラスは {{ic|./{format} }} フォルダ直下に配置され、他のローカルファイルは同じ名前のフォルダに配置されます (例えば、{{ic|mycustompackage.sty}} は {{ic|./{formats}/mycustompackage/mycustompackage.sty}} に行きます)。その後、{{ic|texhash}} を実行してユーザのデータベースをアップデートしてください。}}

== 重要事項 ==

{{Out of date|ConTeXt は最近、設定せずに使用できます。時々、{{ic|mtxrun --generate}} を実行する必要があるだけです。[https://www.contextgarden.net/Running_Mark_IV]}}

* (MKII や MKIV の) ConTeXt フォーマットはインストール時に自動で生成されません。方法は [https://wiki.contextgarden.net ConTeXT wiki] の説明を見て下さい。
* (上流の) TeX Live は CTAN パッケージの差分更新をするためのツールを提供しています。私たちもパッケージを定期的に更新する予定です (作業をほぼ自動化するツールを書き出しています)。
* 2009年の9月から {{man|1|updmap}} のフォントマッピングを処理する方法は改善され、以前よりもインストールが信頼できるものになっています。もし、マップファイルが見つからないというエラーメッセージが表示されたときは、手動で {{ic|updmap.cfg}} ファイルから削除してください ({{Ic|updmap-sys --edit}} を使うのが理想)。また、{{Ic|updmap-sys --syncwithtrees}} を実行すれば設定ファイルから古くなったマップを自動でコメントアウトすることができます。

== ヒントとテクニック ==

=== デフォルトの用紙サイズを変更する ===

{{Accuracy|設定ファイルを直接編集することで可能です。[https://tug.org/pipermail/tex-live/2009-April/020692.html]}}

現在、texlive ツールを使用してデフォルトのページサイズを変更することは不可能です。ツールが標準の Arch パッケージで機能しないためです。

通常では、{{ic|texconfig}} か {{ic|tlmgr}} を実行します (これらは、他の便利な設定を変更することもできます)。

以下のように設定ファイルを変更できます。

* ''pdftex'' ファミリのコマンド (''pdftex''、''pdflatex'' など) に対して用紙サイズを設定するには、{{ic|/etc/texmf/tex/generic/tex-ini-files/pdftexconfig.tex}} を編集してください。

このファイルは {{ic|kpsewhich pdftexconfig.tex}} を実行することでも見つけられます。{{ic|pdfpageheight}} と {{ic|pdfpagewidth}} を指定する2行を変更してください。例えば、レターサイズを使用するには、

\pdfpageheight = 297 true mm
\pdfpagewidth = 210 true mm

から

\pdfpageheight = 11 true in
\pdfpagewidth = 8.5 true in

に変更してください。

残念ながら、これは、バイナリの ''.fmt'' ファイルをリビルドするまで効果がありません。{{ic|fmtutil-sys}} でリビルドできます。また、[[pacman]] で {{Pkg|texlive-bin}} を再インストールしてもリビルドできます。

* ''dvips'' に対しては、{{ic|-t}} オプションを使って用紙サイズを指定できます: {{ic|dvips -t letter foo.dvi}}。デフォルトを変更するには、{{ic|/etc/texmf/dvips/config/config.ps}} を編集してください。

このファイルは {{ic|kpsewhich config.ps}} を実行することでも見つけられます。このファイルの最後にあるセクションには、''dvips'' が認識するすべての用紙サイズがリストアップされています。リストの最初にある用紙サイズがデフォルトとなります。デフォルトを変更するには、デフォルトにしたいサイズをリストの先頭に移動させてください。''dvips'' の挙動は、ファイルが変更されるとすぐに変更されます。

=== Fontconfig でフォントを利用可能にする ===

デフォルトでは、さまざまな TeX Live パッケージに入っているフォントを [[Fontconfig]] から自動で利用することができません。XeTeX や [[LibreOffice]] などからフォントを使えるようにしたいときは、フォントディレクトリから[[フォント設定#フォントパス|ユーザのフォントパス]]へのシンボリックリンクを作成するのが一番簡単です。OpenType フォントの場合は、以下を実行してください:

$ ln -s /usr/share/texmf-dist/fonts/opentype/public/''some_fonts_you_want'' ~/''font_path''/OTF/

fontconfig で利用できるようにするには、次を実行してください:

$ fc-cache ~/''font_path''
$ mkfontscale ~/''font_path''/OTF
$ mkfontdir ~/''font_path''/OTF

TrueType フォントや Type 1 フォントに対しても似たような手順です。上記のコマンドでは、{{ic|opentype}} を {{ic|truetype}} や {{ic|type1}} に変更し、{{ic|OTF}} を {{ic|TTF}} や {{ic|Type1}} に変更します。

また、{{Pkg|texlive-core}} には TeX Live によって使用されるフォントディレクトリのリストが入ったファイル {{ic|/usr/share/fontconfig/conf.avail/09-texlive-fonts.conf}} が含まれています。このファイルを利用するには次を実行して:

{{bc|# ln -s /usr/share/fontconfig/conf.avail/09-texlive-fonts.conf /etc/fonts/conf.d/09-texlive-fonts.conf}}

それから fontconfig を更新してください:

{{bc|$ fc-cache && mkfontscale && mkfontdir}}

{{Note|
* TeX と Fontconfig の両方で同一のフォントが利用できる場合 (検索パスに同じフォントのコピーが複数ある場合)、上記の設定が XeTeX/XeLaTeX と衝突する可能性があります。
* Type 1 フォントは LibreOffice 5.3 およびそれ以降で利用できません。
}}

=== babelbib 言語定義の更新 ===

{{Style|{{ic|/usr/share/texmf-dist/}} を変更するべきではありません。}}

必要としている最新の言語定義が [https://www.ctan.org/pkg/babelbib babelbib] になく、全てをリコンパイルしたくはないという問題を抱えている場合、https://www.tug.org/texlive/devsrc/Master/texmf-dist/tex/latex/babelbib/ から手動で入手して {{ic|/usr/share/texmf-dist/tex/latex/babelbib/}} に配置することができます。例えば:

{{bc|<nowiki>
$ cd /usr/share/texmf-dist/tex/latex/babelbib/
# wget https://www.tug.org/texlive/devsrc/Master/texmf-dist/tex/latex/babelbib/romanian.bdf
# wget [...all-other-language-files...]
# wget https://www.tug.org/texlive/devsrc/Master/texmf-dist/tex/latex/babelbib/babelbib.sty
</nowiki>}}

その後、{{ic|texhash}} を実行して TeX データベースを更新してください:

# texhash

== トラブルシューティング ==

=== 更新時に "formats not generated" というエラー ===

{{Bug|16467}} を参照してください。(実験的な ''LuaTeX'' エンジンを使用しない場合、これは無視できることに注意してください。) この状況は典型的に、ハイフネーションパターンの設定ファイル {{ic|language.def}} と {{ic|language.dat}} の両方/一方に、以前のリリースの {{Pkg|texlive-core}} のファイルへの参照が含まれている場合に発生します (特に、ファイル名が頻繁に変更される、ドイツ語の最新の実験的なハイフネーションパターン)。現在、それらは {{ic|dehyph{n,t}-x-2009-06-19.tex}} を指しているはずです。

これを解決するには、ファイル {{ic|/etc/texmf/tex/generic/config/language.<nowiki>{def,dat}</nowiki>}} を削除するか、{{ic|/usr/share/texmf/tex/generic/config/language.<nowiki>{def,dat}</nowiki>}} の最新のバージョンを使うように更新し、以下を実行する必要があります:

# fmtutil-sys --missing

=== tlmgr を texliveonfly で動作させる ===

''tlmgr'' を ''texliveonfly'' で動作させる最も簡単な方法は、({{ic|tlmgr}} をエイリアスにせずに) 以下の内容を含むスクリプト {{ic|tlmgr}} を {{ic|$PATH}} 内に作成することです:

#!/bin/sh
/usr/share/texmf-dist/scripts/texlive/tlmgr.pl --usermode "$@"

こうする理由は、''textliveonfly'' が Python スクリプトであり、エイリアスを処理できないからです。

== 代替 ==

Tex Live の代替としては、MikTex や [[Tectonic]] などがあります。これらは最小限のインストールで、適宜必要なパッケージをインストールします。

== 参照 ==

* [https://tug.org/texlive/doc.html TeX Live ドキュメント]
* [https://tug.org/texlive/doc/texlive-en/texlive-en.html The TeX Live Guide] (完全には当てはまらない)
* [https://tex.stackexchange.com/ TeX - LaTeX Stack Exchange]
* [http://detexify.kirelabs.org/ Detexify LaTeX handwritten symbol recognition]

{{TranslationStatus|TeX Live|2023-01-03|762317}}

ArchWiki - 利用者の投稿記録 [ja]

TeX Live