- PR -

Webページのビルドコメント

1
投稿者投稿内容
Hobbit
会議室デビュー日: 2004/01/28
投稿数: 6
投稿日時: 2004-11-12 01:36
Webページのビルドコメントについて質問です。
[ツール]−[Webページのビルド コメント]を実行で、作成された
HTMLファイルを見ますとTOPページに
------------------------------------------
コード コメント Web レポート
XXXXソリューション

プロジェクト 説明
 XXXXX
 XXXXX
------------------------------------------

上記のような感じの画面が表示されます。
説明の部分がいつも空白です。
説明を入れたいのですがどのようにすれば説明が表示されるのでしょうか?
ヘルプ見たりWeb検索をしたのですが、よくわかりませんでした。
ご存知の方、ご教授願います。
よろしくお願いいたします。

たつごろー
ぬし
会議室デビュー日: 2004/10/25
投稿数: 496
投稿日時: 2004-11-12 10:19
こんな感じ

C# コードへのコメントの追加
http://www.microsoft.com/japan/msdn/library/ja/vsintro7/html/vxtskAddingCommentsInCode.asp


_________________
たつごろー
codeseek
こみゅぷらす
kanai
ベテラン
会議室デビュー日: 2004/09/13
投稿数: 98
投稿日時: 2004-11-12 10:21
C#を使用する場合、クラスやメソッド等の前の行で「///」を入力して改行すればドキュメントタグのひな型が生成されます。例えば、「説明」は<summary>タグ内に記述します。
(詳しくはMSDNライブラリ「C# コードへのコメントの追加」を参照してください。)

VBは標準ではコードコメントの機能はありませんが、「VBCommenter」というアドインをインストールすればコードコメントの記述(およびXMLドキュメントの出力)が可能になり、さらに「NDoc」というツールを使って、HTMLヘルプを作成できます。

個人的には、標準の「コードコメントWebレポート」よりも「NDoc」のほうが、見た目を美しくできるのでおすすめです。
えんぞ@?
ぬし
会議室デビュー日: 2004/07/06
投稿数: 271
お住まい・勤務地: はまっこ
投稿日時: 2004-11-12 10:37
参考:
 @IT:.NET TIPS C#でMSDNライブラリ風のAPIリファレンスを作成するには?
 @IT:連載:C#入門 第19回 プリプロセッサとドキュメント
 @IT 会議室:JavaDocみたいなドキュメント作成ツールはありませんか?
Hobbit
会議室デビュー日: 2004/01/28
投稿数: 6
投稿日時: 2004-11-12 11:44
皆様、回答ありがとうございます。
説明が足りませんでした。
指摘していただいているHP等は、見てコメントを付けることは出来ました。
質問としては、TOPページです。
TOPページにプロジェクトの説明箇所があります。
そこの説明を入れたいのですが、ヘルプ等を見ても見つけることが出来ませんでした。
(見逃していると思います・・・。)
タグを色々と試しているのですが、プロジェクトの説明欄に反映されません。
やり方をご存知の方、お教え願います。

環境
VS.NET2003 C#
1

スキルアップ/キャリアアップ(JOB@IT)