0

私は、特に十分に文書化されていない、小さいPythonコードベース用の開発後の「インターフェース制御文書」を作成しようとしています。インプレースドキュメントスキーマに適合させるには、フラットなWordドキュメントとして配信する必要があります。ほとんどの場合、コードから抽出する必要があります。

これまでのところ、私の唯一の候補はdoxygenの.rtf機能です。そして、doxygenはPythonではまあまあです。そして、rtfでもそうです。それで。誰かがより良い解決策を提案できますか？

4

1 に答える 1

2

Pythonコミュニティは、ReST形式を強力にサポートしています。大量の単語文書を処理しなければならなくなった後、私はそれを愛するようになりました。Sphinxは、プロジェクトのドキュメントとして使用できる優れたドキュメントツールであり、http：//readthedocs.orgで使用されますが、小さなプロジェクトのセットアップには少し時間がかかる場合があります。

したがって、ReSTで記述し、pandocを介してそれがどのように単語に変換されるかを確認することをお勧めします。

そして実際、pandocは次の形式をWordや他の多くの形式に変換することをサポートしているので、Wordでの書き込みを避けたい場合は、ドキュメントを書き込むことができる多くの形式があります。

  • マークダウン
  • reStructuredText（ReST）
  • 繊維
  • HTML
  • DocBook
  • ラテックス
于 2013-01-16T05:22:46.353 に答える