2012-02-03 15 views
5

He estado usando castillo de arena junto con la Ayuda Sandcastle Archivo Builder y por defecto se ofrece tres estilos de presentación: hana, prototipo y VS2005.¿Puede Sandcastle generar documentación HTML con el último estilo de MSDN?

Aunque el estilo vs2005 se ve bien, me gusta especialmente el último estilo liviano de MSDN. ¿Hay alguna manera de configurar Sandcastle para que se genere documentación con este estilo?

Respuesta

5

Las respectivas políticas de producto de Microsoft/estrategias son de hecho un poco extraño y hasta cierto punto en desacuerdo con el paso a un proceso de desarrollo más abierto en los últimos años - Documentation comments, SandCastle and new documentation transforms es una buena perorata que resume el estado oficial de los asuntos.

Dicho esto, no parece haber una solución no oficial (y por lo tanto legalmente cuestionable desafiado, véase más adelante) disponibles: Proyecto sandcastle-presentationtiene como objetivo crear nueva plantilla de presentación para el castillo de arena que va a generar la documentación en el estilo de MSDN Marca liviana

En particular, se apunta a la integración con el muy recomendable Sandcastle Help File Builder (SHFB), que aborda otros déficits mencionados en rant antes mencionado, a saber, que fue creado para rellenar los huecos, proporcionar las características NDoc-como faltantes que se utilizan más a menudo y proporcionar herramientas gráficas y basadas en línea de comandos para crear un archivo de ayuda de manera automática.

Por favor revise la discusión SHFB hilo MSDN presentation style available on google code! para diferentes puntos de vista sobre la legalidad de castillo de arena-presentación uso y hacer su propio juicio en consecuencia.

Cuestiones relacionadas