man ページを作成する最良の方法は何ですか? 標準の man マクロを使用して作成する必要がありますか、それとも XML 化されたソースを取り、man ページ、HTML、ASCII などを出力できる巧妙なパッケージが利用可能になりましたか?
ありがとう
man ページを作成する最良の方法は何ですか? 標準の man マクロを使用して作成する必要がありますか、それとも XML 化されたソースを取り、man ページ、HTML、ASCII などを出力できる巧妙なパッケージが利用可能になりましたか?
ありがとう
以前、man ページを書くために groff と呼ばれる nroff の GNU バージョンを使用しました。
ここにある素敵な紹介記事:
Tcl コミュニティで一般的に使用されるツールはdoctools です。これは、groff または nroff でのレンダリングに適した、マンページ形式の制限された (しかし有用な) サブセットを作成できるものです。また、プレーン テキストと HTML の両方を直接生成することもできます。
Doxygenはあなたが探しているものです。ソースコードを文書化するように設計されていますが、簡単に変更できることに注意してください。
html、pdf、latex ドキュメントも生成できます。
一度書いて、マンページ、HTML、プレーン txt、さらには PDF などのさまざまな出力形式を生成することを検討している場合は、docbookが最適に機能するはずです。