[[TeX Live]] > [[macOS>Mac]] ---- #contents ---- *インストール [#install] macOS に TeX Live をインストールする場合，以下の方法があります。 お使いの OS のバージョンによっては，ご利用になれないインストール方法もありますので，事前に[[はじめに：TeX Live 2018 のバイナリの動作環境に関する注意>#binary]]をお読みください。 -TeX Live 公式のインストーラを使用する --install-tl を入手してターミナルから実行します → [[こちら>#texlive-install-official]] -TeX Live をベースにした macOS 専用の TeX ディストリビューションを入手する --MacTeX：TeX Live のフルインストールと，Ghostscript および関連 GUI アプリケーションのインストールを行います。 → [[こちら>MacTeX]] --BasicTeX：TeX Live のサブセット (scheme-small) をインストールします。 → [[こちら>BasicTeX]] --小川版 Drag & Drop UpTeX：TeX Live のサブセット (scheme-small) に日本語パッケージ + α が予め追加されており，日本語フォントのセットアップを自動で簡単に行う GUI も付いています。 → [[こちら>Drag and Drop UpTeX]] -パッケージ管理システムを利用する --Homebrew 向けパッケージ → [[こちら>#texlive-install-brew]] --MacPorts 向けパッケージ → [[こちら>#texlive-install-port]] 以下でそれぞれのインストール法およびセットアップ法を説明します。 ** ［重要］macOS に付属のヒラギノフォント [#yf81dd15] macOS (OS X, Mac OS X) に付属のヒラギノフォントを使用したい場合は，インストールと最新へのアップデートが完了した後で，[[ヒラギノフォント#macos-hiragino-setup]]を参考に設定を行ってください。 下記の理由により，これは特に必須というわけではありません。 -TeX Live 2015 以前では，PDF を作成すると日本語フォントが埋め込まれませんでした。この状況では，何らかの日本語フォントの埋込設定を「必ず」行う必要があり，この TeX Wiki でも「日本語設定の一環」としてヒラギノフォントの利用を推奨していました。 -ところが，TeX Live 2016 以降では状況が変わり，標準で IPAex フォントが埋め込まれるようになりました（[[参考:http://acetaminophen.hatenablog.com/entry/texlive2016-changes#main-7]]）。そのため，もはやヒラギノフォントを使う設定は「日本語設定の一環」ではなく，単に好みの問題となりました。 **はじめに：TeX Live 2018 のバイナリの動作環境に関する注意 [#binary] macOS 用として配布される TeX Live 2018 のバイナリは，x86_64-darwin バイナリと x86_64-darwinlegacy バイナリの 2 種類があります。 -x86_64-darwin バイナリ： [[Apple セキュリティアップデート:https://support.apple.com/ja-jp/HT201222]]が提供されている OS のみをサポートします。 -x86_64-darwinlegacy バイナリ：それ以前のレガシーな OS をサポートします((TeX Live 2016 までは universal-darwin バイナリが存在しましたが，TeX Live 2017 で削除されて i386-darwin バイナリと powerpc-darwin バイナリに置き換えられました ([[r43871:http://www.tug.org/svn/texlive?limit_changes=0&view=revision&revision=43871]])。TeX Live 2018 では i386-darwin バイナリと powerpc-darwin バイナリも削除されました ([[r47075:http://www.tug.org/svn/texlive?view=revision&revision=47075]])。))。 お使いの macOS のバージョンに応じて，適切な方を選択する必要があります。 具体的には，以下の表を参照してください（✔ マークが OS と対応するバイナリを示す）。 なお，MacTeX-2018 / BasicTeX-2018 に付属する TeX Live には x86_64-darwin バイナリのみが収録されていますので，レガシーな OS では使用できません。 CENTER:TeX Live 2018 が動作する OS と対応するバイナリ ||macOS 10.14 Mojave|macOS 10.13 High Sierra |macOS 10.12 Sierra|OS X 10.11 El Capitan|OS X 10.10 Yosemite|OS X 10.9 Mavericks|OS X 10.8 Mountain Lion|Mac OS X 10.7 Lion|Mac OS X 10.6 Snow Leopard|h |x86_64-darwin|✔|✔|✔|✔|✔||||| |x86_64-darwinlegacy||||||✔|✔|✔|✔| // 「クソ」という言葉は、ネタであることが明確でないかぎり、一般的に読み手が不快に感じると思うので、一旦、コメントアウトしておきます。 // このような自分のやりたいことがすぐにできないだけで、自分の門外漢のOSSに対して、暴言の吐く記事を載せる必要もないと考えます。 // このような執拗に「ヒラギノフォント」に拘る人のために、一番上に「ヒラギノフォントを埋め込む」方法を1行ぐらいで書いてあげたら良いのではないでしょうか？ 一発でできないかぎり、またこのような人物が現れるかねないでしょう。 // @kauplan 氏によって Qiita に投稿された記事「[[LaTeXの環境構築がクソ^H^H苦行すぎる（macOS Mojave+MacTex 2018）:https://qiita.com/kauplan/items/44ac2ecc37a31babb577]]」によると、Mojaveでの問題点が「[[TLContrib]]」で説明されているらしいのですが、本ページからのリンクがないためたいへんご苦労された様子です。Mojave の人はそちらの記事も参照してみると良いでしょう。 **TeX Live 公式のインストーラの使用 [#texlive-install-official] TeX Live のインストールガイド -http://www.tug.org/texlive/quickinstall.html -http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#installation を見ると [[MacTeX]] が推奨されていますが，MacTeX に付属する TeX Live には x86_64-darwin バイナリのみが収録されており，レガシーな OS にはインストールできません。 一方，TeX Live 公式のインストーラを使えば，x86_64-darwin / x86_64-darwinlegacy いずれの環境でも TeX Live をインストールすることができます。 まず，[[ミラーサイト>TeX Live#tlnet]]から install-tl-unx.tar.gz をダウンロードします． $ curl -O http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz install-tl-unx.tar.gz を展開します． $ tar xvf install-tl-unx.tar.gz 展開したインストーラのディレクトリに移動します． $ cd install-tl* root 権限でインストーラを実行します． オプションでダウンロードするリポジトリを指定できます． $ sudo ./install-tl --repository http://mirror.ctan.org/systems/texlive/tlnet/ ... Actions: <I> start installation to hard disk <H> help <Q> quit Enter command: I I を入力してインストールを開始します． サーバーの接続エラーが発生したり，何らかの理由により取得したアーカイブに問題があったりした場合はインストールが途中でストップします． この場合は，以下のコマンドで途中から再開できたりできなかったりします． $ sudo ./install-tl --profile installation.profile 再開できない場合は[[接続先を変更>TeX Live#tlnet]]するか，または [[ISO ファイル>TeX Live#iso]]をミラーサイトからダウンロードしてインストールしてください． インストールが終了したら /usr/local/bin ディレクトリ配下にシンボリックリンクを追加します． $ sudo /usr/local/texlive/????/bin/*/tlmgr path add 上記の ???? は 2018，* は x86_64-darwin または x86_64-darwinlegacy にマッチすることが想定されていますがうまく動作しない場合は以下のようにして具体的なディレクトリ名を指定してください． $ sudo /usr/local/texlive/2018/bin/x86_64-darwin/tlmgr path add **Xcode のインストール要求ダイアログについての注意 [#xcode] Xcode がインストールされていない環境下では，TeX Live のインストーラの実行中，および tlmgr によるアップデートの実行中に，次のようなダイアログが表示されて実行が中断される問題が知られています。 > &ref(TeX Live/Mac/XcodeCommandLineTools.png,50%); < cc コマンドの実行のために Xcode Command Line Tools のインストールが要求されているのですが，実際には，Xcode のインストールは必須ではありません。 「今はしない」をクリックしてスキップして問題なく，そのままインストール・アップデートが続行できます。 なお，このダイアログを出さずに tlmgr を実行するために，次のような回避策が存在します。 例えば $ sudo tlmgr update --self の代わりに $ sudo bash -c "CC=: tlmgr update --self" と実行すれば，cc コマンドを無効化して tlmgr を実行できます（ : は「何もしない」という bash の組み込みコマンド）。 この場合，Xcode のインストールが要求されることなく，tlmgr の実行が正常に完了します。 **パッケージ管理システムによる TeX Live (MacTeX, BasicTeX) のインストール [#texlive-install-pacman] ***[[Homebrew:http://brew.sh/]] によるインストール [#texlive-install-brew] -https://github.com/caskroom/homebrew-cask -https://github.com/caskroom/homebrew-cask/blob/master/Casks/mactex.rb -https://github.com/caskroom/homebrew-cask/blob/master/Casks/mactex-no-gui.rb -https://github.com/caskroom/homebrew-cask/blob/master/Casks/basictex.rb TeX Live をフルインストールする場合は MacTeX をインストールしてください。 Homebrew で MacTeX をインストールできます。 Ghostscript などのツールも Homebrew でインストールできます。 GUI-Applications ありの場合 $ brew cask install mactex $ sudo tlmgr update --self --all $ sudo tlmgr paper a4 GUI-Applications なしの場合 $ brew cask install mactex-no-gui $ sudo tlmgr update --self --all $ sudo tlmgr paper a4 TeX Live をフルインストールしたくない場合は BasicTeX をインストールしてください。 Homebrew で BasicTeX をインストールできます。 $ brew cask install basictex $ sudo tlmgr update --self --all $ sudo tlmgr paper a4 $ sudo tlmgr install collection-langjapanese インストールのやり方などの事例も参考になります。 -[[MacTeX#n379ea53]] -[[BasicTeX#q65e25e8]] ***[[MacPorts:http://www.macports.org/]] によるインストール [#texlive-install-port] -[[TeXLivePackages – MacPorts:https://trac.macports.org/wiki/TeXLivePackages]] -https://www.macports.org/ports.php?by=name&substr=texlive -https://github.com/macports/macports-ports/tree/master/tex --https://github.com/macports/macports-ports/blob/master/tex/texlive-lang-japanese/Portfile --https://github.com/macports/macports-ports/blob/master/tex/texlive-luatex/Portfile --https://github.com/macports/macports-ports/blob/master/tex/texlive-xetex/Portfile --https://github.com/macports/macports-ports/blob/master/tex/texlive/Portfile MacPorts 用に TeX Live/MacPorts というパッケージが提供されています。 TeX Live/MacPorts をフルインストールする場合は $ sudo port install texlive +full 日本語関連のパッケージと texlive-luatex パッケージと texlive-xetex パッケージと texlive パッケージをインストールする場合は $ sudo port install texlive-lang-japanese texlive-luatex texlive-xetex texlive を実行します。 インストールのやり方などの事例も参考になります。 -[[SphinxでLatex拡張を使ってPDF出力する:https://qiita.com/H-A-L/items/8222d894daf1552cef67]] -[[LaTeXをmacportsを使ってインストール:http://regry358.hatenablog.com/entry/2014/06/02/155405]] -[[OSXへのTeXliveインストール (MacTex / MacPorts):http://sphinx-users.jp/cookbook/pdf/latex-install-osx.html]] *TeX Live のセットアップ [#bcb0d462] **[[tlmgr]] を使用してのアップデート [#p3c663c9] ターミナルで，以下のコマンドを実行します。 $ sudo tlmgr update --self --all --self は tlmgr 自体のアップデート，--all は TeX Live 構成要素のアップデートを実行します。 tlmgr は複数のリポジトリを管理できます。 [[TeX Live Utility]] は tlmgr の機能を GUI で実現するものですので，上記の機能をメニュー項目から実行できます。 **macOS に付属のヒラギノフォント [#zdc78348] [[ヒラギノフォント#macos-hiragino-setup]]を参考に設定を行ってください。 **IPAexフォント/IPAフォント [#x667dd85] IPAexフォント/IPAフォントは TeX で使用可能な状態でインストールされていますので，updmap-sys の設定だけですぐに pdf に埋め込めます。 **みかちゃんフォントなどのフリー書体・その他の日本語書体 [#i9ff3350] [[みかちゃんフォント:http://www001.upp.so-net.ne.jp/mikachan/]]などのフリー書体（[[フォント]]参照）や，その他の日本語書体を埋め込みたい場合は，そのためのスタイルファイルを利用するのが便利でしょう。 設定は，多少面倒です。 [[PXmika パッケージ:http://zrbabbler.sp.land.to/pxmika.html]]，[[MacTeX 2013とみかちゃんフォントの設定:http://appcar.jp/wp/casual/2013/06/19/mactex-2013-mikachan/]]を参考にしてください。 自力で一から構築する場合は [[MacPortsのpTeXにおける和文多書体環境の整えかた:https://miko.org/~tatyana/tech/OSX/pTeX/fonts.html]] が参考になります。 **updmap(-sys) の使用に関する注意点 [#qdce07c2] -''注意'' updmap-sys ではなく updmap を使用した場合は ユーザー個別の texmf（TEXMFHOME）に設定が書き込まれ，その個別設定の方が updmap-sys によるシステム全体の設定よりも優先されます。 tlmgr および kanji-config-updmap-sys は updmap-sys を内部で呼びだしますが，-sys なしの kanji-config-updmap-sys は -sys なしの updmap を実行します。 ''-sys をつけたコマンドによる新しい設定が反映されない場合は，-sys なしの updmap による設定が TEXMFHOME に残ってないか確認してください''。（-sys なしの updmap による設定は不可視ファイルとなっています。） - updmap-sys は TEXMFLOCAL を検索対象とはしますが，TEXMFHOME は検索しませんので，フォントは原則として TEXMFLOCAL に置くことが推奨されています。(→ [[Font Installation with TeX Live 2012+:http://tug.org/mactex/TeXLive2018+Changes.pdf]] を参照) TEXMFHOME にフォントを置く場合は，updmap（-sys なし）を実行する必要があります。 --埋め込むフォントを細かく制御したい場合は，手動で map ファイルを書き換えます。 **kanji-config-updmap(-sys) [#hf34afcc] -[[kanji-config-updmap:https://github.com/texjporg/jfontmaps/blob/master/script/kanji-config-updmap.pl]] を使用すれば PDFへの埋め込みフォントの指定，および埋め込み状況の確認ができます。 ターミナル上で実行します。 新規インストール直後など，kanji-config-updmap-sys で設定してもPDFへの埋め込みがされない場合は，上の updmap-sys を使う方法を試してください。 $ sudo kanji-config-updmap-sys <fontname> （otf-<fontname>.map にしたがってフォントを埋め込む） $ sudo kanji-config-updmap-sys auto （自動的に <fontname> のいずれかを埋め込む） $ sudo kanji-config-updmap-sys nofont （PDF にフォントを埋め込まない） $ sudo kanji-config-updmap-sys status （現在の埋め込み設定を確認する） --オプションとして --jis2004 を指定すると，JIS2004 字形を使用する設定となります。 --kanji-config-updmap-sys は内部で updmap-sys を呼び出しますので，設定はシステムレベルで共通の設定として保存されます。 ユーザー個別の設定としてフォントを指定したいときは，kanji-config-updmap を使用します。 --ptex2pdf を使用するとその都度フォントを指定できます。（下の例は upLaTeX + dvipdfmx で IPAexフォントを使用して PDF を作成するものです。） $ ptex2pdf -u -l -ot '-synctex=1' -od '-f uptex-ipaex.map' hoge.tex *TeX Live のインストールディレクトリ [#k03895bf] インストール方法によってディレクトリが異なりますので，ここにまとめておきます。 > ,,MacTeX-2018, [[［改訂第7版］LaTeX2e美文書作成入門:http://okumuralab.org/bibun7/]]第2刷 ,基本インストール, /usr/local/texlive/2018, /Applications/TeXLive/Library/texlive/2017 ,TEXMFLOCAL, /usr/local/texlive/texmf-local, /Users/Shared/TeXLive/texmf ,TEXMFHOME, ~/Library/texmf, ~/TeXLive/texmf < ** 基本システムのインストール場所 [#ffbf8218] -MacTeX-2018 に収録されている TeXLive-2018 は，デフォルトでは /usr/local/texlive/2018 以下にインストールされます。 -[[［改訂第7版］LaTeX2e美文書作成入門:http://okumuralab.org/bibun7/]]からインストールすると，デフォルトではアプリケーションフォルダにインストールされます。 ***TEXMFLOCAL [#d2b2c9d5] - TEXMFLOCAL とは，MacTeX/TeX Live 本体のアップデートに影響を受けないディレクトリで，そのコンピュータのユーザー全員に共通の設定を保存します。~ ''自分でスタイルファイル（.sty）やフォントなどを追加するときは，この TEXMFLOCAL または下記の TEXMFHOME 以下に置きます。'' - MacTeX-2018 に収録されている TeXLive-2018 による TEXMFLOCAL は /usr/local/texlive/texmf-local で，以前に作成されていない場合に新たに作成されます。 -[[［改訂第7版］LaTeX2e美文書作成入門:http://okumuralab.org/bibun7/]]からのインストールでは，TEXMFLOCAL はユーザのホームフォルダの一つ上の階層「ユーザ」の中の「共有」フォルダに作成されます。 ***TEXMFHOME [#qf071757] - TEXMFHOME はユーザー個別の設定を保存する場所です。 - MacTeX-2018 に収録されている TeXLive-2018 では，初期設定ではホームのライブラリ以下に収めます。 -[[［改訂第7版］LaTeX2e美文書作成入門:http://okumuralab.org/bibun7/]]からのインストールでは，TEXMFHOME はユーザのホームフォルダに作成されます。 ***その他 [#w4248b01] -$TEXMF の検索優先順位は，ターミナル上で以下のコマンドで確認できます。 $ kpsewhich -var-value TEXMF - MacTeX/TeX Live 2013より，最上位の texmf/ は簡便化のため texmf-dist/ と統合されました。&br;TEXMFMAIN も TEXMFDIST も共に texmf-dist/ を示します。 - ユーザー個別の TEXMF（~/以下の TEXMF）は検索優先順位が高いため，/usr/local/texlive 以下の設定よりも優先されます。&br;また，mktexlsr（ls-Rの作成）は不要です。&br;実際にターミナル上で sudo mktexlsr としても ~/以下の TEXMF に対しては ls-R は作成されません。 > ,TEXMFCONFIG,~/Library/texlive/2018/texmf-config ,TEXMFVAR,~/Library/texlive/2018/texmf-var ,TEXMFHOME,~/Library/texmf < -最新版の TeX Live で問題が発生した場合は以前にインストールしていた古い TeX Live に切り替えて使用することもできます。 TeX Live Utility のメニューから [設定] > [TeX Live の既定版を変更…] を選択することで変更できます。 *その他の選択肢 [#qab24fbc] [[VirtualBox:https://www.virtualbox.org/]] などの仮想マシン上に [[Linux]] をインストールし，その上で TeX Live を使用する方法もあります。 macOS を使用していて LaTeX の実行速度が遅い場合は Linux を使用するのも一つの手です。