TeX Live の拡張

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

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

TeX Live イメージは更新がまれにしか行われません。Server Pro をアップグレードする際にはカスタムイメージを再ビルドすることを推奨します。

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

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

次のコマンドを使用できます： tlmgr のようなコマンド、例えば tlmgr install および tlmgr update を使用して 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
# 例: 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/

# フォント情報キャッシュを再構築
RUN fc-cache

Server Pro を新しいイメージを使うように構成する

次の名前を使用してください： ghcr.io/ayaka-notes/texlive-full とカスタムタグを使って新しいイメージをビルドします。例えば：

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

これで Server Pro を新しい 2023.1-custom イメージを使うように構成できます。以下の TEX_LIVE_DOCKER_IMAGE および ALL_TEX_LIVE_DOCKER_IMAGES 環境変数を更新してください：

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 は必要なときにまだ利用可能です。