- 追加された行はこの色です。
- 削除された行はこの色です。
*[[BasicTeX:http://tug.org/mactex/morepackages.html]] [#basictex]
BasicTeX は [[TeX Live]] のサブセットで，OS X 専用の TeX ディストリビューションです。
BasicTeX は [[TeX Live]] のサブセットで，macOS 専用の TeX ディストリビューションです。
BasicTeX は TeX Live の scheme-small に対応し，LaTeX の文書作成に必要な最低限のパッケージと [[pdfTeX]]，[[LuaTeX]]，[[XeTeX]] などが含まれています。
BasicTeX には [[e-pTeX]] や [[e-upTeX>upTeX,upLaTeX]] が含まれていませんので，日本語の LaTeX 文書を作成するためには別途 collection-langjapanese をインストールします。
collection-langjapanese をインストールすれば，[[jsclasses]] や [[OTF]]， [[BXjscls]]，[[LuaTeX-ja]] も利用可能になります。
collection-langjapanese をインストールすれば，[[jsclasses]] や [[OTF]]，[[BXjscls]]，[[jlreq]] も利用可能になります。
// LuaTeX-ja は BasicTeX + collection-langjapanese だけではダメなので下へ移動 -- アセトアミノフェン (2016-06-22)
なお，「小川版 Drag & Drop UpTeX」はあらかじめ BasicTeX に collection-langjapanese を追加した状態で配布されており，日本語フォントの設定を最低限の操作で完了させることができます。
----
#contents
----
**BasicTeX のインストール [#i5822f30]
**[[小川版 Drag & Drop UpTeX (UpTeX.app)>http://www2.kumagaku.ac.jp/teacher/herogw/]] [#ha7286b6]
***BasicTeX.pkg でインストール [#if691d16]
Drag & Drop UpTeX は，小川弘和さんによって配布されている BasicTeX + texlive-collection-langjapanese ベースの OS X 専用 TeX ディストリビューションです((2011年公開の UTeX20111010.dmg までは teTeX-3.0 / ptetex3 ベースでしたが，2015年9月10日の UTeX20150910.dmg からは TeX Live ベースになりました。))。
OS X 10.10 Yosemite / 10.11 El Capitan 環境になるべくコンパクトな日本語 TeX 処理系を簡単に導入するためにパッケージされています。
TeX 環境をアプリケーション・バンドルのなかに包むことで，任意の場所に Drag & Drop でインストールし，最低限の操作で必要な設定も完了します。
[[More Packages - MacTeX - TeX Users Group:http://tug.org/mactex/morepackages.html]] または[[ミラーサイト (MacTeX)>MacTeX#mirror]] から BasicTeX.pkg をダウンロードします。
***小川版 Drag & Drop UpTeX のインストールと設定 [#e30d8e71]
BasicTeX のインストールの概略は以下のとおりです。
添付の README.pdf をよくお読みください。
アプリケーションファイル名は UpTeX.app です。
基本的にはこれを /Applications 以下などにインストールするとよいでしょう。
+ ダウンロードした BasicTeX.pkg をダブルクリックしてインストールします。
+ ターミナル上で sudo tlmgr update --self --all を実行し，最新版までアップデートします。
+ ターミナル上で sudo tlmgr paper a4 を実行してデフォルトの用紙サイズを A4 に変更します。
+ BasicTeX には標準で日本語 pTeX / upTeX が入っていませんので，collection-langjapanese を追加でインストールします。
sudo tlmgr install collection-langjapanese
collection-langjapanese をインストールすれば，依存関係で collection-langcjk もインストールされます。
インストールしたら，[[dvipdfmx]] による PDF 作成で埋め込む日本語フォントを設定します。
UpTeX.app をダブルクリックで起動し，メニューバーの「UpTeX」-「環境設定」から環境設定パネルを開きます。
「dvipdfmx のフォント」のプルダウンメニューからお使いの OS X のバージョン（Yosemite または El Capitan）に合わせたヒラギノフォントを選択するとよいでしょう。
（これはバックグラウンドで updmap-sys と mktexlsr を実行します。あらかじめヒラギノフォントのシンボリックリンクを作成してあるため，簡単に設定を完了することができます。）
[[Ghostscript]]、[[Latexmk]] は別途インストールする必要があります。
TeX Live のアップデートは，同じく環境設定パネルから「TeX コンポーネントのアップデート」で行います。
（これはバックグラウンドで [[tlmgr]] をターミナルに実行させています。）
***Homebrew でインストール [#w71ff68b]
以下のインストールのやり方などの事例も参照してください。
Homebrew で BasicTeX をインストールできます。
-[[El CapitanでDrag & Drop UpTeX を使って日本語TeX環境を整える:http://ijairai.hatenablog.com/entry/2015/10/24/170311]]
--当該ページの TeXShop の設定（特に upTeX (ptex2pdf) を使うのに ShiftJIS に設定変更している部分）は誤りだが、他のスクリーンショットは参考になる。
$ brew install --cask basictex
$ sudo tlmgr update --self --all
$ sudo tlmgr paper a4
$ sudo tlmgr install collection-langjapanese
***インストールの事例 [#q65e25e8]
**（本家）BasicTeX のインストール [#i5822f30]
-[[macOSにtexlive2023 をインストールする方法:https://pyopyopyo.hatenablog.com/entry/2023/04/07/173000]]
-[[Macでの日本語LaTeXお手軽インストール:https://twitter.com/BeryLiuM_Green/status/1390235461667364864]]
-[[Mac で日本語 LaTeX 環境最短手順:https://twitter.com/u_sho_KyoPro/status/1388020287233355778]]
-[https://qiita.com/yaplus/items/55fa6957c1b15dbcf387 macOS Big SurでLaTeX環境整えた時のメモ(2020, x86_64/arm64対応)]
-[https://qiita.com/yuukami1024/items/bec77e17111ad95a1188 初心者がBasicTexをmacにインストールする(2019年)]
[[More Packages - MacTeX:http://tug.org/mactex/morepackages.html]] または[[ミラーサイト (MacTeX)>MacTeX#mirror]] から BasicTeX.pkg をダウンロードします。
***TeX Live 2016 以降での注意点 [#y0fc0688]
BasicTeX のインストールの概略は以下のとおりです。
// [[古い情報]] に書くべきかもしれないが，影響ある人は少ないと思われるので，直接関係ありそうなこちらに．
+ ダウンロードした BasicTeX.pkg をダブルクリックしてインストールします。
--''手動でパスを通す必要はありません''。
ターミナルで以下のコマンドを実行し，返ってきた PATH に ''/Library/TeX/texbin'' が含まれていれば大丈夫です。
$ echo $PATH
---''ターミナル初心者への注意：'' 上記コマンドの先頭の ''$'' はターミナルを起動すると示される「コマンド入力待ちの記号（プロンプト）」を表します。従って，実際に入力するのは echo $PATH です。
---以前に MacPorts または Fink からインストールした TeX が残っている場合は，パスの優先順位の再設定が必要です。（→[[Multiple TeX Distributions:http://tug.org/mactex/multipletexdistributions.html]]）
+ ターミナル上で sudo tlmgr update --self --all を実行し，最新版までアップデートします。（→[[tlmgr を使用してのアップデート>TeX Live/Mac#p3c663c9]]）
+ BasicTeX には標準で日本語 pTeX / upTeX が入っていませんので，collection-langjapanese を追加でインストールします。
sudo tlmgr install collection-langjapanese
collection-langjapanese をインストールすれば，依存関係で collection-langcjk もインストールされます。
+ 日本語環境を整えます。
-- ヒラギノフォントを TeX でも利用可能にします。（→[[日本語環境の整備>TeX Live/Mac#i9febc9b]]）
--- 以前の TeX Live で既に設定済みの場合は，この手順は不要です。
--- この設定をしなくても日本語は使用できますし，IPAexフォント/IPAフォントを埋め込んだPDFの作成もできますが，高品質なフォントであるヒラギノが使える OS X ならばヒラギノを利用可能にする設定は有用でしょう。
-- sudo kanji-config-updmap-sys を実行して PDF に埋め込むフォントを指定します。（→[[kanji-config-updmap(-sys) >TeX Live/Mac#hf34afcc]]）
--- 新規インストール（アップグレード）時にはフォントが埋め込まれない設定となっているため，作成された PDF が「ファイルが壊れている」と見なされて開けないことがあります。
--- updmap-sys も実行されて各種の map ファイルが自動生成されます。
+ ''Happy LaTeXing!''
TeX Live 2015 以前でのインストール事例・解説記事では，BasicTeX に加えて
[[Ghostscript]] は別途インストールする必要があります。
また，[[TeXShop]] などの追加アプリケーションをインストールするとよいでしょう。
$ sudo tlmgr install ptex
***インストールの事例 [#q65e25e8]
などとすれば日本語環境ができるとしているものがあります。
確かに 2015 以前では ptex をインストールすれば platex も使えるようになっていたのですが，
2016 以降では platex は platex パッケージに分離されました。
このため，ptex をインストールしただけでは platex が使えるようにはなりません。
以下のインストール事例も参考になります。
日本語環境を構成するには，このページで解説しているように collection-langjapanese を
インストールすることをおすすめします。
-[[BasicTeX-2015でRe:VIEWの環境を用意する:http://qiita.com/takahashim/items/74d6d1de557fad09a879]]
// TeX Live 2017 対応
//-[[macOS に Tex Live 2017をインストールする:http://d.hatena.ne.jp/pyopyopyo/20170801/p1]]
//念のため TeX Live 2014 対応のものも残しておきます．
//-[[RStudioから使えるR Markdownで日本語のPDFを作成する:http://bicycle1885.hatenablog.com/entry/2014/10/15/032024]]
//-[[Macbook air に texlive2014 をインストールする:http://d.hatena.ne.jp/pyopyopyo/20140815/p1]]
***アップデート [#zbd108c2]
BasicTeX は [[tlmgr]] を用いてアップデートできます。
** BasicTeX + collection-langjapanese で LuaTeX-ja を使う [#f2230bb1]
$ sudo tlmgr update --self --all
$ sudo tlmgr install collection-langjapanese
TeX Live の collection-langjapanese には [[LuaTeX-ja]] も含まれています。
しかし，BasicTeX + collection-langjapanese だけでは ltjsarticle.cls などを使った文書をタイプセットすることができません。
LuaTeX-ja を実際に使用するには，別途 collection-luatex (ctablestack.sty etc.) や collection-latexextra (filehook.sty etc.) などいくつかのパッケージを追加する必要があります。
% [[Twitter:https://twitter.com/_yyu_/status/728825087470632961]] などを参考に再現してみて，最小構成を確認できれば追記します。 -- アセトアミノフェン (2016-06-22)
% [[ここ:https://qiita.com/yyu/items/e3451caa86779b94abe1]]が参考になりそう。
