macOS に TexLive 2020 をインストールする - pyopyopyo - Linuxとかプログラミングの覚え書き -

macOS の TeX環境を texlive2020 に更新したので手順をまとめます．

この記事は以下のエントリを macOS と Tex Live 2020 に合わせて更新・加筆したものです．

BasicTeX

パッケージはMacTeXのサブセット版である BasicTeX を使いました．

MacTeXは全パッケージをインストールすると 6GB程度のディスク容量を消費します (Tex live 2020の場合)．

一方サブセット版である BasicTeX は最低限のパッケージしかインストールしません．必要な容量は 277MB程度です．(TexLive 2020の場合)

不足パッケージは後から簡単にインストールできるので実用上の問題もありません

ダウンロード&インストール

https://tug.org/mactex/morepackages.html から mactex-basictex-20200407.pkg をダウンロードします

サイズはたったの83MBですのでダウンロードはすぐに終わるはずです．

これをインストールします

なおMacTeXは

2020 通常版 /usr/local/texlive/2020
2020 BasicTeX /usr/local/texlive/2020basic
2019 BasicTeX /usr/local/texlive/2019basic

という感じでディレクトリを分けてファイルを配置するので，異なるバージョンのTeX環境を混在できます．

デフォルトのTeX環境の選択は，"TeX Distribution"というアプリで行います．
（メニューの”システム環境設定"にアイコンがあります．Spotlight検索で TeX Distribution でも起動できます）
このアプリは

/Library/TeX/texbin
/Library/TeX/Root
/Library/TeX/Local
/Library/TeX/Documentation

というシンボリックリンクを管理していて，これらリンクでデフォルトのtex環境を選択する仕組みになっています．

たとえば mactex-basic.pkg をインストールすると，/Library/TeX/texbin のリンク先は

$ readlink -f  /Library/TeX/texbin
/usr/local/texlive/2020basic/bin/x86_64-darwin

という感じで，/usr/local/texlive/2020basic/bin/x86_64-darwin になります

初期設定

basictex　をインストールしたら，必要なパッケージを追加インストールします

方法は二つ

Tex Live ユーティリティーというGUIを使う方法
CUIでtlmgrコマンドを使う方法

あります．

ここでは，説明が簡単，という理由でCUIを使います．

まずターミナルを起動します．そして以下のコマンドを実行します．

$ sudo tlmgr update --self  --all

オプションの意味はそれぞれ次のようになります．

--self tlmgr 自身を更新する
--all インストール済みパッケージを更新する

最後に，個人的に良く使うパッケージを追加インストールします．

$ sudo tlmgr install  type1cm subfigure dvipdfmx multirow xstring logreq biblatex latexmk  biber pxjahyper

日本語環境の設定

日本語の設定を行います．

用紙サイズの設定

デフォルトをA4サイズにします

$ sudo tlmgr paper a4

日本語用パッケージのインストール

メタパッケージ collection-langjapanese をインストールすると，日本語関連のパッケージが一括でインストールできます．しかし collection-langjapaneseをインストールすると日本語フォントが大量にインストールされ，フォントだけで700MBほどディスクを消費します

macOSのヒラギノフォントを利用する場合，この700MBは無駄になります．

そこで collection-langjapanese はインストールせずに，必要なパッケージだけをインストールする方針でセットアップを行います．

日本語を扱う際，最低限必要なパッケージは

ptex platex jsclasses

でしょう．今回はとりあえずこれだけ入れて，後のパッケージは必要になった時に追加インストールすることにします

$ sudo tlmgr  install ptex platex jsclasses

次に，日本語フォントのセットアップを行います

TLContirb リポジトリの追加登録

ヒラギノフォントなどのmacOS 同梱のフォントを使うための設定です

ライセンスの関係でmacOS 同梱のフォントを使うためのパッケージ達は別リポジトリ（ TLContrib ）へ分離されています．

そこでまずはこのリポジトリを登録します．

$ sudo tlmgr repository add http://contrib.texlive.info/current tlcontrib
$ sudo  tlmgr pinning add tlcontrib '*'

日本語フォント周りで重要なパッケージは

cjk-gs-integrate-macos (cjk-gs-integrateのmacOS版，フォントの設定を行うスクリプトです)
japanese-otf-nonfree japanese-otf-uptex-nonfree ptex-fontmaps-macos
cjk-gs-integrate adobemapping

です

まとめてインストールします

$ sudo tlmgr  install cjk-gs-integrate-macos  japanese-otf-nonfree japanese-otf-uptex-nonfree ptex-fontmaps-macos  cjk-gs-integrate adobemapping

フォントの登録

cjk-gs-integrate-macos というスクリプト(cjk-gs-integrate のmacOS版)がインストールされているはずです．

これを使って macOS のフォントを登録します

$ sudo cjk-gs-integrate --link-texmf --cleanup
$ sudo cjk-gs-integrate-macos --link-texmf --force
$ sudo mktexlsr

登録ずみフォントの確認

フォントの設定用に kanji-config-updmap-sys というスクリプトがインストールされます．

このスクリプトで現在の設定を確認します．

$ sudo kanji-config-updmap-sys status

以下の出力が得られます

CURRENT family for ja: haranoaji (variant: -04)
Standby family : haranoaji
Standby family : hiragino-highsierra
Standby family : hiragino-highsierra-pron
Standby family : kozuka
Standby family : ms
Standby family : toppanbunkyu-highsierra
Standby family : yu-win10

フォントの変更

pdfに埋め込むフォントを指定します

ヒラギノを指定します

$ sudo kanji-config-updmap-sys --jis2004 hiragino-highsierra-pron

texlive 2020 で導入された「原ノ味フォント」を指定する場合は次のようにします．

$ sudo kanji-config-updmap-sys --jis2004 haranoaji

その他こまごまとした設定

自動で extractbb が実行されるようにする

以下の内容で /usr/local/texlive/texmf-local/web2c/texmf.cnf を用意します

shell_escape_commands = \
bibtex,bibtex8,bibtexu,upbibtex,biber,\
kpsewhich,\
makeindex,mendex,texindy,xindy,\
mpost,upmpost,\
repstopdf,epspdf,extractbb

古い TeX環境の削除

uninstallは簡単です

MacTex 2019 を消したい場合は /usr/local/texlive/2019basic をディレクトリ毎削除するだけです

$ sudo rm -rf /usr/local/texlive/2019basic

トラブルシューティング

pdfに画像が貼れない/gsコマンドが無い: ghostscript (gsコマンド) がインストールされていないと dvipdfmx 経由で作成する pdf に画像が貼れない場合があります．ghostscript をインストールするには https://tug.org/mactex/morepackages.html の mactex-additions.pkg から ghostscriptを選択してインストールするのが楽そうです．