使用 NDoc 对 asp.net (Web) 项目产生文档的方法

NDoc是一个非常好的文档生成工具,现在还出了一些不错的中文版,如
破宝的http://www.percyboy.com/w/ndoc/
但是由于NDoc现在的版本1.3 不支持Web项目,也不支持中文文件名,
下面提出一个临时性的解决办法

1. 解决不认识http://的Web项目的问题
方法:
(1)将.csproj文件复制一份,其中将项目类型由“Web”改为“Local”
(2)将.sln复制一份,将其中的项目路径由http://localhost/xxxx 改为本地路径如
        c:/inetpub/wwwroot/xxxx ,并指向则才改过的.csproj文件。
然后用NDoc打开刚改过的.sln文件即可。

2. 解决不认识中文文件名、路径名的问题
解决方法:将.csproj用记事本打开,在最前面加上一行:
<?xml version="1.0" encoding="utf-8" ?>
然后另存(但文件名不变),但一定要将编码设为utf-8。
注意,如果项目保存则上面一行由vs.net去掉,则又得重新加上。

以上办法行得通,不过是临时的办法,
希望NDoc1.4中会解决这些问题。

posted on 2005-10-08 12:12  拓荒者  阅读(1265)  评论(3编辑  收藏  举报

导航