World Library  
Flag as Inappropriate
Email this Article

Microsoft Assistance Markup Language

Article Id: WHEBN0002851798
Reproduction Date:

Title: Microsoft Assistance Markup Language  
Author: World Heritage Encyclopedia
Language: English
Subject: Sandcastle (software), Online help, Windows Vista, Markup languages, FHTML
Collection:
Publisher: World Heritage Encyclopedia
Publication
Date:
 

Microsoft Assistance Markup Language

Microsoft Assistance Markup Language (Microsoft AML, generally referred to as MAML) is an XML-based markup language developed by the Microsoft User Assistance Platform team to provide user assistance ("online help") for the Microsoft Windows Vista operating system. MAML is also used to provide help information for PowerShell Cmdlets, modules and advanced functions.

MAML is a departure from all previous types of user assistance for Windows operating systems. Some of its features have been available in .NET Framework 2, but more options shipped with the release of .NET Framework 3. Previously, user assistance for Windows operating systems used files created with a command line compiler (hhc.exe). This compiler is used to compile a .hhp (project) file, .hhc (table of contents) file, .hhk (index) file, and a collection of HTML topic files and the related resources (CSS, JavaScript, and image files) into one .chm file.

The most significant aspect of MAML is that it shifts the production of user assistance to the concept of structured authoring (somewhat similar to DITA or DocBook). Documents and their constituent elements are defined by their context. With MAML, the emphasis is on content and the tasks a user performs with a computer, not the features of the software. Presentation is managed as part of the rendering engine when a user requests a topic.

The MAML authoring structure is divided into segments related to a type of content: conceptual, FAQ, glossary, procedure, reference, reusable content, task, troubleshooting, and tutorial. At present, there are no Microsoft released automated tools to assist in the creation of MAML - you need to create the XML files by hand.

Three levels of transformation occur when a topic is displayed: structure, presentation, and rendering:

  • The structural transformation contains reusable content and applies conditional logic to determine the structure that content should take when it is displayed, and the content of the text itself.
  • The presentation transformation enables content authored in MAML to use many different formats, including DHTML, XAML, RTF, and printed material.
  • The rendering transformation applies style sheets and displays the final content to users.

Unfortunately, there is no decent tool available for IT Pros to author MAML. You can use Notepad (which is pretty tedious). James O'Neil (former MSFT employee) shows you how you can use InfoPath to author this information (see: http://blogs.technet.com/b/jamesone/archive/2009/07/24/powershell-on-line-help-a-change-you-should-make-for-v2-3-and-how-to-author-maml-help-files-for-powershell.aspx but this is far from perfect as his article suggests.

See also

References

External links

  • Microsoft Vista User Experience Guidelines at the MSDN Library
  • Assistance Platform Team Blog at the Microsoft Developer Network (discontinued)
  • Sandcastle MAML Guide
  • Help-Info: Information around Online Help (Microsoft), Examples, ..
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and USA.gov, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for USA.gov and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
 
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
 
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.
 


Copyright © World Library Foundation. All rights reserved. eBooks from Project Gutenberg are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.