Из Википедии, бесплатной энциклопедии
Перейти к навигации Перейти к поиску

Язык разметки Microsoft Assistance ( Microsoft AML , обычно именуемый MAML ) - это язык разметки на основе XML, разработанный группой Microsoft User Assistance Platform для оказания помощи пользователям («интерактивная справка») для операционной системы Microsoft Windows Vista . Он составляет платформу поддержки в Windows Vista.

MAML также используется для предоставления справочной информации для командлетов, модулей и дополнительных функций PowerShell V2. [1]

Концепция [ править ]

MAML - это отход от всех предыдущих типов помощи пользователю для операционных систем Windows. Некоторые из его функций были доступны в .NET Framework 2, но с выпуском .NET Framework 3 было добавлено больше возможностей. Ранее для помощи пользователям операционных систем Windows использовались файлы справки Microsoft Compiled HTML Help , которые содержат мало семантической информации, удобочитаемой машиной.

Наиболее важным аспектом MAML является то, что он переносит производство помощи пользователям на концепцию структурированного авторинга (что-то вроде DITA или DocBook ). Документы и их составные элементы определяются их контекстом. В MAML упор делается на контент и задачи, которые пользователь выполняет с компьютером, а не на функции программного обеспечения. Когда пользователь запрашивает тему, управление презентацией осуществляется как часть механизма визуализации.

Структурированная функция MAML означает, что он также может выражать широкий спектр активных концепций. [2] Одной из примечательных функций является управляемая справка (мастер активного содержимого), которая позволяет файлу справки либо запускать задачу автоматически, либо выделять части экрана, с которыми пользователь должен взаимодействовать, шаг за шагом. Эта функция считалась изюминкой Project Longhorn, но Microsoft решила не включать ее в окончательный выпуск Vista. [3]

Структура авторской разработки MAML разделена на сегменты, относящиеся к типу контента: концептуальный, часто задаваемые вопросы , глоссарий, процедура, справочник, повторно используемый контент, задача, устранение неполадок и учебник.

Презентация [ править ]

При отображении темы происходят три уровня преобразования: структура, представление и визуализация:

  • Структурное преобразование содержит повторно используемый контент и применяет условную логику для определения структуры, которую контент должен принимать при отображении, и самого контента текста.
  • Преобразование представления позволяет контенту, созданному в MAML, использовать множество различных форматов, включая DHTML , XAML , RTF и печатные материалы.
  • Преобразование визуализации применяет таблицы стилей и отображает конечное содержимое для пользователей.

Авторские [ править ]

В настоящее время Microsoft не выпускает автоматизированных инструментов для помощи в создании MAML - вам нужно создавать файлы XML вручную.

К сожалению, у ИТ-специалистов нет подходящего инструмента для создания MAML. Вы можете использовать Блокнот (что довольно утомительно). Джеймс О'Нил (бывший сотрудник MSFT) показывает вам, как можно использовать InfoPath для создания этой информации, но это далеко не идеально, как предполагает его статья. [1]

Форматировать [ редактировать ]

Формат файла справки h1s вместе со средством просмотра HelpPane находится в Windows Vista и Windows 7. Формат аналогичен формату Microsoft Help 2 hxs. [4] Существует сторонний инструмент «xHelpMarkup» для компиляции и декомпиляции, но он является лишь оболочкой для инструментов BDD 2007 apcompnt и apss.dll.

См. Также [ править ]

  • Онлайн помощь
  • Скомпилированная справка Microsoft HTML
  • WinHelp
  • MHTML
  • замок из песка

Ссылки [ править ]

  1. ^ a b О'Нилс, Джеймс (4 марта 2016 г.). «Онлайн-справка PowerShell: изменение, которое вы должны сделать для V2 (№3) (и Как создавать файлы справки MAML для PowerShell) - блог Джеймса О'Нила - Домашняя страница сайта - Блоги TechNet» . Архивировано из оригинала на 2016-03-04.
  2. ^ "Основные моменты справки Microsoft" Longhorn " . WritersUA .
  3. ^ «Управляемая помощь» . BetaArchive .
  4. ^ «Справка AP - Техническая информация» . www.help-info.de .

Внешние ссылки [ править ]

  • Рекомендации по работе с Microsoft Vista в библиотеке MSDN
  • Блог группы поддержки платформы поддержки в сети разработчиков Microsoft (прекращено)
  • Путеводитель по песочному замку MAML
  • Help-Info.de Документация MAML