¿Es posible combinar dos páginas creadas por SandCastle en una sola página principal?

Question

Para cada clase en el proyecto, castillo de arena crea (entre otros) dos páginas:

• La página principal, llamado como T_class_full_name, con la descripción, la sintaxis, y la Jerarquía de herencia Véase también
• La página de miembros, llamados como AllMembers_T_class_full_name, con constructores, métodos, campos, etc.

¿Hay una manera de combinar estos dos juntos - con el members page que se adjuntan a la página principal

Answer 1

No puedo dar una respuesta de trabajo para esto, pero puedo ofrecer algunas ideas que pueden funcionar si alguien está dispuesto a cortar un rato con él:

1. El htmlBody.xsl configuración define parte de la estructura que incluye una sección con una prueba para los miembros: <xsl:if test="$subgroup='members'"> Si esto se puso en marcha a nivel de clase (o simplemente establece en true, te puede dar una idea de cómo se produjo esa salida (E. no creo que haya un ajuste de aquí) bala mágica.

2. aquí es (creo) donde se añaden enlaces a los subgrupos de miembros, también me jugar un poco con esto:

<!-- add a link to the member list section for this subgroup -->
<a href="#{$elementVisibility}Toggle" onclick="OpenSection({$elementVisibility}Toggle)">

3. Tengo otras ideas tratando de jugar un poco con la estructura, pero tendrían que cortar por lo que proporciona ninguna respuesta clara. No estoy ni siquiera cerca de asegurarse de que el htmlBody.xsl es el lugar para hacerlo. Si en realidad tenía una necesidad aquí creo que podría lograr su objetivo más fácil de la siguiente manera:

• Generar la documentación de la manera estándar
• Analizar la documentación generada y fusionar los dos usando un / analizador XML DOM (es decir, combinar los dos en código y salida de un nuevo documento de una sola página HTML con las URL actualizadas a los anclajes de la página actual)

Lo bueno es que hay un esquema de nomenclatura coherente utilizado en los archivos generados y enlaces, por lo que podría pensar que sería más fácil de escribir este proceso y actualizar todos los enlaces a estar anclas de lo que sería perder el tiempo demasiado con las plantillas. De hecho, creo que esto sería bastante fácil de lograr para alguien con experiencia en ese tipo de manipulación de documentos.

Advertencia: No estoy ni siquiera cerca de un experto en castillo de arena, que tiene solamente utilizado mínimamente y hace más de un año. Tampoco he pasado en cualquier momento antes de hoy teniendo en cuenta cómo iba a entrar ilegalmente en él, solamente usarlo fuera de la caja. Que ni siquiera han respondido a esta excepción de la falta de otras respuestas. Puede ser una forma de configuración con el apoyo de lograr esto, pero como un usuario casual ni siquiera se puede pensar en cómo acercarse a ella.

También estoy haciendo algunas suposiciones acerca de cómo aquí la salida HTML se vería en base a mi experiencia con el SHFB. Puede que sea más largo alcance allí también. Ya no tengo un proyecto que pueda generar la documentación castillo de arena, pero si alguien puede enviar un enlace a alguna salida HTML de SandCastle y está interesado en este enfoque estaría feliz de ayudar aún más.