.net - tarda - ¿Es posible fusionar dos páginas creadas por SandCastle en una sola página principal?
fusionar paginas de facebook método que si funciona (1)
Para cada clase en el proyecto, SandCastle crea (entre otras) dos páginas:
- La página principal, llamada
T_class_full_name, con la descripción, sintaxis, jerarquía de herencia y ver también - La página de miembros, llamada
AllMembers_T_class_full_name, con constructores, métodos, campos, etc.
¿Hay alguna forma de fusionar estos dos elementos, con la members page adjuntada a la página principal?
No puedo proporcionar una respuesta funcional para esto, pero puedo ofrecer algunas ideas que pueden funcionar si alguien está dispuesto a hackearlas:
1. La configuración htmlBody.xsl define parte de la estructura, incluida una sección con una prueba para miembros: <xsl:if test="$subgroup=''members''"> Si esto se activó en el nivel de clase (o simplemente se configuró en es cierto que podría darle una idea de cómo se produce esa salida. (No creo que haya una configuración mágica aquí).
2. Aquí está (creo) donde se agregan enlaces a los subgrupos de miembros, también jugaría 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 con la estructura, pero tendría que hackearla para proporcionar una respuesta clara. Ni siquiera estoy seguro de que htmlBody.xsl sea el lugar para hacer esto. Si realmente tuviera una necesidad aquí, creo que podría lograr su objetivo más fácilmente haciendo lo siguiente:
- Genere la documentación de la manera estándar
- Analice la documentación generada y combine los dos utilizando un analizador DOM / XML (es decir, combine los dos en el código y genere un nuevo documento HTML de una sola página con las URL actualizadas en los anclajes de la página actual)
Lo bueno es que hay un esquema de nombres consistente utilizado en los archivos y enlaces generados, así que creo que sería más fácil escribir este proceso y actualizar todos los enlaces para que sean anclajes de lo que sería perder 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: ni siquiera estoy cerca de un experto en SandCastle, ya que solo lo he usado mínimamente y hace más de un año. Tampoco he pasado en cualquier momento antes de hoy teniendo en cuenta cómo lo piratearía, solo usándolo de la caja. Ni siquiera habría respondido a esto excepto por la falta de otras respuestas. Puede haber una forma de configuración compatible para lograr esto, pero yo, como usuario ocasional, ni siquiera puedo pensar cómo abordarlo.
También estoy haciendo algunas suposiciones aquí sobre cómo se vería el resultado HTML en función de mi experiencia con SHFB. También podría llegar demasiado lejos allí. Ya no tengo un proyecto del cual pueda generar documentación de castillos de arena, pero si alguien puede publicar un enlace a algún resultado HTML de SandCastle y está interesado en este enfoque, me complacerá ayudarlo.