2012-05-09 7 views
2

私は、スフィンクスで書かれたアプリケーションのユーザーのためのドキュメントを用意しています。今までのドキュメントは静的なHTMLページで、ユーザーがアクセスできます。ドキュメント(スフィンクス)とdjangoアプリケーションのリンク

私は、アプリケーションとドキュメントの間のリンクを作成したいと思います。もちろん、私は壊れやすい<a href="..">リンクでそれを行うことができましたが、reverse()を使ってスフィンクスからビューにリンクし、スフィンクスリファレンスを使用してアプリからドキュメントにリンクします。

もっと良いアプローチがあれば、私はsphinxを置き換えることができます。しかし、私はファイルシステムのリビジョン管理(データベースではない)でドキュメンテーションを保持したいと思います。

ヒント

+0

['sphinx.ext.intersphinx'](http://sphinx.pocoo.org/latest/ext/intersphinx.html)は、ヒント。 – minhee

答えて

1

readthedocs.orgをご覧ください。あなたのドキュメントをホストするか、GitHubからアプリケーションをダウンロードして自分のアプリケーションに統合することができます。 (https://github.com/rtfd/readthedocs.org)

+0

これは商用のdjangoアプリケーションであり、ドキュメントは同じ(イントラネット)ホストから提供されるべきです。手で書かれたリンク( guettli

+0

readthedocs.orgのソースコードは私の前のメッセージのリンクから入手できます。イントラネット上で実行することができます。 –