TeX Live の拡張

サポートされているコンパイル環境向けに、パッケージやフォントを追加して TeX Live Docker イメージを拡張します。

新しい Dockerfile を使って既存の TeX Live イメージを拡張し、アプリケーションがその新しいイメージを使用するように設定することができます。

ここでは新しいパッケージやフォントをインストールするためのガイドラインを紹介しますが、カスタムイメージの設定はサポート対象外です。

TeX Live イメージの更新頻度は高くありません。Server Pro をアップグレードする際には、カスタムイメージを再ビルドすることをおすすめします。

以下のセクションは Server Pro と Sandboxed Compiles にのみ適用されます。

​

新しいパッケージのインストールと更新

次の例のように、tlmgr install や tlmgr update などの tlmgr コマンドを使って TeX Live パッケージを管理できます。

FROM ghcr.io/ayaka-notes/texlive-full:2023.1

RUN tlmgr update --force ebproof

​

古い TeX Live イメージで tlmgr を使用する

デフォルトでは、tlmgr は最新の TeX Live リリースからリソースをダウンロードします。古い TeX Live イメージにパッチを当てる場合は、ダウンロード先を対応するアーカイブに切り替える必要があります。アーカイブのミラーについては https://www.tug.org/historic/ の一覧を参照してください。

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

RUN tlmgr option repository <MIRROR>/systems/texlive/<YEAR>/tlnet-final
# e.g. RUN tlmgr option repository ftp://tug.org/historic/systems/texlive/2022/tlnet-final

RUN tlmgr update --force ebproof

​

新しいフォントのインストール

TeX Live ディストリビューションに新しいフォントをインストールする手順はいくつかあり、カスタムフォントのインストールには複数のステップが必要になる場合があります。まずは TeX Live の公式ドキュメントにある TeX フォントのインストール手順を確認するとよいでしょう。

次の Dockerfile は、既存の TeX Live 2022 イメージに TrueType フォントをインストールする例です。

FROM ghcr.io/ayaka-notes/texlive-full:2022.1

COPY ./myfonts/*.ttf /usr/share/fonts/truetype/myfont/

# rebuild font information cache
RUN fc-cache

​

新しいイメージを使用するように Server Pro を設定する

次のように、ghcr.io/ayaka-notes/texlive-full という名前とカスタムタグを使って新しいイメージをビルドします。

docker build -t ghcr.io/ayaka-notes/texlive-full:2023.1-custom

これで、環境変数 TEX_LIVE_DOCKER_IMAGE と ALL_TEX_LIVE_DOCKER_IMAGES を更新して、新しい 2023.1-custom イメージを使用するように Server Pro を設定できます。

TEX_LIVE_DOCKER_IMAGE: "ghcr.io/ayaka-notes/texlive-full:2023.1-custom"
ALL_TEX_LIVE_DOCKER_IMAGES: "ghcr.io/ayaka-notes/texlive-full:2023.1,ghcr.io/ayaka-notes/texlive-full:2023.1-custom"

上の例では、新しいプロジェクトはデフォルトで新しい 2023.1-custom イメージを使用するように設定され、必要に応じて 2023.1 も引き続き利用できます。