Sandcastle - March 2007 CTP(-.-)

Sandcastle - March 2007 CTPがリリースされています。

• Sandcastle - March 2007 Community Technology Preview (CTP)

今回のCTPでは、VS2005とそれ以前のVisual StudioでXSLが分けられている。この変更によって、いくつかのXSLが追加、削除されているので注意が必要。

以下にMarch 2007 CTP用のNAntのビルドスクリプトを書いておく。

...
<!-- SandCastle構成 -->
<!-- ディレクトリ -->
<property name="sandcastle.dir" value="${programfiles.dir}\Sandcastle" />

<!-- 実行ファイル -->
<property name="sandcastle.mrefbuilder.exe" value="${sandcastle.dir}\productiontools\mrefbuilder.exe" />
<property name="sandcastle.buildassembler.exe" value="${sandcastle.dir}\productiontools\buildassembler.exe" />
<property name="sandcastle.xsltransform.exe" value="${sandcastle.dir}\productiontools\xsltransform.exe" />

<!-- 変換用XSLファイル -->
<property name="sandcastle.applyvsdocmodel.xsl" value="${sandcastle.dir}\ProductionTransforms\ApplyVSDocModel.xsl" />
<property name="sandcastle.addfriendlyfilenames.xsl" value="${sandcastle.dir}\ProductionTransforms\AddFriendlyFilenames.xsl" />
<property name="sandcastle.applyprototypedocmodel.xsl" value="${sandcastle.dir}\ProductionTransforms\ApplyPrototypeDocModel.xsl" />
<property name="sandcastle.addguidfilenames.xsl" value="${sandcastle.dir}\ProductionTransforms\AddGuidFilenames.xsl" />
<property name="sandcastle.reflectiontomanifest.xsl" value="${sandcastle.dir}\ProductionTransforms\ReflectionToManifest.xsl" />
<property name="sandcastle.reflectiontochmproject.xsl" value="${sandcastle.dir}\ProductionTransforms\ReflectionToChmProject.xsl" />
<property name="sandcastle.createvstoc.xsl" value="${sandcastle.dir}\ProductionTransforms\CreateVSToc.xsl" />
<property name="sandcastle.createprototypetoc.xsl" value="${sandcastle.dir}\ProductionTransforms\CreatePrototypeToc.xsl" />
<property name="sandcastle.toctochmcontents.xsl" value="${sandcastle.dir}\ProductionTransforms\TocToChmContents.xsl" />
<property name="sandcastle.reflectiontochmindex.xsl" value="${sandcastle.dir}\ProductionTransforms\ReflectionToChmIndex.xsl" />

<!-- ヘルプコンパイラ -->
<property name="hhc.exe" overwrite="false" value="${programfiles.dir}\HTML Help Workshop\hhc.exe" />
...

