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シリーズ制作向けの安定構成

👉 「環境構築に疲れた人（自分）」ほどおすすめです。