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

Sxiv

2025-08-09T11:09:25Z

Zkn: 恐らく翻訳時の語順ミスにより原文と意味が変わってしまっていた箇所を修正

{{Lowercase title}}
[[Category:ラスタ画像]]
[[en:Sxiv]]
[[fi:Sxiv]]
[[uk:Sxiv]]
{{Related articles start}}
{{Related|feh}}
{{Related articles end}}

[https://github.com/muennich/sxiv sxiv] (Simple [[X]] Image Viewer) は C で書かれている軽量でスクリプト可能な画像ビューアです。

== インストール ==

次のパッケージのいずれかを [[インストール]] して下さい:

* {{Pkg|nsxiv}} 現在メンテナンスされていない''sxiv'' のフォークであり、sxiv の (主に) ドロップイン代替としての目的を持ち、インターフェイスはそのままで、シンプルな機能を追加します。開発リリース版は、 {{AUR|nsxiv-git}} でインストールできます。
* {{Pkg|sxiv}} オリジナルのパッケージ、現在メンテナンスされていません。

== 使い方 ==

=== sxiv にキーボードショートカットを設定 ===

sxiv は特殊なキーイベントをサポートしています。まず {{ic|Ctrl-x}} を押してから外部のキーハンドラにキーを送信してください。外部のキーハンドラには実行可能ファイル {{ic|~/.config/sxiv/exec/key-handler}} が必要であり、押されたキーの組み合わせや現在の画像の名前が引数として渡されます。(何もマークされていない場合は、現在選択中の画像となります) sxiv をインストールすると、key-handler のサンプルが同梱されます: {{ic|/usr/share/sxiv/exec/key-handler}} この例は、ショートカットをカスタマイズするための素晴らしいスタートです。

$ mkdir -p ~/.config/sxiv/exec/
$ cp /usr/share/sxiv/exec/key-handler ~/.config/sxiv/exec/key-handler

必ずスクリプトに [[ヘルプ:読み方#実行可能属性の付与|実行可能属性を付与]] してください。

以下の例では、バインディング {{ic|Ctrl+d}} によって {{ic|mv ''filename'' ~/.trash}} を実行し、{{ic|Ctrl+c}} で現在の画像の名前を {{Pkg|xclip}} でクリップボードにコピーし、{{ic|Ctrl+w}} で [[nitrogen]] を使って現在の壁紙を設定します。

{{hc|~/.config/sxiv/exec/key-handler|<nowiki>
#!/bin/sh
while read file
do
case "$1" in
"C-d")
mv "$file" ~/.trash ;;
"C-r")
convert -rotate 90 "$file" "$file" ;;
"C-c")
echo -n "$file" | xclip -selection clipboard ;;
"C-w")
nitrogen --save --set-zoom-fill "$file" ;;
esac
done
</nowiki>}}

{{ic|.trash}} フォルダが存在しない場合は作成:
$ mkdir ~/.trash

