トップページ⇒tech
34コメント8KB

doxygen およびドキュメント自動生成ツール総合スレ

■ このスレッドは過去ログ倉庫に格納されています
0001デフォルトの名無しさんNGNG
doxygen のスレがなかったので立てました
面倒臭いがしないと後で困るドキュメンテーションに便利
備忘録としても威力のある doxygen について語りましょう
もちろんその他ドキュメント自動生成ツールもOK
0002デフォルトの名無しさんNGNG
リンクと概要くらい書いてよ...
0003デフォルトの名無しさんNGNG
2ちゃんねるで評判いいみたいね。

何ができるの?
0004デフォルトの名無しさんNGNG
>>2
すんません

取り合えず公式サイト
http://www.stack.nl/~dimitri/doxygen/

日本語訳してくれている人がここにいます
http://www.fides.dti.ne.jp/~oka-t/doxygen.html
0005デフォルトの名無しさんNGNG
>>3
コメントにある規則で書き付けると
http://www.fides.dti.ne.jp/~oka-t/doxygen-sample/html/
みたいな物を生成してくれるツールです。
日本語化もよくできています。
00062NGNG
>1 ご苦労さん
00073NGNG
ちらりと拝見しました。

ソース書いてドキュメント書く立場からは便利だと思いますし、
JavaDocよりも、パッケージ内のクラス間のつながりを記述しやすそーですね。

JavaDocみたいな、フレーム対応はないの?
#JavaDocの方が、Smalltalkのクラス階層ブラウザのHTML版って位置付け
#に徹していて、情報提示のやり方が上手いと思いますが。
0008デフォルトの名無しさんNGNG
ミカカ向けのドキュソメントは、このソフトで自動生成してる。
http://www.vector.co.jp/soft/dos/amuse/se007728.html
0009デフォルトの名無しさんNGNG
富士通の仕様J?
くそ!すぐ固まる。こんなの買う奴いるのか。
0010デフォルトの名無しさんNGNG
graphvizとかいうツールと併用すると良いのかも?
http://moso.borogrammers.net/moso/diary/?200203a&to=200203051S1#200203051S1
0011デフォルトの名無しさんNGNG
ミカカ向けドキュソメントならこっちも併用したほうが親切。
http://www.vector.co.jp/soft/win95/amuse/se205078.html?site=n
0012デフォルトの名無しさんNGNG
>>9
Fへの納品で使わされましたがなにか?
せこい教授みたいな真似やめれ>F
0013デフォルトの名無しさんNGNG
小河童 http://sourceforge.jp/projects/cuppa/

0014デフォルトの名無しさんNGNG
PHP用のJavaDocモドキの評価ってどうなの?
001513NGNG
>>13
誤爆
0016デフォルトの名無しさんNGNG
doxygenの吐くHTMLはあまりに腐っててウェブデザイナでもある漏れ的に我慢ならないんだが、誰かもうちっとましなものに作り変えてくれる神はおらんか?
ソースは見たことないんだが、あの腐れHTMLじゃぁソースも予想できてしまう(;´Д`)
0017デフォルトの名無しさんNGNG
>>16
どのように駄目なのか、どう直すべきなのかを具体的に作者に伝えればきっと直るだろう。
がんばってくれ(笑)
0018デフォルトの名無しさんNGNG
>>17
直すべき点があまりに多すぎて(全部書き直したほうがまし)伝えるだけで作者の心象を悪くしそうだ(;´Д`)
0019デフォルトの名無しさんNGNG
画面の使い勝手が悪いという主張?
使い勝手は問題にしておらずHTMLのソースコードが汚いという主張?

どっち?
0020デフォルトの名無しさんNGNG
どっちも。
見た目が(当然結果的に使い勝手も)いまいちなのでカスタマイズしようとしたが
HTMLの使い方がなってないのでカスタマイズ不能だった。
作者にHTMLとスタイルシートについて小一時間問い詰めたい。

左のツリービューがスクリプトで読み込み時に生成されてるのも遅くて嫌。
それくらいdoxygen側であらかじめ生成しておくべき。
002119NGNG
GENERATE_XML = YES
でXMLで吐かせてXSLTでどうにかすれば? これなら>>16も開発しやすいでしょう。
まー、どの程度奇麗なXMLを吐くかにもよるが。
0022デフォルトの名無しさんNGNG
試してみるのもいいかもしれない。
速度が気になるけど。
002319NGNG
速度? ブラウザ側にXSLT解釈させる必要はないでしょう。
0024デフォルトの名無しさんNGNG
>>23
そうですた!
0025デフォルトの名無しさんNGNG
graphvizって結構デカいね
rpm --rebuild おわらん。
0026デフォルトの名無しさんNGNG
doxygen で生成するドキュメントのメインページをカスタマイズしたいんですけど
やり方わかる方いらっしゃいますか?
0027デフォルトの名無しさんNGNG
graphvis の手っ取りばやい使い方がわかる人、教えて。
0028デフォルトの名無しさんNGNG
>>26
適当なファイル (たとえば、foo.doc) を作り、そこにコメントの形で
ドキュメントを書けばよい。形式は次のとおり。

/*! \mainpage [タイトル]

ドキュメント

*/

もちろん、Doxyfile の INPUT あるいは FILE_PATTERNS で、上のファイルを
指定しておく。\mainpage は、\page index としてもいいみたい。
0029デフォルトの名無しさんNGNG
ソースがたくさんあってそのうちの一つ直すと
(あるいはまったく直さなくても)
毎回全部生成しなおしているんだけど
何とかならないの?
0030デフォルトの名無しさんNGNG
nkfすると異常に遅くなるんだけど、設定が悪いのかなあ。
速くする方法ある?
0031デフォルトの名無しさんNGNG
>30
いま出てるやつってShift JISでも平気じゃない?
そう云う問題ではないのだろうか……
003230NGNG
ほんと?
前の設定ファイルそのまま使ってたから、nkfはずしてつかってみる。
ありがとう。
0033デフォルトの名無しさんNGNG
>>28
どうも有難うございます、助かりました。
0034デフォルトの名無しさんNGNG
perlだと元から付いてたりする。
■ このスレッドは過去ログ倉庫に格納されています