随笔 - 16  文章 - 1 评论 - 151 trackbacks - 4
<2007年6月>
日一二三四五六
272829303112
3456789
10111213141516
17181920212223
24252627282930
1234567

与我联系

常用链接

留言簿(5)

我管理的小组

我参与的团队

我的标签

随笔分类(21)

随笔档案(16)

文章分类(1)

文章档案(1)

最新随笔

搜索

  •  

积分与排名

  • 积分 - 25546
  • 排名 - 1515

最新评论

阅读排行榜

评论排行榜

Sandcastle 出新版本了

      曾经在园子里面看到过有兄弟介绍SandCastle，在VS2005下用来生成文档的，而且是微软官方出品，最近被QA追的比较紧，一直在追文档，于是想到了SandCastle，最近它发布了新的版本，六月CTP版本，决定下载来研究研究，生成一下文档。
 
      下载地址：
      http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en


What's new in this version:

  1. New version of the CCI reflection engine.
  2. New presentation style and document model code named “VSORCAS”. Please see http://blogs.msdn.com/sandcastle/archive/2007/06/17/introducing-a-new-document-model-design-code-named-vsorcas.aspx.
  3. New ResolveReferenceLinks2 component replacing the existing ResolveReferenceLinks component.
  4. Added 2 new executables under production tools folder. They are SegregateByAssembly.exe and AggregateByNamespace.exe. These are used for building componentized assembly level HxS or CHM. I will blog more details about these in the coming weeks.
  5. Configure MrefBuilder to get dependencies from GAC. Please see changes to MrefBuilder.config file for details.
  6. Moved several common files to Presentation\shared folder.
  7. Support for recursively reading file. Please see changes to configuration files below for details.
  8. Added build.proj under Examples/Sandcastle folder. This Msbuild project file will generate chm/Hxs build from test.cs. Usage details below.


 

posted on 2007-06-22 15:28 沉睡海洋 阅读(2622) 评论(12)  编辑 收藏 所属分类: .Net 、Sandcastle

FeedBack:
#1楼  2007-06-22 16:47 jijl2001 [未注册用户]
现在有没有图形画界面了
  回复  引用    
#2楼 [楼主] 2007-06-22 17:12 沉睡海洋      
好像官方的没有，但是社区里面有人做了一个

  回复  引用  查看    
#3楼  2007-06-22 21:05 Michael [未注册用户]
我还以为是Castle呢晕
  回复  引用    
#4楼  2007-06-22 21:32 flyingfish      
收藏了
  回复  引用  查看    
#5楼  2007-06-25 04:06 csharp [未注册用户]
好東西 來試試
  回复  引用    
#6楼  2007-07-01 13:21 大奔 [未注册用户]
好困惑，整了好久没有解决：
Building help topics...
[E:\Webroot\wwwroot\bin\Debug\Help\Working\BuildHelpTopics.bat]
BuildAssembler (v2.2.64000.4)
Copyright ? Microsoft 2006
Info: CopyFromFileComponent: Instantiating component.
Info: CopyFromFileComponent: Loading data file 'C:\Program Files\Sandcastle\Presentation\Prototype\transforms\skeleton.xml'.
Info: CopyFromIndexComponent: Instantiating component.
Info: CopyFromIndexComponent: Searching for files that match 'reflection.xml'.
Info: CopyFromIndexComponent: Searching for files that match 'C:\Program Files\Sandcastle\Data\Cpref_reflection\*.xml'.
Error: BuildAssembler: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.IO.DirectoryNotFoundException: 未能找到路径“C:\Program Files\Sandcastle\Data\Cpref_reflection”的一部分。
在 System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath)
在 System.IO.Directory.InternalGetFileDirectoryNames(String path, String userPathOriginal, String searchPattern, Boolean includeFiles, Boolean includeDirs, SearchOption searchOption)
在 System.IO.Directory.GetFiles(String path, String searchPattern, SearchOption searchOption)
在 System.IO.Directory.GetFiles(String path, String searchPattern)
在 Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocuments(String wildcardPath)
在 Microsoft.Ddue.Tools.IndexedDocumentCache.AddDocuments(String baseDirectory, String wildcardPath, Boolean recurse)
在 Microsoft.Ddue.Tools.CopyFromIndexComponent..ctor(BuildAssembler assembler, XPathNavigator configuration)
Last step completed in 00:00:00.4375


