5

私はPythonとRubyの両方を使用しており、RubyのYardドキュメントサーバーが大好きです。

http://yardoc.org/、

Pythonの世界に同等のものがあるかどうか知りたいですか？「pydoc-p」は本当に古く、醜く、まったく使い心地が悪く、SphinxとEpydocがサーバーモードをサポートしているようには見えません。

同等のものを知っていますか？

ありがとうございました

4

2 に答える 2

3

Pythonパッケージには、ドキュメントを配置する場所の規則が実際にはありません。パッケージのメインドキュメントは、さまざまなツールを使用して作成される場合があり、ドキュメント文字列に基づく場合もあれば、そうでない場合もあります。表示されるpydoc -pのはパッケージの内容とdocstringのみであり、メインのドキュメントではありません。これが必要な場合は、この目的でSphinxを使用することもできます。これが、私sphinx-serverがコーディングしたばかりのシェルスクリプトです。

#!/bin/sh
sphinx-apidoc -F -o "$2" "$1"
cd "$2"
make html
cd _build/html
python -mSimpleHTTPServer 2345

情報を取得するパッケージのパッケージディレクトリを最初の引数として、新しいドキュメントを作成するディレクトリを2番目の引数としてこれを呼び出します。次に、ブラウザでhttp：// localhost：2345/にアクセスします。

（注：スクリプトからWebサーバーの呼び出しを削除することをお勧めします。これは、デモンストレーションを目的としたものです。これは、Python 2.xを想定しています。）

于 2012-04-25T20:54:39.207 に答える
2

HTMLを提供するためだけにWebサーバーを実装する必要はないようです。私は、各ツールが1つの小さなことを行うという*ixの哲学を好む傾向があります。Webサーバーが小さいわけではありません。

しかし、 http：//docs.python.org/library/basehttpserver.htmlを見ることができます

于 2012-04-25T20:49:48.333 に答える