4 FAQ
よくある (?) 質問
オリジナルのページ: https://yihui.org/tinytex/faq/
オリジナルの最終更新日: 2017/12/02
このよくある質問リストでは, 好奇心のある方に TinyTeX の技術的詳細について説明したり, システム管理者でない人に向けて TinyTeX をインストールしたり使用したりする代わりの方法を説明したりします.
4.1 TeX Live のどのバージョンがインストールされるのですか?
デフォルトでは, Windows, macOS, Linux の最新の動作バージョン, そして他のプラットフォームでも (動作の有無にかかわらず) 最新のバージョンです. ここでの「動作」とは, いくつかの R Markdown 文書を PDF にコンパイルする基本的なテストをパスした TinyTeX のバージョンです. もし古いバージョンをインストールしている場合, 次の FAQ を読んでください.
現在の最新バージョンをインストールできて, このバージョンが十分に安定しているなら将来もアップグレードしない選択ができることを覚えておいてください. ただし, これは現在の TeX Live バージョンが凍結 (年単位で凍結されます) されて以降は LaTeX パッケージをインストールすることもアップデートすることもできないことに注意してください.
TODO: 日本語ユーザにとって後方互換性は重要. なにか追加サポートが必要
4.2 TinyTeX のビルド済みバイナリはありますか?
はい, あります. 2020年9月から TinyTeX のビルド済みバイナリパッケージの提供を始めています. それらは yihui/tinytex-releases で見ることができます. 2名の TeX Live 開発者に TeX Live のライセンスについて教えてもらったのでこれが可能となりました. それ以前はこのライセンスは私にとって複雑で, バイナリパッケージとして再配布することをためらっていました. これが可能であると知ってからは AppVeyor 上でビルドし GitHub リリースとして公開しています.
4.3 TinyTeX のサイズはどれくらいですか?
macOS と Linux では gzip 圧縮で 61 MB, Windows では zip 圧縮で 94 MBです. これでもまだ大きすぎると思うかもしれませんが, Basic TeX インストーラ のサイズが macOS ではおよそ 80 MB に, Windows では MiKTeX インストーラ がおよそ 235 MB になることを考えてみてください.
TinyTeX の軽量さはクラウド上で (たとえば Travis CI で意図的にテストするとき) インストールするときにとても便利でしょう. ダウンロードとインストールはほんの数秒しかかかりません.
もちろん, TinyTeX のサイズは追加で LaTeX パッケージをインストールするたびに増加します. 極端な話, 全てのパッケージをインストールしたいかもしれません (どのパッケージが足りないのかを把握する必要を排除してしまうために). そうしたい場合でも, R ではこのように実行します.
コマンドラインで同様の操作はこうなります
tlmgr install scheme-full
tlmgr path add数ギガバイトぶんのパッケージをダウンロードしインストールする必要があるため, これはかなり時間がかかります
4.4 TinyTeX はどうやって作られたのですか? 巨大な TeX Live のサイズをどうやって削減したのですか?
TinyTeX を理解する最善の方法は TUGBoat の “TinyTeX: A lightweight, cross-platform, and easy-to-maintain LaTeX distribution based on TeX Live” を読むことです. あるいは代わりに tools フォルダにあるソースを読むこともできます. 基本的に TinyTeX は, tinytex.profile (./install-tl -profile=tinytex.profile) というプロファイルで TeX Live のインストールを自動化しています. このファイルは最初にインストールされる infraonly スキームを指定しているだけです. このスキームがあるので LaTeX のドキュメントは一切コンパイルできませんが, 最も重要なユーティリティである tlmgr (TeX Live マネージャ) だけは含まれます. この時点での全体のサイズは (UNIX系では) 1 MB 未満です.
それから tlmgr で基本的なパッケージをさらにいくつかインストールします (これは pkgs-custom.txt で定義されています). これらのパッケージがあればほとんどの R Markdown 文書を PDF にコンパイルすることができます. 全体のサイズはおよそ 61 MB になります.
TinyTeX には少数の LaTeX パッケージを含めているだけであるという点は, TinyTeX が比較的小さなサイズである2つの理由のうちの1つです. もう1つの理由は, パッケージのソースファイルとドキュメントファイルを除外している点です. tinytex.profile にこのような2つオプションが書かれているのがわかるでしょう.
option_doc 0
option_src 0なぜソースファイルを排除したのか? これらはエンドユーザにとって役に立つ場面がなさそうだからです. あなたは LaTeX のソースコードを読みますか? あなたが開発者や上級者ユーザでないならおそらく読んでないでしょう.
なぜドキュメントを排除したのか? 正直に答えてください, あなたは StackExchange で答えを探したことが何度ありますか, パッケージのドキュメントを読んだことが何度ありますか? 完全なドキュメントがあっても, あなたはコンピュータのどこにそのファイルがあるのかすら知らないでしょう. ドキュメントのファイルはディスクの容量を多く占有し, 平均レベルのユーザはほとんど読まないと私は思っています. ゆえに同梱しません. web ブラウザのアドレスバーが最も便利なドキュメントです. キーワードをタイプし, 検索してください.
パッケージのソースとドキュメントを本当に欲しているのなら, CTAN で見つけることができます. あるいは tlmgr installl --reinstall --with-doc --with-src <パッケージ名> というコマンドでソースとドキュメントを再インストールできます. (Norbert Preining の指摘 に感謝します)
TeX Live のサイズに影響する他の主な要因としてフォントパッケージがあります. フォントパッケージは大抵の場合は他の LaTeX パッケージよりずっと大きいのですが, ほとんど使うことがありません. あなたが pdflatex を使わないというのなら話は別ですが. こういった場合では, サイズの小さな TeX Live ディストリビューションをさらに削減することができます.
インストールされたパッケージ全てのサイズを tlmgr info --list --only-installed --data name,size というコマンドで得ることができます. R パッケージの tinytex をインストールしているなら, tinytex::tl_sizes() を使うこともできます. 例えばフォントパッケージの lm (Latin modern) はおよそ 42 MB もあります!
訳注: 日本語ユーザの場合, pdflatex で日本語文書を作成するのは大変なので, ほとんどの日本語ユーザはフォントパッケージが必要であり, また xelatex, lualatex といった多言語に対応した処理系を使うことになるため, ここで書かれているよりもサイズが大きくなります. しかしそれでも, 典型的な日本語文書を作成するのに必要なサイズは, 例えば Linux 系では 500 MB 程度に収まると思います.
4.5 私は Linux システムの管理者です. システム使用者全員が使えるように TinyTeX をインストールするにはどうしたらいいですか?
まずインストールスクリプトに2つのオプション --admin --no-path を追加してください.
wget -qO- "https://yihui.org/tinytex/install-unx.sh" | sh -s - --admin --no-pathこれは TinyTeX を ~/.TinyTeX にインストールします. この時点では root 権限は不要です. それからシステムの利用者全員が TeX Live の実行ファイル (例: xelatex や lualatex) を使えるように sudo で /usr/local/bin にシンボリックリンクを追加する必要があります.
sudo ~/.TinyTeX/bin/*/tlmgr path add~/.TinyTex にデフォルトで 700 のパーミッションが設定されるシステムも中にはあります. これは他のユーザは TinyTeX を使用できないことを意味します (このフォルダ内では読み込み・書き込み・実行いずれの権限もありません). chown を使用してこのフォルダのオーナやグループを変更し, 書き込み権限 (さらに bin への実行権限) を付与するとよいでしょう. これが例です.
chown -R root:staff ~/.TinyTeX
chmod -R g+w ~/.TinyTeX
chmod -R g+wx ~/.TinyTeX/bin~/.TinyTeX を他の場所に移動したいなら, FAQ4.8 を見てください. そしてフォルダを移動したあとに, /usr/local/bin にあるシンボリックリンクが新しい場所を正しく参照するように sudo で tlmgr path add を実行することを忘れないでください.
4.6 私は Linux 管理者です. 上記のアプローチで TinyTeX をインストールし /usr/local/bin にシンボリックリンクを追加しました. root 権限のないユーザーに自分で LaTeX パッケージをインストールしてもらうにはどうしたよいですか?
root 権限のないユーザは通常の方法では, TinyTeX のルートフォルダ (デフォルトでは ~/.TinyTeX, ~ はあなた自身のホームフォルダを意味します) に書き込み権限を持つグループに登録されない限り, tlmgr install コマンドでパッケージをインストールすることができません. このような場合は TinyTeX のシステム全体に対してインストールされた TinyTeX を修正することができます.
TinyTeX フォルダへの書き込み権限がない人たちには, TeX Live のユーザーモード があり, これはユーザーごとに texmf ツリーを管理することができます. 例えばシステムフォルダの代わりに, そのユーザーのホームフォルダにパッケージをインストールできます. TinyTeX があれば, ユーザーレベルの texmf ツリーは ~/.TinyTeX/texmf-home にあります (TeX Live の用語としては, TEXMFHOME 環境変数となります. ~ はあなた自身のホームフォルダを意味します).
ユーザが最初にすべきことは, このツリーを初期化すること (TEXMFHOME がまだ作成されていないなら作ること) です. 以下を一度実行するだけです.
tlmgr init-usertreeそれからパッケージをインストールする時には, ユーザは常に --usermode オプションを付けなければなりません. 例えば以下のように.
tlmgr --usermode install koma-script xcolorR ユーザなら, 上記のコマンドは以下の R の命令文と同じです.
tinytex::tlmgr('init-usertree') # これも最初に一度実行するだけです
tinytex::tlmgr_install(c('koma-script', 'xcolor'), usermode = TRUE)しかし, TeX Live のユーザーモードは実際のところかなり複雑になる可能性があり, 残念なことに私はサポートしきれません. 少しだけ注意事項を挙げておきます.
最悪のやり方はユーザが一切のパッケージをインストールできないことです. TeX Live では再配置可能なパッケージとそうでないものがあります. 例えば実行ファイルを含むパッケージは再配置できません (例: metafont パッケージは
mfという実行ファイルを含んでいます). ユーザがこれらのパッケージを使わなければならないなら, システム管理者だけが頼りです. 良い知らせとして, こういったパッケージは小規模なので, これらを全てをシステム管理者が最初からインストールしておくという保守的な戦略がある, ということがあります. R 関数のtinytex::tl_unrelocatable()は再配置不可能な全てのパッケージの名前を返します. これは内部でtlmgr info --list --data name,relocatableを呼び出しています.パッケージの中にはインストール後に
updmapを実行することが必要なものもあります (例:pdflatexに使用するフォントパッケージ). 良い知らせはupdmap-userを実行できることで, 悪い知らせは (私のドキュメントの理解が正しければ) システム管理者がupdmap-sysを実行するたびに, ユーザはupdmap-userを再実行せねばならないことです. ユーザにとっての保守的な戦略は, 以前にはなかったフォントの問題に出くわすたびに,updmap-userを実行することです (R ユーザはsystem2('updmap-user')を実行できます).
4.7 私は Debian/Ubuntu ユーザです. TeX Live が依存している他のパッケージをインストールすることを止めるにはどうしたらいいですか? TinyTeX と公式の TeX Live のパッケージを両方ともインストールしたくない (あるいは, 必要がない) です.
はい, apt-get install は依存パッケージをインストールする時, なんらかの texlive-* をインストールするかもしれません (例えば, apt-get install dvipng は texlive-base もインストールするかもしれません). あなたが apt-get に「だまされて」 texlive-local.deb をダウンロードしインストールしてしまう可能性があります.
wget "https://travis-bin.yihui.org/texlive-local.deb"
sudo dpkg -i texlive-local.deb
rm texlive-local.debこのパッケージは debian-control-texlive-in.txt 上で equivs-build を実行することでビルドされます (Scott Kostyshak による). 基本的に全ての texlive パッケージが (実際にはインストールされていないのに) インストールされているように擬態するので, あなたはどの LaTeX パッケージを自分で選ぶ完全な自由 (そして責任) を獲得します.
個人的には LaTeX パッケージを全て texlive-* パッケージとして, そしてそれぞれに LaTeX パッケージを梱包して Linux (Debian など) で配布することを好みません. これはあなたが必要なパッケージが1つだけであっても, いくつかの他のパッケージをインストールしなければならないことを意味しています. R ユーザとして (あるいは Python なり他の言語なり) 想像してみてください, 1万を超える R パッケージが, CRAN が 20 組 のパッケージとしてビルドされていて, あなたが必要としているのが ggplot2 パッケージだけなのに他の関連するデータ可視化パッケージが全て強制的にインストールされてしまうとき, あなたはどうしますか? こんなことをする明らかな利点は, (もしかすると) 毎回毎度毎度のように不足しているパッケージをインストールする必要がなくなることですが, 無駄を削ぎ落とした TeX Live ディストリビューションと, インストールするパッケージを自分で選ぶほうが私は好きです (私にとって全く難しいことではありません).
訳注: equivs-build と同様のことは TeX Wiki のこのページ https://texwiki.texjp.org/?texlive-dummy でも紹介されています.
4.8 インストール先フォルダを変えることはできますか?
フォルダのパスはインストールスクリプトにハードコードされているので, TinyTeX インストール時にコマンドラインから変更することはできません. Linux macOS, Windows ではデフォルトで隠しフォルダになるため, 私はこの場所を選びました. TeX Live はほとんどの場合でインストール場所に注意することも (要求することも) ありません. あなたが本当にフォルダを変更したいなら, いくつかの方法があります.
ダウンロードとインストール用のスクリプトを自分で改造することができます (スクリプトはオープンソースです)
R ユーザなら, R パッケージの tinytex をインストールし,
tinytex::install_tinytex()のdir引数にカスタムフォルダを与えることができます.あるいは TinyTeX を先にインストールしてから, 好きな場所にフォルダごと移動させます (USB スティックに移動することもできます). TinyTeX が TinyTeX が TeX Live のポータブル版だという理由です. この方法のトリッキーなところは,
PATH変数に対処することです.tlmgr path addを実行する必要がありますが, デフォルトのインストール場所から移動するとtlmgrはPATHにはありません. そこで,tlmgrをフルパスで実行しなければなりません. これが例です.
# Linux 上で ~/.TinyTeX から /opt/tinytex に移動する想定
/opt/tinytex/bin/*/tlmgr path add
# macOS 上で ~/Library/TinyTeX から /opt/tinytex に移動する想定
/opt/tinytex/bin/*/tlmgr path add
# Windows 上で %APPDATA%\TinyTeX から C:\Software\TinyTeX に移動する想定
"C:\Software\TinyTeX\bin\win32\tlmgr" path addこれが必要なのは1度だけです. FAQ 4.5 の方法で TinyTeX をインストールしたなら, tlmgr path add は sudo で実行する必要があります.
4.9 USB ドライブや他のポータブルデバイスに TinyTeX をインストールするにはどうすればいいですか?
すでに述べたように TinyTeX は TeX Live のポータブル版です. よって簡単にポータブルデバイスにコピーすることができます. あなたがする必要があるのは他のコンピュータにデバイスを挿してから tlmgr path add を実行することだけです. ここでもポータブルデバイスの tlmgr のフルパスが必要です (FAQ 4.8を見てください). このコマンドを実行してアプリケーションを再起動すれば, フルパスなしで tlmgr を実行できるはずです.
あなたが R ユーザなら上記のステップは以下の2つの関数でできます.
# インストール済みの TinyTeX をどこにコピーするか
tinytex::copy_tinytex()
# TinyTeX がデバイスのどこにあるかを指定し, tlmgr path add を実行
tinytex::use_tinytex()あるプラットフォームでインストールした TinyYeX は, 同じプラットフォーム上でのみ動作することに注意してください. 例えば Windows 版は Windows でしか動作しません. 例えば TinyTeX の macOS 版は Windows マシンにコピーすることも使うこともできません.
これは情報システム担当者やシステム管理者を介さなくていいすばらしいやり方です. LaTeX パッケージをインストールしたりアップグレードしたりするよう彼らに要求する必要がありません. 全て自分でやることができます.
訳注: 昨今では USB ドライブを勝手に挿入することもセキュリティ面で問題視されそうな気がするので注意してください.
4.10 デフォルトのインストールパスに TeX Live の年度が含まれていないのはなぜですか?
TeX Live はデフォルトでは /usr/local/texlive/2017 のように年度で名付けたフォルダにインストールされます (MacTeX でもそうです). 普通のユーザにとってはこれにあまり意味がないと私は思っています. TeX Live の開発者以外に, 同一のコンピュータに TeX Live の複数のバージョンをインストールしたい人がいるでしょうか? TeX Live の完全版は巨大であり, 毎年のようにディスク容量を食いつぶすようなことは, あなたもきっと望んでないでしょう.
繰り返しますが, TinyTeX のインストール場所を変更したいなら, あなたにはそれが可能です.
ある TinyTeX ユーザが, 自分はこのことに気づかずに毎年 TeX Live (MacTeX) をインストールしていた, と私に教えてくれました. TinyTeX を試しに使ってみなかったら, これらの /usr/local/texlive/2015, .../2016, and .../2017, といった複数の TinyTeX フォルダが合計で 15GB にもなっていたことに気づかなかったことでしょう. このことは私の推測の裏付けになります. ユーザはしょっちゅう, 過去のバージョンのアンインストールや上書きをせずに TeX Live の新バージョンをインストールしていることを知らず, このモンスターは毎年ごとに大きく成長しています. そう, 今日ではディスク容量は安上がりですが, それは無駄遣いしてもよいということを意味しません.
4.11 数年前にインストールしたTinyTeXをアップグレードするにはどうすればいいですか? “tlmgr: Remote repository is newer than local (2017 < 2018)” のようなメッセージが出てきました.
インストールスクリプトが常に最新版をインストールしているように, TinyTeX を再度インストールすることができます. しかし現在インストールされている LaTeX パッケージは失われます. これらのパッケージも再インストールしたいなら, この R 関数を使うとよいでしょう.
R を使用していないなら, パッケージのリストを取得し, あとでインストールできます.
TL_INSTALLED_PKGS=$(tlmgr info --list --only-installed --data name | tr '\n' ' ')
# この後ホームページに書いた方法で TinyTeX を再インストールします.
# TinyTeX を再インストールしたら, 以下でパッケージも再インストールします
tlmgr install $TL_INSTALLED_PKGS4.12 R パッケージの tikzDevice の使用にはどの LaTeX パッケージが必要ですか?
グラフィックデバイスの tikzDevice::tikz() を使用するにはこれらの LaTeX パッケージが必要です.
tlmgr install pgf preview xcolor4.14 HTTP/HTTPS/FTP プロキシで TinyTeX/LaTeX パッケージをインストールするにはどうすればいいですか?
~/.wgetrc ファイル (~ はあなたのユーザーフォルダ (ホームディレクトリ) を表しています) を作成し, 変数 http_proxy, https_proxy, あるいは ftp_proxy を設定するとよいでしょう. 例えばこのように.
http_proxy=http://user:password@proxy.example.com:8001/詳細は tug.org のこのページと wget のドキュメントを見てください.
4.15 macOS で Homebrew を使って TinyTeX をインストールすることはできますか?
できます. ただし明確な利点はありませんから, 私としてはこの方法はお勧めしません.
brew install -v yihui/tinytex/tinytexFormula は GitHub レポジトリ yihui/homebrew-tinytex にあります. この方法を使わなければならないなら, 以下2点の注意事項に留意すべきです.
Homebrew は TeX Live のシンボリックリンクを管理し (
brew link tinytexで),/usr/local/bin以下にリンクを作成します. このコマンドでtlmgr path addと同じ場所にシンボリックリンクが作られるので, インストール後にtlmgr path addを実行しないほうがよいです. (tlmgr installで) metafont のようなバイナリを含む TeX Live パッケージ (mfを含んでいます) をインストールしたときには, 以下を実行すべきです.brew postinstall tinytex && brew unlink tinytex && brew link tinytexHomebrew で tinytex を更新した後は (
brew update && brew upgradeによって), すでに自分でインストールした LaTeX パッケージはもはや使用できず, 再インストールする必要があります. 解決法の1つとしてbrew pin tinytexでこの formula を将来にわたって更新させないようにします (実際, アップグレードの必要はありません). 別の解決法は, formula の HEAD 版を使用することです.brew cleanup -s brew remove tinytex brew install -v --HEAD tinytexこれらの問題がとても複雑だと感じたら (実際複雑です), ホームページ (1節) に書いてあるような macOS に TinyTeX をインストールする簡単な手順にしたがってください.
4.16 ここで説明されているコマンドをコマンドウィンドウ (ターミナル) を開いて実行するにはどうすればいいですか?
Linux ユーザに対してはこの質問の回答をしません.17 macOS ユーザに対しては Command + Space で Spotlight 検索を立ち上げ, Terminal とタイプしてください. 結果の最初が Terminal.app となっているはずです. それだけです. Windows ユーザの場合, タスクバー上の Windows のアイコンを右クリックして Widnwos PowerShell を選んでください
あなたがRStudio ユーザならば, より簡単です. v1.1 以降の RStudio にはターミナルのビルトインサポート があるので, RStudio 内でターミナルを開くことができます.
訳注: ディストリビューションによって異なりますし, デスクトップ環境ならばおそらく自明でしょう.↩︎