今日は sphinxcontrib-blockdiag の強力な機能、desctable を紹介します。 blockdiag シリーズはテキストから図を生成するツールですが、 ドキュメントというものは図だけで説明が完結するということは少ないです。 図に対する説明、各構成要素の説明などが図とペアになって必要とされることが多いと思われます。 sphinxcontrib-blockdiag の desctable 機能は、 ドキュメントに図を埋め込む際に補足情報として説明表を一緒に出力します。 desctable は description table を意味しており、図の各構成要素の説明を表形式にすることを指しています。 また、desctable はひとつの入力から図と表をセットで生成することで、 ドキュメントの不整合を防ぐことも目的としています。 desctable を使ってみる では、de