Como se indica a Scott Wylie, es necesario especificar esto en la línea de comandos del evento posterior acumulación en las propiedades del proyecto de Visual Studio. Sin embargo, sugeriría usar Sandcastle Help File Builder (SHFB) en lugar de Sandcastle directamente. Esto hace que la llamada de línea de comandos corta y simple como se muestra a continuación, pero tenga en cuenta que primero hay que configurar el proyecto SHFB con el SHFB interfaz gráfica de usuario, que crea un fichero de construcción compatible con msbuild con el ".shfbproj" sufijo:
C:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe
/p:Configuration=Release myProject.shfbproj
Sin embargo, cabe destacar que tomo el camino contrario de lo que está haciendo: en lugar de utilizar Visual Studio para poner en marcha de forma interactiva una acumulación y acciones auxiliares, utilizo hormiga (Nant) para poner en marcha una acumulación de todo, que incluye mis soluciones de Visual Studio y la acción posterior de SHFB. Así que esto es realmente la llamada de línea de comandos hago para construir la documentación con el castillo de arena:
<exec executable="${msbuild}" dir="${csharpdoc}" output="${csharpdoc.log}">
<arg value="/p:Configuration=Release"/>
<arg value="myProject.shfbproj"/>
</exec>
Mi preferencia es que toda la construcción debe ser iniciar desde la línea de comandos para que no haya interacciones requeridas (por ejemplo, poniendo en marcha Visual Studio , etc.) Eso proporciona la flexibilidad de ejecutarse como una tarea recurrente programada o bajo demanda desde el shell.
Por lo tanto, como se menciona en un comentario sobre otra respuesta, como un evento Post-Build en las propiedades normales de compilación de Visual Studio, agregué el comando para compilar el archivo SHFBPROJ con MSBuild (similar a lo que publicó en el primer fragmento de código). Sin embargo, al ejecutar la compilación, comenzó más de 1000 instancias de MSBuild.exe en el administrador de tareas y se bloqueó. ¿Alguna idea de por qué? –
BTW, la compilación cuando uso el Creador de Ayuda para compilarlo en lugar de MSBuild, demora unos 2 minutos. Agregarlo a la compilación de publicaciones se ejecutó durante más de una hora al 100% de utilización de la CPU hasta que finalmente lo maté. –
@JohnChapman: ¿A qué se refiere ese "Creador de ayuda"? ¿Es algo incluido en el paquete SHFB? –