继续完善SandCastle

作者：Truly
日期：2007.8.8

今天抽空继续调整了SandCastle的部分代码，现在可以初步看到一些jscript格式的说明文档了，不过还是不很完美，由于没有SandCastle的源码，极大的影响了调试修改的过程。下面是生成的文档的一个抓图，大家可以通过点击 这里查看我生成的文档。

//  Bootstrapping the Sys namespace. Can't use registerNamespace here as its code uses some of the private
//  variables that moved from the global namespace onto Sys.
//  Changes to registerNamespace should be checked against this bootstrapping code to keep them in sync.
window.Sys  =  {
    __namespace:  true ,
    __typeName:  " Sys " ,
    getName:  function () { return   " Sys " ;},
    __upperCaseTypes: {}
};
Sys.__rootNamespaces  =  [Sys];
Sys.__registeredTypes  =  {};

Sys.IDisposable  =   function  Sys$IDisposable() {
     throw  Error.notImplemented();
}

     function  Sys$IDisposable$dispose() {
         throw  Error.notImplemented();
    }
Sys.IDisposable.prototype  =  {
    dispose: Sys$IDisposable$dispose
}
Sys.IDisposable.registerInterface('Sys.IDisposable');
Sys.StringBuilder  =   function  Sys$StringBuilder(initialText) {
     // / <summary locid="M:Sys.StringBuilder.#ctor" />
     // / <param name="initialText" optional="true" mayBeNull="true" locid="Param:Sys.StringBuilder.#ctor.initialText"></param>
     var  e  =  Function._validateParams(arguments, [
        {name:  " initialText " , mayBeNull:  true , optional:  true }
    ]);
     if  (e)  throw  e;
     this ._parts  =  ( typeof (initialText)  !==  'undefined'  &&  initialText  !==   null   &&  initialText  !==  '')  ?
        [initialText.toString()] : [];
     this ._value  =  {};
     this ._len  =   0 ;
}

上面是Sys的部分代码，看一下生成的文档：


抓图3：


说明：今天继续修改SandCastle组件并调整了生成的配置，最终获得了上面的js文档。

通过SandCastle我们可以生成JavaScript和.NET代码的注释文档，风格有好几种，而且现在的CTP版本已经增强了很多自定义的功能。

本文仍然是以MicrosoftAjax.js为文档，对于自己编写的js也可以利用ScriptDoc和SandCastle来生成文档。

today's update(August 9, 2007): fixed the format of class and method,etc. and added a JavaScriptDeclarationSyntaxGenerator class into the SyntaxComponents, then you can set sandcastle.config to generate a javascript document using this template.

here's some shots:





Now its format is very close the MS script reference.

to be continue...