Microsoft アシスタンス マークアップ言語

Microsoft アシスタンス マークアップ言語( Microsoft AML、MAML ) は、Microsoft Windows Vistaオペレーティング システムにユーザー アシスタンス (「オンライン ヘルプ」)を提供するために Microsoft ユーザー アシスタンス プラットフォーム チームによって開発されたXMLベースのマークアップ言語です。これは、Windows Vista のアシスタンス プラットフォームを構成します。

MAMLはPowerShell V2コマンドレット、モジュール、高度な機能のヘルプ情報を提供するためにも使用されます。 ^[1]

MAML は、Windows オペレーティング システムのこれまでのすべてのタイプのユーザー アシスタンスとは一線を画しています。一部の機能は.NET Framework 2 でも使用可能でしたが、.NET Framework 3 のリリースではさらに多くのオプションが付属しています。以前は、Windows オペレーティング システムのユーザー アシスタンスでは、 Microsoft コンパイル済み HTML ヘルプファイルが使用されていましたが、これには機械で読み取り可能なセマンティック情報がほとんど含まれていませんでした。

MAML の最も重要な側面は、ユーザー支援の作成を構造化オーサリングの概念 ( DITAまたはDocBookに多少似ています) に移行していることです。ドキュメントとその構成要素は、コンテキストによって定義されます。MAML では、ソフトウェアの機能ではなく、コンテンツとユーザーがコンピューターで実行するタスクに重点が置かれています。プレゼンテーションは、ユーザーがトピックを要求すると、レンダリング エンジンの一部として管理されます。

MAML の構造化された特徴は、幅広いアクティブ コンセプトも表現できることを意味します。^[2]注目すべき機能の 1 つはガイド付きヘルプ (アクティブ コンテンツ ウィザード) です。これにより、ヘルプ ファイルでタスクを自動的に実行したり、ユーザーが段階的に操作する必要がある画面の部分を強調表示したりできます。この機能は Project Longhorn の注目すべき側面でしたが、Microsoft はこれを Vista の最終リリースに組み込まないことを選択しました。^[3]

MAML オーサリング構造は、概念、 FAQ、用語集、手順、リファレンス、再利用可能なコンテンツ、タスク、トラブルシューティング、チュートリアルなど、 コンテンツの種類に関連するセグメントに分かれています。

トピックが表示されるときには、構造、プレゼンテーション、レンダリングという 3 つのレベルの変換が行われます。

• 構造変換には再利用可能なコンテンツが含まれており、条件付きロジックを適用して、コンテンツが表示されるときにそのコンテンツがとるべき構造と、テキスト自体のコンテンツを決定します。
• プレゼンテーション変換により、MAML で作成されたコンテンツを、 DHTML、XAML、RTF、印刷物など、さまざまな形式で使用できるようになります。
• レンダリング変換では、スタイルシートが適用され、最終的なコンテンツがユーザーに表示されます。

MAML の作成を支援するツールはないため、XML ファイルを手動で作成する必要があります。

MAMLコンテンツを手動で作成するには、 Notepad、Notepad++、Infopathなどのアプリケーションを使用できます。^[1]

MAML コンテンツは、HelpPane ビューアとともに Windows Vista および Windows 7 に搭載されている h1s ヘルプ ファイル形式を使用します。この形式は、Microsoft Help 2 の.hxs ファイルに似ています。^[4]コンパイルおよび逆コンパイル用のサードパーティ製の「xHelpMarkup」ツールは存在しますが、これは BDD 2007 apcompnt および apss.dll ツールのラッパーにすぎません。

• ＭＨＴＭＬ
• 砂の城
• ウィンヘルプ

• MSDN ライブラリの Microsoft Vista ユーザー エクスペリエンス ガイドライン
• Microsoft Developer Network の Assistance Platform チーム ブログ (廃止)
• サンドキャッスル MAML ガイド
• Help-Info.de MAML ドキュメント