TeX Live のアップグレード

帯域幅を節約するため、Overleaf Community Edition と Overleaf Pro のイメージには最小限のインストールのみが含まれています： TeX Live。追加のパッケージをインストールしたり、完全な TeX Live インストールにアップグレードしたりするには、次のコマンドを使用します： tlmgr コマンドは sharelatex container.

以下の手順は のみ Community Edition のインストールに適用されます。Overleaf Pro ユーザーには、を有効にすることを強く推奨します サンドボックス化されたコンパイル 。これにより、overleaf.com で使用されているのと同じ TeX Live イメージへのアクセスがユーザーに提供され、 overleaf.com に加えて、プロジェクトのコンパイル間の分離が提供され、セキュリティが向上します。

sharelatex コンテナに入る

コンテナ内でシェルを開始するには、 sharelatex コンテナで次を実行します

bin/shell

次のようなプロンプトが表示されます：

root@309b192d4030:/#

以下の手順では、コンテナ内にいるものと仮定します。

現在の TeX Live バージョンの確認

TeX Live は毎年 4 月頃にリリースされます。を使用する手順は、現在のリリースか古いリリースかによって異なります。 tlmgr どのバージョンの TeX Live を実行しているかは、次のコマンドで確認できます： tlmgr --version。例えば、このインストールでは TeX Live 2021 を実行しています：

# tlmgr --version
tlmgr revision 59291 (2021-05-21 05:14:40 +0200)
tlmgr using installation: /usr/local/texlive/2021
TeX Live (https://tug.org/texlive) version 2021

TeX Live の現在のリリースは次で確認できます： TeX Live ホームページ.

古い TeX Live バージョンを実行している場合は、2 つのオプションがあります。TeX Live のリリース直後に新しい Overleaf Docker イメージが通常リリースされるため、それを待ってデプロイを bin/upgrade スクリプトを使ってアップグレードするか、古い TeX Live リリースを維持したい場合は、まず tlmgr に古いリポジトリを使用するように指示する必要があります。その手順は ここ.

に記載されています。

パッケージのインストール sharelatex 完全な TeX Live インストールを行うには、コンテナ内で次のコマンドを実行します：

tlmgr install scheme-full

個別のパッケージを手動でインストールすることもできます：

tlmgr install tikzlings tikzmarmots tikzducks

以降の 3.3.0 リリースからは、 tlmgr path add の実行が 必要 になります。これは、毎回 tlmgr installを使用した後に、すべてのバイナリを正しくシステムパスにシンボリックリンクするために必要です。

さらに多くのコマンドが利用可能です。詳細は次で確認してください：

tlmgr help

終了したら、次を入力してください： exit または Control-D を押してシェルを終了します。

変更内容の保存

先ほど行った変更はコンテナを変更しましたが、それらは一時的なものです -- たとえば設定の更新などで Docker Compose がコンテナを再作成すると失われます。 sharelatex これらを永続化するには、次を使用します：

docker commit 変更を新しい Docker イメージとして保存するには： cat config/version #5.2.1

docker commit sharelatex sharelatex/sharelatex:5.2.1-with-texlive-full
echo 5.2.1-with-texlive-full > config/version
変更をコミットしたら、

config/version をそれに応じて更新してください。次に、を実行して、 コンテナを再作成します。 bin/upこれらの手順は、 sharelatex container.

新しい Overleaf バージョンに アップグレード するたびに繰り返す必要があります。