Genere un archivo de ayuda de Sandcastle para un sitio web sin la opción "Archivo de documentación XML"

Question

Estoy intentando generar un archivo de ayuda de Sandcastle para un sitio web.En la ventana de propiedades del proyecto, no hay opciones para crear el archivo de documentación XML necesario para Sandcastle.

La pestaña Construir en las páginas de propiedades solo contiene opciones para:Iniciar acción, crear acción de solución y validación de accesibilidad.No tengo ninguna opción para Salida o archivo de documentación XML, como tienen mis otros proyectos.

El sitio web con el que estoy trabajando no tiene un archivo .proj real, lo que podría ser el problema.Si este es el problema, ¿cuál es la mejor manera de crear uno para un proyecto que está bajo control de código fuente y en el que trabajan muchas personas con una interrupción mínima?

Esto está utilizando Visual Studio 2005 profesional.

Answer 1

El problema con los sitios web en VS2k5 es que, cuando se compilan, los archivos DLL resultantes son un desastre.Sin espacios de nombres, nombres raros, etc.

Si realmente desea generar un archivo de ayuda de Sandcastle, considere convertir su sitio web en una aplicación web.Definitivamente puedes generar documentos de código fuente para eso.

Answer 2

No lo he probado todavía, pero quizás quieras probar lo siguienteDocumentación de sitios web/proyectos del sitio de Eric Woodruff.Proporciona los detalles sobre cómo se puede hacer.

Actualizar:Lo probé y funciona para sitios web normales.El único problema que puedo ver es que los sitios web no tienen espacios de nombres.Entonces, cuando lo ejecuto, obtengo un tema de FolderName_WebPage Class Format sin ninguna agrupación lógica.Entonces es alhpabetical por carpeta y nombre de página.Una vez que haya creado el contenido, puede editar el archivo de ayuda utilizando un HelpCompiler / Builder y agrupar los temas según sea necesario.