python-sphinx - SphinxでreSTの整形式をチェックするには?

Question

reStructuredText の README を PyPI にアップロードする場合、それらは有効な reST ドキュメントである必要があります。ドキュメントを作成するための要件として、すでに Sphinx があります。Sphinxで1つのファイルをチェックすることも可能ですか?

Answer 1

distutilsは、まさにそれを行うPython 2.7 以降のコマンドを実装 しているようです。setup.py check -r

複雑な設定や設定をせずに Sphinx で任意の reST ファイルをチェックする簡単な方法を誰かが発見した場合に備えて、質問を開いたままにします。おそらく Sphinx は、リンクされたドキュメントや外部リンクのチェックなど、より多くの機能を提供できるでしょう。