Sphinx でドキュメントに README を含める
Posted on Sat 16 November 2019 in misc
Django でアプリケーションをつくろうと思っています。自分ひとりで開発するとは言え、ドキュメントがまったく無いのでは開発できないと思い、Sphinx でドキュメントを書き始めました。
ドキュメントは書くし、README も必要だし、同じような内容を両方に書かなければならないのか? Sphinx でドキュメントに README.rst を挿入できないか?
簡単でした。 README.rst を挿入したいところで include ディレクティブを使うだけ。
.. include:: ../../README.rst