¿Es posible generar un conjunto de páginas wiki a partir del archivo de comentario XML generado por Visual Studio?¿Es posible wikify comentarios de Visual Studio XML?
Estoy hablando de algo así como Sandcastle, pero para formato wiki en lugar de compilado CHM.
Editar: Estoy usando MediaWiki que puede importar/exportar artículos en XML. Así que espero que sea posible escribir una transformación convirtiendo los comentarios XML en XML de MediaWiki.
lo recomiendo una solución poco diferente:
<see href="..."> para enlazar páginas Wiki de comentarios XMLEsto no es exactamente lo que quería, pero espero que esto sea útil.
Gracias. Esta no es la solución completa que estaba buscando, pero es mucho más útil que la respuesta doxygen sin sentido. – Dmitry
Si los elementos mencionados anteriormente no son suficientes, ¿ha intentado simplemente construir su propia transformación XSLT en el marcado wiki de su elección?
Puede escribir una aplicación simple en .NET (o elegir la plataforma que prefiera) para transformar el formato XML del documento al formato XML de wiki. Todavía tendría que mantener la wiki actualizada manualmente con los archivos de salida.
Sí, debería funcionar. Pero requiere tiempo y recursos humanos que no tengo cajero automático. – Dmitry
Como en una migración única de XML en línea a XML de MediaWiki? Porque no veo cómo mantendrá ambos sincronizados si va a mantener los comentarios XML en línea Y permitirá a los usuarios editar MediaWiki. –
Las páginas wiki con documentación técnica no deben ser editadas por los usuarios, excepto las clases principales desarrolladas hace años y que ya no se modificarán. Hay artículos generales que describen las clases y su uso, solo quiero agregar un enlace a la referencia de programación detallada. – Dmitry
¿Qué ganas al tenerlo en una wiki? El principal beneficio de una wiki es que es fácilmente editable. Sin embargo, no tiene la intención de editar las páginas de forma manual. Realmente parece que el mejor enfoque es simplemente no usar una wiki y colocar directamente los archivos en el servidor en una carpeta cercana a la wiki. – Yuliy