BUILD FAILED: Unexpected error in last build step. See output above for details.

  回复  引用    
#7楼  2007-07-01 16:15 大奔 [未注册用户]
GUI的几个整了半天都出错了，还是原始命令行简单，看来GUI的把问题整复杂了。

在你的DLL生成目录创建定个build.bat 文件，其中Your.dll 改为你的DLL名，（Sandcastle和HTML Help Workshop如果不是选择默认安装路径，请相应更改）：
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

MRefBuilder Your.dll /out:reflection.org
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\ApplyVSDocModel.xsl" reflection.org /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\AddFriendlyFilenames.xsl" /out:reflection.xml
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\ReflectionToManifest.xsl" reflection.xml /out:manifest.xml
call "C:\Program Files\Sandcastle\Presentation\vs2005\copyOutput.bat"
BuildAssembler /config:sandcastle.config manifest.xml
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\ReflectionToChmProject.xsl" reflection.xml /out:Output\test.hhp
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\createvstoc.xsl" reflection.xml /out:toc.xml
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\TocToChmContents.xsl" toc.xml /out:Output\test.hhc
XslTransform /xsl:"C:\Program Files\Sandcastle\ProductionTransforms\ReflectionToChmIndex.xsl" reflection.xml /out:Output\test.hhk
"C:\Program Files\HTML Help Workshop\hhc.exe" Output\test.hhp

  回复  引用    
#8楼  2007-07-03 14:29 风云      
晕,我也以为是Castle,并且以为是密切关注的新版Castle MVC Framework - castle.Igloo 发布了,哈哈!
  回复  引用  查看    
#9楼  2007-07-06 15:29 kiki [未注册用户]
到底怎么解决啊 能说清楚点儿嘛 多谢了
  回复  引用    
#10楼  2007-07-06 15:30 kiki [未注册用户]
Error: BuildAssembler: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.IO.DirectoryNotFoundException: 未能找到路径“C:\Program Files\Sandcastle\Data\Cpref_reflection”的一部分。


这个问题 能具体讲解下嘛 很急切 多谢
  回复  引用    
#11楼  2007-08-14 22:03 4745 [未注册用户]
@大奔
我也有同样的问题,你时怎么解决的,请回复到我的邮箱，谢谢,haoyn@dhc.com.cn
  回复  引用    
#12楼  2007-11-05 16:51 chuan [未注册用户]
Error: BuildAssembler: An error occured while initializing the build component 'Microsoft.Ddue.Tools.CopyFromIndexComponent' in the component assembly 'C:\Program Files\Sandcastle\ProductionTools\BuildComponents.dll'. The error message and stack trace follows: System.IO.DirectoryNotFoundException: 未能找到路径“C:\Program Files\Sandcastle\Data\Cpref_reflection”的一部分。

msdn讲的新版的Sandcastle里面的改动 应该是文件名称更改了
Changed:

<data files="%DXROOT%\Data\cpref_reflection\*.xml" />

To:

<data base="%DXROOT%\Data\Reflection" recurse="true" files="*.xml" />



1. The reflection files are moved to data\reflection;

2. Support reading files recursively.

  回复  引用    

标题  
姓名  
主页
Email (只有博主才能看到) 
验证码 *  看不清,换一张 [登录][注册]
内容(请不要发表任何与政治相关的内容)  
  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      
该文被作者在 2007-06-22 16:01 编辑过
 
另存  打印
最新IT新闻:
· 奥运核心资源被分食 搜狐央视网谁忽悠谁？
· 微软推新型搜索技术"BrowseRank"挑战谷歌
· 2008年7月26日IT博客精选
· 微软每年向Apache捐10万美元支持开源软件
· AOL将关闭3个网站以降低成本 集中发力广告
博客园新闻频道  博客园首页  社区
 


Copyright ©2008 沉睡海洋 Powered by: 博客园 模板提供：沪江博客

自2007年7月10日起