Lenguaje de marcado de asistencia de Microsoft

Este artículo se basa en gran parte o en su totalidad en una sola fuente . Se puede encontrar discusión relevante en la página de discusión . Por favor, ayude a mejorar este artículo introduciendo citas de fuentes adicionales . Buscar fuentes:  «Microsoft Assistance Markup Language» – noticias  · periódicos  · libros  · académico  · JSTOR ( noviembre de 2019 )

Microsoft Assistance Markup Language ( Microsoft AML , MAML ) es un lenguaje de marcado basado en XML desarrollado por el equipo de la Plataforma de asistencia al usuario de Microsoft para proporcionar asistencia al usuario (" ayuda en línea ") para el sistema operativo Microsoft Windows Vista . Constituye la Plataforma de asistencia en Windows Vista.

MAML también se utiliza para proporcionar información de ayuda para cmdlets, módulos y funciones avanzadas de PowerShell V2. ^[1]

MAML es un cambio con respecto a todos los tipos de asistencia al usuario anteriores para los sistemas operativos Windows. Algunas de sus funciones estaban disponibles en .NET Framework 2, pero se incorporaron más opciones con el lanzamiento de .NET Framework 3. Anteriormente, la asistencia al usuario para los sistemas operativos Windows utilizaba archivos de ayuda HTML compilados de Microsoft , que contienen poca información semántica legible por máquina.

El aspecto más significativo de MAML es que traslada la producción de asistencia al usuario al concepto de creación estructurada (de forma similar a DITA o DocBook ). Los documentos y sus elementos constitutivos se definen por su contexto. Con MAML, el énfasis está en el contenido y las tareas que un usuario realiza con una computadora, no en las características del software. La presentación se administra como parte del motor de renderizado cuando un usuario solicita un tema.

La característica estructurada de MAML significa que también puede expresar una amplia gama de conceptos activos. ^[2] Una característica notable es la ayuda guiada (asistente de contenido activo), que permite que el archivo de ayuda ejecute una tarea automáticamente o resalte las partes de la pantalla con las que un usuario debe interactuar paso a paso. La característica fue un aspecto notable del Proyecto Longhorn, pero Microsoft optó por no incorporarla en la versión final de Vista. ^[3]

La estructura de creación de MAML se divide en segmentos relacionados con un tipo de contenido: conceptual, preguntas frecuentes , glosario, procedimiento, referencia, contenido reutilizable, tarea, resolución de problemas y tutorial.

Cuando se muestra un tema se producen tres niveles de transformación: estructura, presentación y representación:

• La transformación estructural contiene contenido reutilizable y aplica lógica condicional para determinar la estructura que debe tomar el contenido cuando se muestra y el contenido del texto en sí.
• La transformación de presentación permite que el contenido creado en MAML se utilice en muchos formatos diferentes, incluidos DHTML , XAML , RTF y material impreso.
• La transformación de renderizado aplica hojas de estilo y muestra el contenido final a los usuarios.

No existen herramientas que ayuden a crear MAML; por lo tanto, los archivos XML deben crearse manualmente.

Se puede utilizar una aplicación como Notepad , Notepad++ o Infopath para crear manualmente contenido MAML. ^[1]

El contenido de MAML utiliza el formato de archivo de ayuda h1s, que, junto con el visor HelpPane, se encuentra en Windows Vista y Windows 7. El formato es similar a los archivos .hxs de Microsoft Help 2. ^[4] Existe una herramienta de terceros "xHelpMarkup" para compilar y descompilar, pero es solo un contenedor de las herramientas apcompnt y apss.dll de BDD 2007.

• MHTML
• Castillo de arena
• Ayuda para ganar

• Directrices de experiencia del usuario de Microsoft Vista en la biblioteca MSDN
• Blog del equipo de la plataforma de asistencia en la red de desarrolladores de Microsoft (discontinuado)
• Guía de castillos de arena MAML
• Documentación de Help-Info.de MAML