KDOC 134: スライド作りに適した道具を考える

• 作成
  • 2024-03-31 貴島
• レビュー
  • 2024-04-27 貴島

いままでスライド作りにこれだという方法はなく、そのときどきの方法でやってきた¹。バラバラの形式でクラウドやローカルのあちこちに散乱している。ちゃんと自分の中で決める。

求める条件。

• WYSIWYGで作れる。図を多用したいのでMarkDownから変換する形式は採用しない。MarkDownで表現できるならスライドにする必要がない。図を重視してドローソフトで作っている人さえいる
• ローカルに保存/編集できる
  • Webサービスで編集だとデータを書き戻すのが手間だから
  • Git管理にしやすいから
  • 文書をまとめたリポジトリに一元化したい
• 汎用性のある形式へ変換できる
  • PDFが鉄板か。誰でも見られてポータブル、Webにも載せやすい
• 原本と変換先の差分更新の手間がない
  • あとから変更したくなることはよくある。そのときに面倒だと、変更しなくなる
  • Webのスライド作成ツールはここで脱落する。編集したあとPDFを再度ダウンロードする必要があるから
  • コマンドラインで変換できるとよい
  • コマンドでビルドできればCIに乗せて反映を自動化できて良い

これらを満たす方法は、drawioのSVG保存 → PDF変換だ。drawioのSVG形式は複数ページ保存をサポートしている。複数ページ保存してPDFへの変換をかけるとページ順に変換してくれる。これをスライドとする。

編集はdrawioのWeb版、デスクトップ版、VSCode版があるので好きなのを使う。PDFへの変換はデスクトップ版で行う。デスクトップ版はコマンドラインツールとしても使える。GitHub Actionsで自動化した。

FILE=drawio-amd64-24.1.0.deb
URL=https://github.com/jgraph/drawio-desktop/releases/download/v24.1.0/$FILE
curl -sLO $URL
sudo dpkg -i $FILE

drawio -f pdf -x sample.svg
# sample.svg -> sample.pdf

したがって、原本のSVGをdrawioで編集・コミット・デプロイという流れになった。あとは自動でPDFに変換される。

抽象。

• 原本から配布用の形への変換に手間がかかると変更しなくなるので、変換を自動にする
• 再編集できる形式を原本として持ち、配布用の形はそこから作る

関連。

• 類推: KDOC 98: org-roam-node-findでエントリが出なくなったときの直し方。元から作った写しは、作り直さないと元の変更に追従しない点で共通する

• KDOC 135: スライドのショーケースを作る