sphinx + MyST よいのでは
Gizmo を作る過程で GeometryShader からやりなおしていたら、記憶が飛んでいたので 忘れてもいいように記録しておくことにした。
旧 MinTriangle リポジトリを作り直し。
http://ousttrue.github.io/d3d11_samples/
MyST なかなかよい
reStructuredText わりと苦手なので sphinx でも Markdown を使いたい派なのだが、 MyST なる Sphinx 向け markdown 拡張ができていた。
sphinx directive の指定の仕方がシンプルで下のような感じ。markdown のシンタックスハイライトやフォーマッターに乗れるのでよい。
unknown: html => {"type":"html","value":"<pre>\n```{image} ./basic_pipeline.jpg\n:width: 320px\n:height: 320px\n```\n\n```{toctree}\nbasic/create_window\nbasic/create_device\nbasic/create_swapchain\nbasic/render_target\nbasic/compile_shader\nbasic/basic_pipeline\n```\n</pre>","position":{"start":{"line":18,"column":1,"offset":490},"end":{"line":32,"column":7,"offset":710}}}
sphinx-autobuild と github-actions による gh-pages デプロイを仕込んだらかなりよくなった。
memo
git の revision と path 指定して include できないかしら。 サンプルコードにちょこちょこっと解説を書きたいのだが、サンプルコードが進化する場合に literalinclude だと場所がずれるのだ。