reStructuredText と Sphinx

通常は markdown を使っているのだが、すこしちゃんとしたドキュメントを作成するのには reStructuredText のほうがよさそうだったので、試してみることにする。

postd.cc

sphinxUbuntu へインストールする方法を悩む。色々ありすぎて。

Sphinxのインストール — Sphinx 4.0.0+/b93aa3137 ドキュメント

sphinxpython なツール。phthon はバージョン問題があるので、素の環境でインストールするとトラブルことがある。なので、複数のバージョンを切り替えて使う方法が多々ある。

昔調べて、Anaconda を採用した。理由は忘れた(汗。

 

実際にホームディレクトリの下に anaconda3 ディレクトリがあった。すっかり忘れていたが。

 

また、今時な方法として Docker を使う、というのもあり。

DockerでSphinxを使う — hnakamur's tech memo ドキュメント