feat(docs): migrate LaTeX document to Typst

bot-genji1024 commented

2026-09-04 03:42:28 +09:00

Collaborator

概要

Issue #1 の通り、TeX (LaTeX) で書かれていたドキュメントを Typst へ移行し、Forgejo Actions による自動ビルドを追加します。文書の内容はすべて保持しています (本文・数式・図・表・ラベル・参考文献)。

Closes #1

変更内容

main.tex → main.typ (Typst) へ移行 (内容保持)
- 12 章 / 26 節、付録は A 〜 D
- 数式は Typst math 記法へ変換、式ラベル・相互参照は元のキーを維持 (@thm:..., @eq:...)
- 図は TikZ/tikzcd → cetz / fletcher で再構成 (22 + 18 図)
- 表は booktabs → Typst #table へ
参考文献 main.bib → main.yml (Hayagriva, 12 件すべて)
.forgejo/workflows/build.yml を追加: push / PR 時に Typst で自動ビルドし PDF を artifact 公開
旧 LaTeX 用ファイル (main.tex, main.bib, .latexmkrc, .chktexrc, .latexindent.yaml, .github/workflows/main.yaml) を削除
README のビルド手順を Typst 用に更新

検証方法 (ローカルでの確認手順)

Typst バイナリと Noto CJK フォントが無い場合は先に用意してください:

# 1) Typst CLI (prebuilt linux x86_64) を一時ディレクトリへ
mkdir -p /tmp/typst /tmp/fonts
curl -fsSL -o /tmp/typst/typst.tar.xz \
  https://github.com/typst/typst/releases/latest/download/typst-x86_64-unknown-linux-musl.tar.xz
tar -xJf /tmp/typst/typst.tar.xz -C /tmp/typst --strip-components=1

# 2) 日本語フォント (Noto Serif CJK JP) をダウンロード
curl -fsSL -o /tmp/fonts/NotoSerifCJKjp-Regular.otf \
  https://github.com/notofonts/noto-cjk/raw/main/Serif/OTF/Japanese/NotoSerifCJKjp-Regular.otf
curl -fsSL -o /tmp/fonts/NotoSerifCJKjp-Bold.otf \
  https://github.com/notofonts/noto-cjk/raw/main/Serif/OTF/Japanese/NotoSerifCJKjp-Bold.otf

# 3) コンパイル (exit 0, 警告なし)
/tmp/typst/typst compile --font-path /tmp/fonts main.typ main.pdf
# → main.pdf が生成される (36 ページ)

# 4) ページ数確認 (任意)
python3 -c "import re;d=open('main.pdf','rb').read();print(len(re.findall(rb'/Type\s*/Page[^s]',d)))"

# 5) YAML 検証
python3 -c "import yaml; yaml.safe_load(open('.forgejo/workflows/build.yml')); print('OK')"

CI 期待値: push / PR 実行時に Forgejo Actions が走り、book-category-theory という名前の artifact として main.pdf がアップロードされます。ローカルでのコンパイルと同一の手順 (fonts-noto-cjk 導入 → typst ダウンロード → typst compile main.typ) です。

既知の差異 (移行上の意図的な変換)

図は cetz / fletcher による同等の再現 (配置は元の TikZ と厳密一致ではなく、ノード・矢印・ラベルは元を維持)
参考文献スタイルは unsrt (引用順数字) 相当として Typst style: "ieee" を使用 (Typst 0.15.1 は style: "numeric" を未サポートのため)

## 概要 Issue #1 の通り、TeX (LaTeX) で書かれていたドキュメントを Typst へ移行し、Forgejo Actions による自動ビルドを追加します。文書の内容はすべて保持しています (本文・数式・図・表・ラベル・参考文献)。 Closes #1 ## 変更内容 - `main.tex` → `main.typ` (Typst) へ移行 (内容保持) - 12 章 / 26 節、付録は A 〜 D - 数式は Typst math 記法へ変換、式ラベル・相互参照は元のキーを維持 (`@thm:...`, `@eq:...`) - 図は TikZ/tikzcd → cetz / fletcher で再構成 (22 + 18 図) - 表は booktabs → Typst `#table` へ - 参考文献 `main.bib` → `main.yml` (Hayagriva, 12 件すべて) - `.forgejo/workflows/build.yml` を追加: push / PR 時に Typst で自動ビルドし PDF を artifact 公開 - 旧 LaTeX 用ファイル (`main.tex`, `main.bib`, `.latexmkrc`, `.chktexrc`, `.latexindent.yaml`, `.github/workflows/main.yaml`) を削除 - README のビルド手順を Typst 用に更新 ## 検証方法 (ローカルでの確認手順) Typst バイナリと Noto CJK フォントが無い場合は先に用意してください: ```bash # 1) Typst CLI (prebuilt linux x86_64) を一時ディレクトリへ mkdir -p /tmp/typst /tmp/fonts curl -fsSL -o /tmp/typst/typst.tar.xz \ https://github.com/typst/typst/releases/latest/download/typst-x86_64-unknown-linux-musl.tar.xz tar -xJf /tmp/typst/typst.tar.xz -C /tmp/typst --strip-components=1 # 2) 日本語フォント (Noto Serif CJK JP) をダウンロード curl -fsSL -o /tmp/fonts/NotoSerifCJKjp-Regular.otf \ https://github.com/notofonts/noto-cjk/raw/main/Serif/OTF/Japanese/NotoSerifCJKjp-Regular.otf curl -fsSL -o /tmp/fonts/NotoSerifCJKjp-Bold.otf \ https://github.com/notofonts/noto-cjk/raw/main/Serif/OTF/Japanese/NotoSerifCJKjp-Bold.otf # 3) コンパイル (exit 0, 警告なし) /tmp/typst/typst compile --font-path /tmp/fonts main.typ main.pdf # → main.pdf が生成される (36 ページ) # 4) ページ数確認 (任意) python3 -c "import re;d=open('main.pdf','rb').read();print(len(re.findall(rb'/Type\s*/Page[^s]',d)))" # 5) YAML 検証 python3 -c "import yaml; yaml.safe_load(open('.forgejo/workflows/build.yml')); print('OK')" ``` CI 期待値: push / PR 実行時に Forgejo Actions が走り、`book-category-theory` という名前の artifact として `main.pdf` がアップロードされます。ローカルでのコンパイルと同一の手順 (fonts-noto-cjk 導入 → typst ダウンロード → `typst compile main.typ`) です。 ## 既知の差異 (移行上の意図的な変換) - 図は cetz / fletcher による同等の再現 (配置は元の TikZ と厳密一致ではなく、ノード・矢印・ラベルは元を維持) - 参考文献スタイルは `unsrt` (引用順数字) 相当として Typst `style: "ieee"` を使用 (Typst 0.15.1 は `style: "numeric"` を未サポートのため)

bot-genji1024 added 11 commits

2026-09-04 03:42:28 +09:00

feat(docs): add Typst port of the book

Build LaTeX document / build_latex (push) Has been cancelled

Details

4fa45a1834

feat(docs): add Hayagriva bibliography

Build LaTeX document / build_latex (push) Has been cancelled

Details

87aabf1cf2

docs: update build instructions for Typst

Build LaTeX document / build_latex (push) Has been cancelled

Details

d2463fd567

chore: trim LaTeX ignores for Typst

Build LaTeX document / build_latex (push) Failing after 18s

Details

02413fca66

ci: build Typst document with Forgejo Actions