RubyでPDFを作りたくなったら Kyobashi.rb #13 資料

Kyobashi.rb #13 資料

Transcript

1. RubyでPDFを 作りたくなったら Kyobashi.rb #13 にっしー @nisshy82 1
2. 自己紹介 • 名前 ◦ にっしー • Twitter（𝕏） ◦ @nisshy82 • ソフトウェアエンジニア歴 ◦ 2年 • おしごと ◦ Redmineのプラグインを開発しています ◦ Ruby on Rails / React ◦ Claude Code 2
3. 技書博に出ることにしました！ テーマ： Redmineプラグインの作り方 • • • • 既存のRedmineへ、どう処理を差し込むか メンテナビリティの高いプラグインをどう作るか React / RSpec 実際にプラグインを作って詰まったところ など……… 3
4. 経緯 8/1 きのこ関西 → 8/5 申込 → 9/13 本番 まだ1ページも書けてない 4
5. 本を作るなら、 最初に思い浮かぶのは ……LaTeX 5
6. マジでLaTeXでやりたくない なぜか通らないビルド 思い通りのところに入らない画像 6
7. Markdown + CSSで作れたらうれしい • 書き慣れた Markdown で執筆したい • CSSもAIになら書かせられる ◦ し、最悪フォント指定なども読めて理解 できる 7
8. 本を組むための選択肢 Vivliostyle Typst JavaScript / Node.js Rust Markdown / HTML + CSS → 出版向けPDF 独自のマークアップ → PDF • 目次・表紙・テーマ • Web標準のCSS組版 • 組版システムとして完 結 • コンパイルが速い 8
9. 結論 組版システムはややこしいので この2つのどちらかを使おう！ • 長いものに巻かれたほうが良さそう ◦ Vivliostyle: 2015年〜 ◦ Typst: 2019年〜 8
10. …………せっかくなら Rubyで書けたらいいな 9
11. 「Rubyで本≒PDFを作る」 請求書 帳票 Web画面 技術文書 同じPDFでも、必要なレイアウトと組版が違う 10
12. 既存のPDFに対応した gem Prawn HexaPDF Asciidoctor PDF Ferrum Kitabu prawn-html / prawn-markup 多種多様な gem 12
13. Prawn Rubyのコード → PDF • Rubyから文字・表・図 形を配置する • 帳票や請求書など、形 が決まったPDFに向く • レイアウトは自分で組 む 13
14. HexaPDF PDFの読み書き・編集 + 文書レイアウト → PDF • PDFそのものを読み書き・編集できる • 自動文書レイアウト機能も持っている • HTML / CSSの組版エンジンではない 14
15. Asciidoctor PDF AsciiDoc + YAMLテーマ → PDF • Ruby製で、構造化された技術文書を組め る • 標準テーマがあり、すぐPDFにできる • スタイル指定はCSSではなくテーマ言語 15
16. Ferrum + Chrome HTML + CSS → Chromeで描画 → PDF • 既存のWeb画面とCSSを使える • Chromeの印刷機能へ任せられる 16
17. Kitabu Markdown + CSS → Prince → PDF • Ruby製の電子書籍フレームワーク • 章構成・目次・シンタックス ハイライト、EPUB / HTML出力 • ちょっとライセンス料がかかります よ〜 17
18. どれを選ぶ？ Prawn 固定レイアウトの帳票・請求書 HexaPDF PDF操作と文書レイアウト Asciidoctor PDF 構造化された技術文書 Ferrum + Chrome 既存のWeb画面 Kitabu RubyでMarkdown+CSSの電子書籍 18
19. RubyでPDFを作る 選択肢は様々ある 19
20. 自作オレオレ gemの紹介 ※未完成 Rubihan Markdown + CSS → PDFを、Rubyだけで、それなりに。 26
21. 本の構成を Rubyで書ける 28
22. 目次の作り方も、 Rubyで差し替え可能 29
23. 今回ほしかったもの • 本文はMarkdown、紙面はCSS • ChromeやPrinceなどの外部レンダラを使わない • 文章が次のページへ流れる、一般文書 • Rubyだけで動く 「PDFを出す」だけではなく、「本を組む」が必要 20
24. 「PDFを作る」と「文書を組む」は違う PDFを作る 文書を組む 座標・文字・図形 ↓ PDFへ描く 文章・構造・スタイル ↓ 行とページを決める ↓ PDFへ描く 21
25. 組版システムが担当すること Markdown 文章を読む → 文書構造 見出し・段落 → CSS 見た目を決める → レイアウト → 行・ページ・目次 PDF 結果を書き出す フォント、改行、禁則処理、改ページ、ヘッダー、ページ番号 …… 22
26. 1行を決めるにもフォント情報が必要 文字幅が分からない → どこで改行するか 決められない 日本語では、行頭・行末に置けない文字がある(禁則処理) ex. 拗音(ゃゅょ)・撥音(っ)・句読点・カギ括弧 23
27. 目次+ページ番号問題 本文を組む → ページ番号が分かる → 目次を入れる → ページが動く 安定するまで、ループする LaTeXで何度も見た光景 24
28. PDF／組版、 やっぱり大変 25
29. おわりに • RubyでPDFを作る選択肢は様々 • 作りたい文書と、組版のリッチさで選ぶ • PDFを作ることと、組版システムで文書を組むことは違う 30