2013-01-24 4 views
11

htmlドキュメントを作成する際に、存在しないリンク上でスフィンクスに報告したり、エラーを作成したりするにはどうすればよいですか?スフィンクスに壊れたリンクがあると報告する

具体的には、Pythonプロジェクト内で削除または名前を変更したプロパティとメソッドがあり、sphinxで生成されたhtml出力を持つすべての無効なリンクを見つけることは難しいです。

私はここの答えを見つめているように感じます: http://sphinx-doc.org/glossary.html、はじめの段落で説明されています。

私は明らかに何かを理解していません。

答えて

4

私はあなたが探しているものはCheckExternalLinksBuilderだと思います。

基本的には、 'sphinx-build'を-b linkcheckオプションと呼んで使用します。詳細はsphinx-buildをご覧ください。また、スフィンクスエクステンションherehereのリストを見てください。

+2

これは、削除または名前を変更したPythonプロジェクト内のプロパティとメソッドを見つけるためには機能しません。それは外部リンクのためだけに働くように見えます。 – Idaho

+0

さて、わかりました。私は壊れたプロパティやメソッドを見つけることがスフィンクスの仕事であるとは確信していません。 pylintのような音、pyflakesは仕事のための正しいツールです。 – alecxe

12

nitpicky設定変数をTrueに設定してください(また、-n optionは、sphinx-build実行時に使用できます)。

ニッキーピッドモードでは、関数(例::func:`myfunc`)、クラス、または見つからない他のオブジェクトへの相互参照によって警告メッセージが生成されます。

+0

素晴らしいプロジェクトのconf.pyファイルで "nitpicky = True"を追加すると修正されました。 – Idaho

+2

非常に良い答え!それらの警告をファイルにリダイレクトする方法はありますか? – jsmedmar

+1

@jsmedmar、[** - w **](http://www.sphinx-doc.org/en/stable/invocation.html#cmdoption-sphinx-build-w)オプションを使用しようとしましたか? – mzjn