Sandcastle August CTP Released

The team behind Microsoft Sandcastle released a new CTP of Sandcastle yesterday. A couple of changes have been made to the components that will make the previous version of my MSBuild Script for Sandcastle fail. Therefore, you’ll need to download the latest version of the scripts if you want it to work with the August ...

Sandcastle Help Compiler 2 support

Update After installing the August CPT of Sandcastle, you’ll need to update to the latest version of the MSBuild script. I’ve just released a new version of the MSBuild-script for Sandcastle. There are two new features and one new (though optional) requirement. First of all, the new requirement is the Visual Studio .NET Help Integration ...

XML improvements in .NET Framework 2.0

I just found this rather interesting article on MSDN that describes what’s new in the System.Xml namespace for .NET Framework 2.0. The main points I took note of where: Always use the new factory methods for creating XmlReaders and XmlWriters (i.e. XmlReader.Create and XmlWriter.Create) Use XslCompiledTransform instead of XslTransform. Apparently, it compiles your XSLT into ...

Sandcastle under the hood, part 3

Welcome to part 3 of my Sandcastle under the hood-series. In part 2, which focused on all the different components available to use in the BuildAssembler, I promised you a walkthrough of the sandcastle.config that was delivered in the July CTP of Sandcastle. So here we go! Input to BuildAssembler First of all a reminder ...

Sandcastle under the hood, part 2

In my previous post, I talked you through the first steps of the Sandcastle build process. So far it’s been more or less simple xsl transforms, but now we’re getting to the fun part – the BuildAssembler. The BuildAssembler is actually just a small console application that runs an XML document through a configurable pipeline ...

Sandcastle under the hood, part 1

Well, today I’ve been diving into the innards of Sandcastle. In lack of proper documentation I’ve relied on ildasm, some trace output and some common sense. Now, I don’t know how much of this that is actually correct, but I suspect that at least most of it is rather close to the truth. Assuming you ...

Sandcastle behind the scenes

Are you, as I am, curious about what actually goes on behind the scenes in the Sandcastle BuildAssembler? Well, here’s a tip that will give you data enough to investigate it the entire weekend! Open up your sandcastle.config file and add the following line between each <component> node: <component type="Microsoft.Ddue.Tools.DisplayComponent" assembly="..\..\ProductionTools\BuildComponents\BuildComponents.dll"/> This component will make ...

Sandcastle Visual Studio Project

Final update Sorry, I’m not able to figure out what’s wrong with this, and since Frank has a better solution for Visual Studio integration, I’m cancelling this attempt. If you’re interested in the source code, send me an email! I think it’s better if I focus my efforts on the MSBuild script instead. Update 3 ...

Teaser: Sandcastle integrated in Visual Studio

As you may have seen in previous posts from me, I’ve created a MSBuild script that makes it easier to create Sandcastle documentation files. But hey, why stop there? Wouldn’t it be nice if the whole process was integrated in Visual Studio like all other products? Well, I couldn’t help myself, so I tried it ...

Sandcastle MSBuild script for non-English or non-default installations

Just thought I’d let you know how to modify the msbuild script from my last post to work with different setups. Instead of extracting the Sandcastle.zip file to c:\Program Files\MSBuild, extract it to the equivalent MSBuild folder (d:\Program\MSBuild or whatever) Open up the Sandcastle.targets file in any xml editor, and change the SandcastlePath property to ...