Sandcastle Help File Builder No se puede encontrar la fuente de documentación

Question

Estoy compilando el documento de un proyecto VS 2010 C# con el Creador de archivos de ayuda de Sandcastle. He agregado la documentación .xml generada por el compilador y el archivo de solución .sln de Visual Studio del proyecto a Fuentes de documentación. También he agregado el ejecutable del proyecto .exe a Referencias. Sin embargo, no está construyendo. Llego avisos y errores:

SHFB: advertencia BE0006: No se puede encontrar ninguna fuente de documentación para 'C: \ Users \ usuario \ Música \ Documents \ Visual Studio 2010 \ Projects \ SFML_Platformer \ SFML_Platformer.sln '(Configuración: Plataforma de depuración: Cualquier CPU)

SHFB: BE0042 de error: debe especificar al menos una fuente de documentación en forma de un archivo de solución de Visual Studio/proyecto

montaje o ¿Cuál es la ¿problema?

Answer 1

Debería agregar los archivos de documentación XML como Fuente del documento. Los dll se agregan automáticamente después de agregar los archivos XML.

Answer 2

Aquí la respuesta de Eric a.k.a EWoodruff el desarrollador de Sandcastle Help File Builder.

BE0006 significa que no pudo encontrar la fuente de documentación basada en el proyecto . BE0042 es un resultado secundario de ese significado que encontró nada en absoluto para documentar. ¿Qué tipo de proyectos se encuentran en la solución ? Si se trata de un proyecto de sitio web, tenga en cuenta que generalmente no producen ningún conjunto que se enumere como resultado en el proyecto ni ningún archivo de comentarios XML. En ese caso, deberá agregar los proveedores de códigos web a su proyecto para obtener los comentarios XML y agregar manualmente la carpeta. \ Bin del sitio web como fuente de documentación en el proyecto SHFB. Hay un tema sobre la documentación de sitios web en la sección Introducción de si ese es el caso.

Todos los demás tipos de proyectos deberían funcionar. Si todo lo demás falla, intente agregar el ensamblaje y los archivos de comentarios XML directamente. Supongo que es posible las ediciones Express usan tipos de proyectos diferentes. Si puede enviarme el archivo de solución y el archivo de proyecto, puedo echarles un vistazo y ver por qué no encuentra los objetivos. Mi dirección de correo electrónico está en el cuadro Acerca de en la GUI independiente y en el pie de página de las páginas del archivo de ayuda .

Otra cosa, asegúrese de que los ajustes de configuración y la plataforma seleccionada en la barra de herramientas SHFB coinciden con los ajustes de configuración y plataforma utilizada para construir su proyecto (es decir Depuración/Cualquier CPU, LANZAMIENTO/Cualquier CPU, depuración/x86, etc) . Si no, eso hará que no encuentre los objetivos de salida adecuados.

Eric

source

Answer 3

tuve este problema se produce cuando cambié de construcción del proyecto en VS.NET en mi aplicación principal Debug-Release. Supongo que ya no podría encontrar el .dll que había especificado para crear la documentación. Podría haber arreglado el mapeo, pero volviendo al Debug me funcionó bien para eliminar este error.

Answer 4

No se olvide de reconstruir su solución después de la limpieza antes de ejecutar Construir en castillo de arena.