メインコンテンツへスキップ
新しい Dockerfile を使って既存の TeX Live イメージを拡張し、アプリケーションがその新しいイメージを使用するように設定することができます。 ここでは新しいパッケージやフォントをインストールするためのガイドラインを紹介します。 TeX Live イメージの更新頻度は高くありません。Ayakaleaf Pro をアップグレードする際には、カスタムイメージを再ビルドすることをおすすめします。
以下のセクションは Sandboxed Compiles にのみ適用されます。

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

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

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

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

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

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

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

次のように、ghcr.io/ayaka-notes/texlive-full という名前とカスタムタグを使って新しいイメージをビルドします。
これで、環境変数 TEX_LIVE_DOCKER_IMAGE、ALL_TEX_LIVE_DOCKER_IMAGES、ALL_TEX_LIVE_DOCKER_IMAGE_NAMES を更新して(名前は省略可能で、イメージの順序に対応します)、新しい 2023.1-custom イメージを使用するように Ayakaleaf Pro を設定できます。
上の例では、新しいプロジェクトはデフォルトで新しい 2023.1-custom イメージを使用するように設定され、必要に応じて 2023.1 も引き続き利用できます。 カスタムイメージはホスト上にのみ存在するため、bin/up で pull することはできません。config/overleaf.rc で SIBLING_CONTAINERS_PULL=false を設定し(その他のイメージは docker pull で自分で pull してください)、bin/up -d を実行して新しい設定を適用します。

Q&A

回答: texlive-full イメージであれば必要ありません。これらのイメージには、Fandol フォントを含む TeX Live の中国語パッケージ(ctex、xeCJK)と、Noto CJK フォント(たとえば Noto Serif CJK SC)が含まれています。エディターの設定でプロジェクトのコンパイラーを XeLaTeX に設定してからコンパイルしてください。例:
Fandol の代わりに Noto を使用するには、\setCJKmainfont{Noto Serif CJK SC} を追加します。latexmkrc は不要です。その他のフォントについては、新しいフォントのインストールに示すようにカスタムイメージをビルドしてください。
最終更新日 2026年11月2日