Linux Mint(Re:VIEW Starter 2.5)と完全互換を保つ
これまで、技術同人誌の原稿作成は、
オープンソース PDK をいろいろ試している ミニ SSD 上の Linux Mint + Re:VIEW Starter で行っていました。
ただ、
- SSD に OS を入れ直すたびに環境構築が必要
- Docker 環境の立ち上げで毎回つまずく
- 「原稿を書くだけなのに準備が重い」
という状態が続いていました。
一方で、
去年、miniDV のビデオデータを取り込む目的で購入した 10年前の中古 iMac が手元にありました。
その後は特に使い道もなく、せいぜい YouTube を見る程度だったのですが、
ドキュメント作成などに使ってみたところ、意外にもかなり快適でした。
- 画面が広い
- ドキュメント作成のツールが豊富
- 仕上がりが綺麗
そこで、この iMac に Re:VIEW を入れてみることにしました。
使用している iMac(参考)
中古 iMac(現在だと税込 2.5 万円前後)です。
-
iMac 21.5-inch Late 2015(MK452J/A)
-
CPU:第5世代 Core i7(3.3GHz)
-
メモリ:16GB
-
SSD:128GB
-
HDD:2TB
- ※ Fusion Drive は解除して使用
-
モニター:21.5 inch
- 4096×2304(実質 4K)
-
OS:macOS Catalina(10.15)
- Monterey(12.7.6)まで公式対応
👉 10年前の Mac でも、Re:VIEW 用途なら十分現役
方針(重要)
Linux Mint 側と 完全互換 を保つため、以下の方針で構築します。
- Linux Mint:Re:VIEW Starter(Re:VIEW 2.5)
- Mac:Re:VIEW 2.5 に固定
- system Ruby は使わない
-
rbenv + Ruby + gemで管理 - PDF 出力:MacTeX 2025
- フォント:Linux と同一見た目を優先(現状維持)
👉 Mac / Linux どちらでビルドしても同じ PDF が出る構成
Homebrew のインストール(未導入の場合)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
rbenv の導入
brew install rbenv ruby-build
zsh 設定
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
確認:
which rbenv
Ruby のインストール(Re:VIEW 2.5 安定版)
rbenv install 3.1.4
rbenv global 3.1.4
rbenv rehash
確認:
which ruby
ruby -v
期待値:
~/.rbenv/shims/ruby
ruby 3.1.4
Re:VIEW 2.5 のインストール(重要)
gem install review -v 2.5.0
rbenv rehash
確認:
review version
結果:
2.5.0
⚠️ sudo gem install は絶対に使わない
MacTeX 2025 のインストール
pkg を直接使用します。
mactex-20250308.pkg
ダウンロード先:
http://ftp.jaist.ac.jp/pub/CTAN/systems/mac/mactex/
インストール後、ターミナルを開き直す。
確認:
which platex
which uplatex
which lualatex
bibunsho7-patch(今回は不要)
ヒラギノ対応用パッチ。
git clone --recursive https://github.com/munepi/bibunsho7-patch.git
cd bibunsho7-patch
git checkout v1.11
sudo ./Patch.sh
※ 今回は フォント指定をしていないため不要
※ Linux と同一見た目のまま問題なし
Re:VIEW プロジェクトの利用
Linux Mint(Re:VIEW Starter)で使っている原稿は
そのまま Mac にコピーして使用可能。
PDF 出力:
review-pdfmaker config.yml
# または
rake pdf
発生したエラーと対処
エラー
Psych::DisallowedClass: Tried to load unspecified class: Date
原因
Ruby 3.1(Psych 4)では
YAML の Date クラスが禁止されている。
対処
config.yml の date: を 文字列にする
❌ NG
date: 2026-02-10
⭕ OK
date: "2026-02-10"
または:
date: <%= Time.now.strftime("%Y-%m-%d") %>
→ PDF 正常生成を確認
現在の最終状態(重要)
- Re:VIEW:2.5.0
- Ruby:3.1.4(rbenv)
- MacTeX:2025
- フォント:Linux Mint と同一見た目
- LaTeX:uplatex / dvipdfmx
-
date::文字列指定
👉 Mac / Linux どちらでビルドしても同じ PDF が出る
Mac と GitHub を接続する(原稿共有)
Mac / Linux 両方で原稿を書く場合、
GitHub を原稿の置き場所にするのが一番楽です。
前提
-
GitHub アカウント作成済み
-
GitHub 上にリポジトリ作成済み
- リポジトリ名:
OSPdeAsobo5
- リポジトリ名:
-
Mac に原稿ディレクトリ
OSPdeAsobo5が存在
Git が使えるか確認(Mac)
git --version
無ければ:
brew install git
GitHub 用 SSH 鍵の準備
鍵があるか確認:
ls ~/.ssh
id_ed25519 が無ければ作成。
ssh-keygen -t ed25519 -C "your_email@example.com"
- 保存先:Enter
- パスフレーズ:任意(空でも可)
GitHub に SSH 鍵を登録
公開鍵表示:
cat ~/.ssh/id_ed25519.pub
GitHub Web UI:
Settings
→ SSH and GPG keys
→ New SSH key
貼り付けて保存。
SSH 接続テスト(重要)
ssh -T git@github.com
成功例:
Hi TAKE-HooJoo! You've successfully authenticated.
原稿ディレクトリで Git 初期設定(Mac)
cd ~/OSPdeAsobo5
git init
git branch -M main
GitHub リポジトリ登録(origin)
※ すでに origin があったため set-url を使用
git remote set-url origin git@github.com:TAKE-HooJoo/OSPdeAsobo5.git
確認:
git remote -v
最初の push(Mac → GitHub)
git add .
git commit -m "Initial Re:VIEW manuscript"
git push -u origin main
Linux 側で使う場合
git clone git@github.com:TAKE-HooJoo/OSPdeAsobo5.git
cd OSPdeAsobo5
Re:VIEW 原稿向け .gitignore(重要)
/book/
/*.pdf
/*.log
/*.aux
/*.toc
/*.out
*.synctex.gz
👉 PDF・中間生成物は GitHub に置かない
基本運用ルール(Mac / Linux 共通)
編集前:
git pull
編集後:
git add .
git commit -m "章X 修正"
git push
- OS 切り替え前後で 必ず pull
- 管理対象:
.re/.yml/ 画像 - 生成物:ローカルのみ
まとめ
- Mac は Re:VIEW 環境として普通に優秀
- 10年前の iMac でも十分実用
- Re:VIEW 2.5 固定で Linux Mint と完全互換
- 原稿は GitHub、生成物はローカル
- オープンソースPDKシリーズ制作向けの安定構成
👉 「環境構築に疲れた人(自分)」ほどおすすめです。