Anand has released yet a new version of the Sandcastle CTP. The November CTP has a couple of fixes and includes support for friendly HTM file names.
I've updated the MSBuild script for Sandcastle with this support and I have also moved into my new CodePlex site.
So, the download is now found at:
http://www.codeplex.com/Release/ProjectReleases.aspx?ProjectName=MSBuildSandcastle&ReleaseId=1029
New in this version:
- Support for Sandcastle November CTP
- In your Documentation.proj-file, you can now add an entry specifying that you want to use Friendly HTM-file names. (See the sample Documentation.proj file in SandcastleTest.zip)
Installation instructions:
- If you haven't already done so, install the Sandcastle November CTP.
The scripts rely on a completly unmodified installation, so don't make
any changes to it (especially not the sandcastle.config file).
- Unzip the contents of Sandcastle.zip to your MSBuild folder (usually c:\Program Files\MSBuild)
- Unzip the contents of SandcastleTest.zip to wherever you like to keep your sample projects.
- Open up the SandcastleTest.sln solution file and build the project.
- Open a Visual Studio 2005 Command prompt, navigate to the SandcastleTest folder and run the one of the following commands:
- MSBuild Documentation.proj
To build both a CHM and an HxS file
- MSBuild Documentation.proj /t:DocumentationNew
To build an HxS file.
- MSBuild Documentation.proj /t:Documentation
To build a CHM file.
- Cross your fingers, and when the process is finished, look for the Help\SandcastleTest.chm and/or the Help\SandcastleTest.HxS files!
- In order to actually view an HxS-file you'll need to register it with MSHelp. Or, an easier way (just to see that it works) is to use the free H2Viewer-utility.