<!-- SDKドキュメントの生成 -->
<target name="sdkdoc" depends="build" description="Builds SDK documentation">
  <property name="sandcastle.workingdir" value="${build.dir}/doc/sdk" />
  <property name="sandcastle.output.dir" value="${sandcastle.workingdir}/Output" />
  <property name="sandcastle.comments.dir" value="${sandcastle.workingdir}/comments" />

  <mkdir dir="${sandcastle.workingdir}" if="${not directory::exists(sandcastle.workingdir)}" />
  <mkdir dir="${sandcastle.output.dir}" if="${not directory::exists(sandcastle.output.dir)}" />
  <mkdir dir="${sandcastle.comments.dir}" if="${not directory::exists(sandcastle.comments.dir)}" />

  <!-- XMLコメントファイルのコピー -->
  <copy todir="${sandcastle.comments.dir}">
    <fileset basedir="${build.dir}/bin">
      <include name="${project::get-name()}.Core.xml" />
    </fileset>
  </copy>

  <!-- コンフィグレーションファイルをコピーして参照を書き換え -->
  <copy file="${sandcastle.dir}/Presentation/vs2005/Configuration/Sandcastle.config" tofile="${sandcastle.workingdir}/Sandcastle.config
    <filterchain>
      <replacestring from="&quot;%DXROOT%\" to="&quot;${sandcastle.dir}\" />
      <replacestring from="&quot;comments.xml" to="&quot;comments\*.xml" />
    </filterchain>
  </copy>

  <!-- MRefBuilderを実行 -->
  <exec program="${sandcastle.mrefbuilder.exe}" workingdir="${sandcastle.workingdir}">
    <arg value="${build.dir}\bin\${project::get-name()}.Core.dll" />
    <arg value="/out:reflection.org.xml" />
  </exec>

  <!-- reflection.xmlの作成 -->
  <if test="${nant.settings.currentframework == 'net-2.0'}">
    <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
      <arg value="/xsl:&quot;${sandcastle.applyvsdocmodel.xsl}&quot;" />
      <arg value="reflection.org.xml" />
      <arg value="/xsl:&quot;${sandcastle.addfriendlyfilenames.xsl}&quot;" />
      <arg value="/out:reflection.xml" />
    </exec>
  </if>
  <if test="${nant.settings.currentframework != 'net-2.0'}">
    <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
      <arg value="/xsl:&quot;${sandcastle.applyprototypedocmodel.xsl}&quot;" />
      <arg value="reflection.org.xml" />
      <arg value="/xsl:&quot;${sandcastle.addguidfilenames.xsl}&quot;" />
      <arg value="/out:reflection.xml" />
    </exec>
  </if>

  <!-- manifest.xmlの作成 -->
  <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
    <arg value="/xsl:&quot;${sandcastle.reflectiontomanifest.xsl}&quot;" />
    <arg value="reflection.xml" />
    <arg value="/out:manifest.xml" />
  </exec>

  <!-- 出力の準備 -->
  <mkdir dir="${sandcastle.output.dir}" />
  <mkdir dir="${sandcastle.output.dir}/html" />

  <if test="${nant.settings.currentframework == 'net-2.0'}">
    <copy todir="${sandcastle.output.dir}">
      <fileset basedir="${sandcastle.dir}/Presentation/vs2005">
        <include name="icons/*" />
        <include name="scripts/*" />
        <include name="styles/*" />
      </fileset>
    </copy>
  </if>
  <if test="${nant.settings.currentframework != 'net-2.0'}">
    <copy todir="${sandcastle.output.dir}">
      <fileset basedir="${sandcastle.dir}/Presentation/Prototype">
        <include name="icons/*" />
        <include name="scripts/*" />
        <include name="styles/*" />
      </fileset>
    </copy>
  </if>

  <!-- BuildAssemblerの実行 -->
  <exec program="${sandcastle.buildassembler.exe}" workingdir="${sandcastle.workingdir}" >
    <arg value="manifest.xml" />
    <arg value="/config:Sandcastle.config" />
  </exec>

  <!-- HTMLヘルププロジェクトの作成-->
  <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
    <arg value="/xsl:&quot;${sandcastle.reflectiontochmproject.xsl}&quot;" />
    <arg value="reflection.xml" />
    <arg value="/out:&quot;${sandcastle.output.dir}\test.hhp&quot;" />
  </exec>

  <!-- toc.xmlの作成 -->
  <if test="${nant.settings.currentframework == 'net-2.0'}">
    <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
      <arg value="/xsl:&quot;${sandcastle.createvstoc.xsl}&quot;" />
      <arg value="reflection.xml" />
      <arg value="/out:toc.xml" />
    </exec>
  </if>
  <if test="${nant.settings.currentframework != 'net-2.0'}">
    <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}">
      <arg value="/xsl:&quot;${sandcastle.createprototypetoc.xsl}&quot;" />
      <arg value="reflection.xml" />
      <arg value="/out:toc.xml" />
    </exec>
  </if>

  <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}" >
    <arg value="/xsl:&quot;${sandcastle.toctochmcontents.xsl}&quot;" />
    <arg value="toc.xml" />
    <arg value="/arg:html=Output\html" />
    <arg value="/out:&quot;${sandcastle.output.dir}\test.hhc&quot;" />
  </exec>

  <exec program="${sandcastle.xsltransform.exe}" workingdir="${sandcastle.workingdir}" >
    <arg value="/xsl:&quot;${sandcastle.reflectiontochmindex.xsl}&quot;" />
    <arg value="reflection.xml" />
    <arg value="/out:&quot;${sandcastle.output.dir}\test.hhk&quot;" />
  </exec>

  <!-- chmファイルの生成 -->
  <exec program="${hhc.exe}" commandline="test.hhp" workingdir="${sandcastle.output.dir}" failonerror="false"/>

  <copy file="${sandcastle.output.dir}/test.chm" tofile="${sandcastle.workingdir}/${project::get-name()}-SDK.chm" />>
  
  <delete>
    <fileset basedir="${sandcastle.workingdir}">
      <include name="**/*" />
      <exclude name="${project::get-name()}-SDK.chm" />
    </fileset>
  </delete>
</target>
...

via：Announcing March 2007 Sandcastle CTP