最近設計書の類をvscodeを使用してasciidocで書いている。
プレビュー画面でのplantumlの描画などはkroki.ioに送信したくなかったり, pdf, htmlの出力時にasciidoctorを使用したいがrubyの環境構築をローカルマシンにしたくないので執筆環境をDockerコンテナーとして作成して, そこでドキュメントの作成をするようにしている
環境について
- asciidoctorコンテナ
- krokiコンテナ
の2つを作成し, vscodeのDevContainer拡張機能でasciidoctorコンテナ内でasciidocファイルを作成する形となっている
krokiコンテナーは拡張機能のプレビューでplantumlをレンダリングするのに使用する。