{{Tip|{{ic|mv "$2" ~/.trash}} の代わりに ({{Pkg|trash-cli}} や {{AUR|bashtrash}} などの) [https://freedesktop.org/wiki/Specifications/trash-spec/ 標準互換のゴミ箱ツール] を使うこともできます。}}

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

=== ファイルを開いた後にディレクトリの画像をブラウズ ===

''sxiv''<nowiki/> の開発者は、引数として指定されたファイル名のディレクトリ内のすべての画像をプログラムで参照するように要求されることが何度かありました ([https://github.com/muennich/sxiv/issues/352] および [https://github.com/muennich/sxiv/issues/105]) を参照、望ましい動作を特徴とするフォークがいくつかあります: [https://github.com/doronbehar/sxiv doronbehar's]、[https://github.com/qsmodo/sxiv qsmodo's]、[https://github.com/sammoth/sxiv sammoth's]

あるいは、{{pkg|sxiv}} の公式バージョンを使用し、[https://github.com/ranger/ranger/blob/master/examples/rifle_sxiv.sh このスクリプト] を {{ic|/usr/local/bin}} に配置して、次のように呼び出します:

$ ''scriptname'' a_single_image.jpg

スクリプトの中のコメントに書かれているように、[[ranger]] の中から画像を開くときに使うことができます。

[https://github.com/muennich/sxiv/issues/365] のこのシェルスクリプトは、{{ic|sxiv}} を開始します。
渡されたファイル引数がフォルダである場合に限り、サムネイルモードになります:

{{hc|~/bin/sxiv.sh|<nowiki>
#!/bin/sh

if command -v sxiv >/dev/null 2>&1; then
if [ -d "${@: -1}" ] || [ -h "${@: -1}" ]; then
sxiv -t "$@"
else
sxiv "$@"
fi
elif command -v feh >/dev/null 2>&1; then
feh "$@"
else
echo "Please install SXIV or FEH!"
fi
</nowiki>}}

=== ステータスバーに画像サイズを表示 ===

以下の実行可能スクリプトを {{ic|~/.config/sxiv/exec/image-info}} に配置して {{Pkg|exiv2}} パッケージをインストールしてください:

{{hc|~/.config/sxiv/exec/image-info|<nowiki>
#!/bin/sh

# Example for ~/.config/sxiv/exec/image-info
# Called by sxiv(1) whenever an image gets loaded,
# with the name of the image file as its first argument.
# The output is displayed in sxiv's status bar.

s=" | " # field separator

filename=$(basename "$1")
filesize=$(du -Hh "$1" | cut -f 1)

geometry=$(identify -format '%wx%h' "$1")

tags=$(exiv2 -q pr -pi "$1" | awk '$1~"Keywords" { printf("%s,", $4); }')
tags=${tags%,}

echo "${filesize}${s}${geometry}${tags:+$s}${tags}${s}${filename}"
</nowiki>}}

== 参照 ==

* Arch Linux の [https://bbs.archlinux.org/viewtopic.php?id=112643 フォーラムスレッド]。
* [[wikipedia:Keyboard_layout#B.C3.89PO|bépo]] キーボードレイアウト (フランス語話者のための [[Dvorak]] 派生キーボードレイアウト) 用の Sxiv: [https://bepo.fr/wiki/Vim#Visionneuse_d.27image_Sxiv Sxiv bépo]

XDG MIME Applications

2025-06-29T07:24:39Z

Zkn: /* 関連付けの欠落 */ 内部リンクを修正

[[カテゴリ:Freedesktop.org]]
[[en:XDG MIME Applications]]
[[ru:XDG MIME Applications]]
{{Related articles start}}
{{Related|デスクトップエントリ}}
{{Related|デスクトップ環境}}
{{Related|ウィンドウマネージャ}}
{{Related|デフォルトアプリケーション}}
{{Related|xdg-utils}}
{{Related articles end}}
[https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html XDG MIME Applications specification] は [[デフォルトアプリケーション]] を用意するために [[#共有 MIME データベース|共有 MIME データベース]] と [[デスクトップエントリ]] から成り立っています。

# XDG MIME Applications はどの MIME type を扱うことができるかを [[デスクトップエントリ]] を使って定義します。
# {{Pkg|desktop-file-utils}} は [[pacman フック]] であり、デスクトップエントリが扱う MIME type のデータベースを構築します。詳細は {{man|1|update-desktop-database}} を見て下さい。
# XDG MIME Applications は {{ic|/usr/share/mime/packages/}} に XML ファイルを置くことにより新しい MIME タイプをインストールできます。
# {{Pkg|shared-mime-info}} は Shared MIME-Info database cache を構築するために [[pacman フック]] を登録します。詳しくは {{man|1|update-mime-database}} を参照して下さい。
# [[デスクトップ環境]] とユーザーは [[#mimeapps.list|mimeapps.list]] ファイルを通じて特定の MIME タイプに紐付くデフォルトアプリケーションの変更や設定、削除ができます。

== 共有 MIME データベース ==

[https://specifications.freedesktop.org/shared-mime-info-spec/shared-mime-info-spec-latest.html XDG Shared MIME-info Database specification] 仕様は、デスクトップ環境間での MIME データベースの共有を容易にし、アプリケーションがシステム全体で新しい MIME タイプを簡単に登録できるようにするものです。

データベースは、{{ic|/usr/share/mime/packages/}} にあるパッケージによってインストールされた XML ファイルから {{Pkg|shared-mime-info}} のツールを使って構築されます。

{{ic|/usr/share/mime/}} にあるファイルを直接編集してはいけませんが、 {{ic|~/.local/share/mime/}} ツリーにあるデータベースをユーザーごとに管理することは可能です。

「URI スキームの処理 [...] は、{{ic|x-scheme-handler/foo}} MIME タイプを処理するアプリケーションを通して処理されます（foo は問題の URI スキーム）」[https://specifications.freedesktop.org/shared-mime-info-spec/shared-mime-info-spec-latest.html#idm140625828587776]

=== 新しい MIME タイプ ===

この例では、新しい MIME タイプ {{ic|application/x-foobar}} を定義し、''.foo'' で終わる名前を持つすべてのファイルに割り当てています。単に次のようなファイルを作成します。

{{hc|~/.local/share/mime/packages/application-x-foobar.xml|2=
<?xml version="1.0" encoding="UTF-8"?>
<nowiki><mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info"></nowiki>
'''<mime-type type="application/x-foobar">'''
<comment>foo file</comment>
<icon name="application-x-foobar"/>
<glob-deleteall/>
'''<glob pattern="*.foo"/>'''
</mime-type>
</mime-info>
}}

次に、MIME データベースを更新します。

$ update-mime-database ~/.local/share/mime

もちろん、デスクトップエントリが MIME タイプに関連付けられていない場合、これは効果がありません。新しい[[デスクトップエントリ]]を作成するか、[[#mimeapps.list|mimeapps.list]] を変更する必要がある場合があります。

== mimeapps.list ==

[https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-1.0.html XDG 標準]は、デスクトップ環境を設定するための最も一般的な規格です。各 MIME タイプのデフォルトのアプリケーションは、{{ic|mimeapps.list}} ファイルに格納されています。これらは以下の順序で検索され、先に関連づけられたものが後に関連づけられたものよりも優先されます。

{| class="wikitable"
! Path !! Usage
|-
| {{ic|~/.config/mimeapps.list}} || ユーザーオーバーライド
|-
| {{ic|/etc/xdg/mimeapps.list}} || システム全体のオーバーライド
|-
| {{ic|~/.local/share/applications/mimeapps.list}} || ('''非推奨''') ユーザーオーバーライド
|-
| {{ic|/usr/local/share/applications/mimeapps.list}} {{ic|/usr/share/applications/mimeapps.list}} || ディストリビューション提供のデフォルト
|}

さらに、[[デスクトップ環境]]固有のデフォルトアプリケーションを {{ic|''desktop''-mimeapps.list}} というファイルに定義することができます。{{ic|''desktop''}} は ({{ic|XDG_CURRENT_DESKTOP}} 環境変数から) デスクトップ環境の名前です。例えば、/etc/xdg/xfce-mimeapps.list は、Xfce のシステム全体のデフォルトアプリケーションのオーバーライドを定義します。これらのデスクトップ固有のオーバーライドは、対応する非デスクトップ固有のファイルより優先されます。例えば、{{ic|/etc/xdg/xfce-mimeapps.list}} は {{ic|/etc/xdg/mimeapps.list}} より優先されますが、 {{ic|~/.config/mimeapps.list}} によって上書きされます。

{{Tip|非推奨ですが、{{ic|~/.local/share/applications/mimeapps.list}} を読み書きするアプリケーションはまだあります。メンテナンスを簡単にするために、{{ic|~/.config/mimeapps.list}} にシンボリックリンクしておくといいでしょう。}}

{{Note|これらの場所には {{ic|defaults.list}} という名前のファイルがある場合もあります。このファイルは {{ic|mimeapps.list}} と似ていますが、デフォルトのアプリケーションのみをリストアップしています(追加/削除された関連付けはリストアップされません)。現在では非推奨となっており、手動で {{ic|mimeapps.list}} にマージする必要があります。}}

スキャンされたすべてのファイルを検出するには、環境変数 ''XDG_UTILS_DEBUG_LEVEL=2'' を設定してデバッグモードを有効にすることができます。例えば、{{ic|''xdg-mime query default <type>''}} コマンドは、MIME 情報を検索する各設定ファイルを表示します。

==== 書式 ====

以下の例を考えてみましょう:

{{hc|mimeapps.list|2=
[Added Associations]
image/jpeg=bar.desktop;baz.desktop
video/H264=bar.desktop
[Removed Associations]
video/H264=baz.desktop
[Default Applications]
image/jpeg=foo.desktop}}

各セクションは、1 つ以上のデスクトップエントリを MIME タイプに割り当てます。

* '''Added Associations''' はアプリケーションがその MIME タイプを開くことをサポートしていることを示します。たとえば、{{ic|bar.desktop}} と {{ic|baz.desktop}} は、JPEG 画像を開くことができます。これは、ファイルブラウザでファイルを右クリックしたときに表示されるアプリケーションのリストに影響する場合があります。
* '''Removed Associations''' はアプリケーションがその MIME タイプをサポートして''いない''ことを示します。たとえば、{{ic|baz.desktop}} は H.264 ビデオを開くことができません。
* '''Default Applications''' はその MIME タイプを開くためのアプリケーションをデフォルトで選択する必要があることを示します。たとえば、JPEG 画像は {{ic|foo.desktop}} で開く必要があります。これは、アプリケーションと MIME タイプの間に暗黙のうちに関連付けを行います。複数のアプリケーションがある場合は、順番に試行されます。

各セクションはオプションであり、不要な場合は省略可能です。

== ユーティリティー ==

[[#mimeapps.list|mimeapps.list]] と[[#共有 MIME データベース|共有 MIME データベース]]を直接編集することでデフォルトのアプリケーションと MIME タイプを設定することは可能ですが、このプロセスを簡略化する多くのツールがあります。これらのツールはまた、アプリケーションが自分自身で MIME タイプ標準を実装しようとするよりも、これらのツールにファイルのオープンを委ねるかもしれないので、重要である。

[[デスクトップ環境]]を使っているならば、まずその環境が独自のユーティリティを提供しているかどうかを確認すべきです。それは、これらの選択肢よりも優先されるべきものです。

公式の [[xdg-utils]] には、XDG 標準に従って MIME タイプとデフォルトのアプリケーションを管理するためのツール ([[xdg-utils#xdg-mime|xdg-mime]]) が含まれています。最も重要なのは、多くのアプリケーションがデフォルトのアプリケーションでファイルを開くために使用する [[xdg-open]] が提供されていることです。

=== lsdesktopf ===

{{AUR|lsdesktopf}} は、MIME データベースとデスクトップ MIME エントリを検索するいくつかの方法を提供します。

例えば、システムの ''.desktop'' ファイルで MIME タイプが {{ic|video}} の全ての MIME 拡張を見るには {{ic|lsdesktopf --gm -gx video}} を、XML データベースファイルを検索するには {{ic|lsdesktopf --gdx -gx video}} を使ってください。特定の MIME タイプに関連する ''.desktop'' ファイルの数とその概要を知るには、{{ic|lsdesktopf --gen-mimeapps}} を使用します。XML データベースファイルのすべてのファイル名拡張子を見るには、{{ic|lsdesktopf --gdx -gfx}} を使用します。

=== selectdefaultapplication ===

{{AUR|selectdefaultapplication-git}} は様々な mimetypes をサポートするアプリケーションをリストアップし、({{ic|mimeapps.list}} を修正することで) サポートする mimetypes の全てまたは一部をデフォルトとして素早く設定できる GUI アプリケーションです。

「読みやすい」名前とファイル拡張子も表示されるので、mimetypes の名前を覚えておく必要はありません。

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

ファイルが目的の既定のアプリケーションで開かれていない場合は、いくつかの原因が考えられます。ケースごとに確認する必要があるかもしれません。

=== デスクトップエントリの欠落 ===

アプリケーションを MIME タイプに関連付けるには、[[デスクトップエントリ]]が必要です。そのようなエントリが存在し、アプリケーションでファイルを（手動で）開くことができることを確認してください。

=== 関連付けの欠落 ===

アプリケーションのデスクトップエントリがその {{ic|MimeType}} キーの下で MIME タイプを指定しない場合、そのタイプを開くためにアプリケーションが必要なときに考慮されません。[[#mimeapps.list|mimeapps.list]] を編集して、.desktop ファイルと MIME タイプの間に関連付けを追加します。

=== デフォルトでないアプリケーション ===

デスクトップエントリが MIME タイプと関連付けられている場合、単にデフォルトとして設定されていないだけかもしれません。[[#mimeapps.list|mimeapps.list]] を編集してデフォルトの関連付けを設定してください。

=== 非標準の関連付け ===

アプリケーションは、XDG 標準を無視したり、部分的にしか実装しなかったりすることができます。{{ic|~/.local/share/applications/mimeapps.list}} や {{ic|~/.local/share/applications/defaults.list}} などの非推奨のファイルが使用されていないかどうか確認してください。他のアプリケーション（Web ブラウザやファイルマネージャなど）からファイルを開こうとしている場合は、そのアプリケーションにデフォルトのアプリケーションを選択する独自の方法があるかどうかを確認します。

=== アプリケーションの起動に影響を与える .desktop ファイル内の変数 ===

仕様をサポートするデスクトップ環境とファイルマネージャは、''.desktop'' ファイルの定義に従ってプログラムを起動します。[[デスクトップエントリ#アプリケーションエントリ]]を参照してください。

通常、パッケージ化された ''.desktop'' ファイルの設定は必要ありませんが、バグがないとは限りません。関連付けに使用する ''.desktop'' ファイルの {{ic|MimeType}} 変数に必要な MIME タイプの記述があるアプリケーションでも、正しく起動しない、全く起動しない、ファイルを開かずに起動するなどの不具合が発生することがあります。

これは、例えば、{{ic|Exec}} 変数に、ファイルを開く方法や、アプリケーションをメニューに表示する方法などに必要な内部オプションがない場合に起こるかもしれません。Exec 変数は通常 {{ic|%}} で始まります。現在サポートされているオプションについては、[https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables exec-variables] を参照してください。

次の表は、MIME タイプが関連付けられている場合、アプリケーションの起動方法に影響を与える ''.desktop'' ファイルの主な変数エントリをリストアップしたものです。

{| class="wikitable"
! 変数名 !! 内容例1 !! 内容例2 !! 説明
|-
| DBusActivatable || DBusActivatable=true || DBusActivatable=false || アプリケーションは [https://www.freedesktop.org/wiki/Software/dbus/ D-Bus] とやり取りします。[https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#dbus D-Bus] 設定も参照してください。
|-
| MimeType || MimeType=application/vnd.oasis.opendocument.text || MimeType=application/vnd.sun.xml.math || アプリケーションがサポートする MIME タイプのリスト
|-
| StartupWMClass || StartupWMClass=google-chrome || StartupWMClass=xpad || ウィンドウを所有アプリケーションに関連付ける
|-
| Terminal || Terminal=true || Terminal=false || デフォルトのターミナルで起動
|}

{{TranslationStatus|XDG MIME Applications|2022-09-14|731706}}

TeX Live

2023-07-02T07:56:58Z

Zkn: texlive-langcjkの説明を修正(英語版の説明と離れるが、本来こちらが正しいはず)

[[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 には以下が含まれています:
* 多くの TeX エンジン。例えば:
** [[Wikipedia:ja:pdfTeX|pdfTeX]]
**[[Wikipedia:ja:XeTeX|XeTeX]]
**[[Wikipedia:ja:LuaTeX|LuaTeX]]
* 基本的なマクロパッケージ (TeX 用語では ''フォーマット'' と呼ばれます)。例えば:
** [[Wikipedia:ja:LaTeX|LaTeX]]
** [[Wikipedia:ja:ConTeXt|ConTeXt]]
* ユーザによって作成された多くパッケージ

== Arch の TeX Live パッケージとネイティブな TeX Live との違い ==

TeX Live をインストールする方法は複数存在します。TeX Live のスナップショットは Arch Linux のパッケージリポジトリで利用可能ですが (以下を参照)、ほとんどの場合、そのスナップショットは1年に1度しかアップデートされません。対して、TeX Live 自体はローリングリリースなディストリビューションであり、ユーザは1年に1度アップグレードする必要があるというモデルに基づいてはいますが、個々のパッケージのアップグレードは日単位で利用できます。

Arch Linux のリポジトリでパッケージングされている TeX Live のスナップショットは、ほとんどのユーザにとって問題ないはずです。使用目的が単に他人のドキュメントをコンパイルすることである場合は特にです。逆に、使用目的が自分でドキュメントを作成することであるならば、''ネイティブな'' TeX Live をインストールするのが最も良い選択である可能性もあります。

ネイティブで最新の TeX Live をインストールすることには、最新の機能やバグフィックス、関連するドキュメントを入手できるという利点もあります。ネイティブな TeX Live をインストールせずに個々のパッケージをアップグレードしたりインストールしたりすることは可能で''ある''ものの ({{ic|TEXMFLOCAL}} と {{ic|TEXMFHOME}} を参照)、これには注意が必要です。というのも、関連する全てのパッケージのバージョンが互いに互換性があることを確認する必要があるからです。

ネイティブな TeX Live とは対照的に、Arch Linux のリポジトリにある TeX Live パッケージにはドキュメントが含まれない傾向にあります。CTAN からのドキュメントは TeX パッケージの最新バージョン用のものしか入手できないので、これは問題となります。

{{Note|複数の TeX Live インストールを単一のシステムで共存させることは可能です。}}

=== ネイティブな TeX Live ===

==== インストール ====

[https://tug.org/texlive/quickinstall.html quickinstall] ドキュメントを参照してください。必要であれば、[https://tug.org/texlive/doc/texlive-en/texlive-en.html 完全な]ドキュメント ([https://tug.org/texlive/doc/texlive-ja/ 日本語版]) も参照してください。作業は以下のように要約されます:

# netinstall [https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz アーカイブ]をダウンロードする
# アーカイブを展開し、新しく作成されたディレクトリへ移動する
# インストールスクリプトを実行する ({{ic|perl ./install-tl}})。これで、テキストインターフェイスのインタラクティブなインストール手順が始まります
## 1つ、または複数のインストールパスを設定する
## 任意で、TeX Live によって提供されているパッケージ ''コレクション'' のサブセットを選択する
## 任意で、A4 ではなくレター用紙サイズをデフォルトとして選択する
## ダウンロードが終わるのを待つ
# インストールスクリプトの実行が終わったら、TeX Live のインストール場所をシステムの実行ファイルパスとドキュメンテーションパス ({{ic|PATH}}、{{ic|MANPATH}}、{{ic|INFOPATH}}) に追加する必要があります。インストールスクリプトは、追加すべきパスを終了前に出力してくれます。

==== アップデート ====

[https://tug.org/texlive/doc/tlmgr.html tlmgr] ドキュメントを参照してください。{{ic|tlmgr update --all}} を実行すると、インストール中に選択したコレクションの全パッケージをアップグレードします。また、インストール済みの TeX Live コレクションに新しく追加されたパッケージもインストールされます。

年に1度、TeX Live の新しいリリースがあると、{{ic|tlmgr update --all}} は失敗します。その場合、TeX Live を新しくインストールする必要があります。

=== Arch の TeX Live パッケージ ===

{{Accuracy|{{Pkg|texlive-core}} は最近 {{Pkg|texlive-basic}} に置き換えられました。また、{{Pkg|texlive-meta}} という新しいメタパッケージも存在します。}}

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

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

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

==== tllocalmgr ====

{{Warning|tllocalmgr がもはや機能していないと報告されています。[[https://bbs.archlinux.org/viewtopic.php?id=286197]] を参照してください。}}

{{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] スクリプトを提供しますが、これは壊れています ({{Bug|74404}})。以下で説明されているように修正するか、あるいは代わりに [[#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'' は、事前に定義された環境変数ではなく、この記事の以下で定義されたものです。このプレフィックスは正しい値に置き換えてください。

また、コマンドラインから {{ic|1=sudo sed -i 's/\$Master = "\$Master\/..\/..";/\$Master = "\$Master\/..\/..\/..";/' "$TEXMFDIST/scripts/texlive/tlmgr.pl"}} を実行することでも可能です。

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

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

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

$ tlmgr init-usertree

自由に[https://www.ctan.org/mirrors ミラー]を設定してください。ミラーのパスの末尾に {{ic|/systems/texlive/tlnet}} を追加する必要があります。例えば:

<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 を直接生成します)

== 使用方法 ==

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

* [[Wikibooks:LaTeX]] ([[Wikibooks:Ja:TeX/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]

ドキュメントの作成に [[アプリケーション一覧/ドキュメント#TeX editors|TeX エディタ]]を使うこともできます。

=== ドキュメントをコンパイルするための高レベルなラッパー ===

ほとんどの場合、{{man|1|pdflatex}} のようなものを直接呼び出すより、{{man|1|latexmk}} や {{man|1|arara}} といった高レベルなツールを使うほうが合理的です。その理由は主に、低レベルなツールは単一のドキュメントを完全にコンパイルするのに通常複数回実行する必要があるからです。

=== 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 のデフォルト 1) !! その変数を使用するもの [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}} を実行してユーザのデータベースをアップデートしてください。}}

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

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

{{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

== 代替 ==

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

== 参照 ==

* [https://tug.org/texlive/doc.html TeX Live ドキュメント]
* Q&A サイト
** [https://tex.stackexchange.com/ TeX - LaTeX Stack Exchange]
** [https://topanswers.xyz/tex TopTeX (TopAnswers の TeX サイト)]
* [http://detexify.kirelabs.org/ Detexify LaTeX handwritten symbol recognition]

{{TranslationStatus|TeX Live|2023-06-19|781427}}

TeX Live

2023-07-02T07:55:31Z

Zkn: texlive-langjapaneseへの言及を追加

[[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 には以下が含まれています:
* 多くの TeX エンジン。例えば:
** [[Wikipedia:ja:pdfTeX|pdfTeX]]
**[[Wikipedia:ja:XeTeX|XeTeX]]
**[[Wikipedia:ja:LuaTeX|LuaTeX]]
* 基本的なマクロパッケージ (TeX 用語では ''フォーマット'' と呼ばれます)。例えば:
** [[Wikipedia:ja:LaTeX|LaTeX]]
** [[Wikipedia:ja:ConTeXt|ConTeXt]]
* ユーザによって作成された多くパッケージ

== Arch の TeX Live パッケージとネイティブな TeX Live との違い ==

TeX Live をインストールする方法は複数存在します。TeX Live のスナップショットは Arch Linux のパッケージリポジトリで利用可能ですが (以下を参照)、ほとんどの場合、そのスナップショットは1年に1度しかアップデートされません。対して、TeX Live 自体はローリングリリースなディストリビューションであり、ユーザは1年に1度アップグレードする必要があるというモデルに基づいてはいますが、個々のパッケージのアップグレードは日単位で利用できます。

Arch Linux のリポジトリでパッケージングされている TeX Live のスナップショットは、ほとんどのユーザにとって問題ないはずです。使用目的が単に他人のドキュメントをコンパイルすることである場合は特にです。逆に、使用目的が自分でドキュメントを作成することであるならば、''ネイティブな'' TeX Live をインストールするのが最も良い選択である可能性もあります。

ネイティブで最新の TeX Live をインストールすることには、最新の機能やバグフィックス、関連するドキュメントを入手できるという利点もあります。ネイティブな TeX Live をインストールせずに個々のパッケージをアップグレードしたりインストールしたりすることは可能で''ある''ものの ({{ic|TEXMFLOCAL}} と {{ic|TEXMFHOME}} を参照)、これには注意が必要です。というのも、関連する全てのパッケージのバージョンが互いに互換性があることを確認する必要があるからです。

ネイティブな TeX Live とは対照的に、Arch Linux のリポジトリにある TeX Live パッケージにはドキュメントが含まれない傾向にあります。CTAN からのドキュメントは TeX パッケージの最新バージョン用のものしか入手できないので、これは問題となります。

{{Note|複数の TeX Live インストールを単一のシステムで共存させることは可能です。}}

=== ネイティブな TeX Live ===

==== インストール ====

[https://tug.org/texlive/quickinstall.html quickinstall] ドキュメントを参照してください。必要であれば、[https://tug.org/texlive/doc/texlive-en/texlive-en.html 完全な]ドキュメント ([https://tug.org/texlive/doc/texlive-ja/ 日本語版]) も参照してください。作業は以下のように要約されます:

# netinstall [https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz アーカイブ]をダウンロードする
# アーカイブを展開し、新しく作成されたディレクトリへ移動する
# インストールスクリプトを実行する ({{ic|perl ./install-tl}})。これで、テキストインターフェイスのインタラクティブなインストール手順が始まります
## 1つ、または複数のインストールパスを設定する
## 任意で、TeX Live によって提供されているパッケージ ''コレクション'' のサブセットを選択する
## 任意で、A4 ではなくレター用紙サイズをデフォルトとして選択する
## ダウンロードが終わるのを待つ
# インストールスクリプトの実行が終わったら、TeX Live のインストール場所をシステムの実行ファイルパスとドキュメンテーションパス ({{ic|PATH}}、{{ic|MANPATH}}、{{ic|INFOPATH}}) に追加する必要があります。インストールスクリプトは、追加すべきパスを終了前に出力してくれます。

==== アップデート ====

[https://tug.org/texlive/doc/tlmgr.html tlmgr] ドキュメントを参照してください。{{ic|tlmgr update --all}} を実行すると、インストール中に選択したコレクションの全パッケージをアップグレードします。また、インストール済みの TeX Live コレクションに新しく追加されたパッケージもインストールされます。

年に1度、TeX Live の新しいリリースがあると、{{ic|tlmgr update --all}} は失敗します。その場合、TeX Live を新しくインストールする必要があります。

=== Arch の TeX Live パッケージ ===

{{Accuracy|{{Pkg|texlive-core}} は最近 {{Pkg|texlive-basic}} に置き換えられました。また、{{Pkg|texlive-meta}} という新しいメタパッケージも存在します。}}

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

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

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

==== tllocalmgr ====

{{Warning|tllocalmgr がもはや機能していないと報告されています。[[https://bbs.archlinux.org/viewtopic.php?id=286197]] を参照してください。}}

{{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] スクリプトを提供しますが、これは壊れています ({{Bug|74404}})。以下で説明されているように修正するか、あるいは代わりに [[#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'' は、事前に定義された環境変数ではなく、この記事の以下で定義されたものです。このプレフィックスは正しい値に置き換えてください。

また、コマンドラインから {{ic|1=sudo sed -i 's/\$Master = "\$Master\/..\/..";/\$Master = "\$Master\/..\/..\/..";/' "$TEXMFDIST/scripts/texlive/tlmgr.pl"}} を実行することでも可能です。

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

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

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

$ tlmgr init-usertree

自由に[https://www.ctan.org/mirrors ミラー]を設定してください。ミラーのパスの末尾に {{ic|/systems/texlive/tlnet}} を追加する必要があります。例えば:

<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 を直接生成します)

== 使用方法 ==

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

* [[Wikibooks:LaTeX]] ([[Wikibooks:Ja:TeX/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]

ドキュメントの作成に [[アプリケーション一覧/ドキュメント#TeX editors|TeX エディタ]]を使うこともできます。

=== ドキュメントをコンパイルするための高レベルなラッパー ===

ほとんどの場合、{{man|1|pdflatex}} のようなものを直接呼び出すより、{{man|1|latexmk}} や {{man|1|arara}} といった高レベルなツールを使うほうが合理的です。その理由は主に、低レベルなツールは単一のドキュメントを完全にコンパイルするのに通常複数回実行する必要があるからです。

=== 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 のデフォルト 1) !! その変数を使用するもの [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}} を実行してユーザのデータベースをアップデートしてください。}}

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

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

{{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

== 代替 ==

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

== 参照 ==

* [https://tug.org/texlive/doc.html TeX Live ドキュメント]
* Q&A サイト
** [https://tex.stackexchange.com/ TeX - LaTeX Stack Exchange]
** [https://topanswers.xyz/tex TopTeX (TopAnswers の TeX サイト)]
* [http://detexify.kirelabs.org/ Detexify LaTeX handwritten symbol recognition]

{{TranslationStatus|TeX Live|2023-06-19|781427}}