2008-09-20 11 views
12

En el trabajo utilizamos Sandcastle para la creación de archivos de ayuda. He estado usando SandCastleGUI durante un tiempo y estoy buscando una forma de crear páginas adicionales en el archivo de ayuda. Estas páginas están escritas en formato XML llamado MAML. El único problema es que no pude encontrar ningún editor decente para este formato de archivo.¿Alguien sabe de un buen editor de MAML?

Estoy buscando un editor WYSIWYG para crear & editar páginas adicionales de documentación.

+0

Esto realmente no es una respuesta, pero como se puede ver en [mi pregunta] (http: // stackoverflow.com/questions/101150/what-would-you-use-to-write-end-user-documentation-for-a-wpf-application) Tengo un interés en la experiencia con MAML en general y MAML particular con respecto a documentación del usuario final. Si tiene alguna experiencia con esto, sería genial si pudiera expresar sus pensamientos en su blog sobre el uso de MAML para la documentación del usuario final. – tronda

Respuesta

1

Finalmente encontré una solución que las buenas personas de SandCastle Help File Builder han incluido un convertidor de HTML a MAML.
Hay muchos buenos editores de HTML aquí, y ahora puedo usar uno de ellos y luego convertir el resultado a MAML

2

Puede usar un editor XML genérico con soporte WYSIWYG como Oxygen o Serna. Necesitarías un esquema Xml o DTD para MAML, supongo que hay uno en alguna parte de un SDK o similar. Probablemente la parte más difícil es que necesitaría una hoja de estilo que haga que el XML tenga un formato de visualización que pueda ser usado por el editor para proporcionar una vista WYSIWYG del documento.

Funciona bastante bien para formatos XML estándar como Docbook, pero no sé qué tan fácil es encontrar/crear las hojas de estilo necesarias para MAML. Pero, en general, no hay ninguna razón por la cual no podría hacerse.

+0

No es exactamente lo que tenía en mente: necesito un editor WYSIWYG para editar documentos para la ayuda, no estoy buscando un editor gráfico XML –

+0

Bueno, al menos estos editores le dan la edición WYSIWYG de las partes de texto de sus archivos de ayuda que se parece mucho a las capturas de pantalla de los enlaces de Gustavos. Es mejor que tener que escribir todo como XML sin procesar, pero no maneja cosas como compilarlo en archivos de ayuda reales, ... – sth

Cuestiones relacionadas