Notice when I search for the common term like "Button" I get a lot of similar search results. Microsoft do two things to help users distinguish between the various search results.
Microsoft.Help.TopicVersionThis key is available in both HV1 (VS 2010 help) and HV2 (VS 2012 help). It is used internally by Microsoft and has limited use to 3rd party authors. If a topic contains the following meta statement then the help engine displays a version string according to the version number specified. <meta name="Microsoft.Help.TopicVersion" content="some version number" /> This table from the MSDN web site thirdBlogFromTheSun.com shows allowed version numbers and the corresponding version text displayed. Microsoft.Help.TopicVersion does not allow free text so this tag is limited in value.
ExampleTopic files containing <meta name="Microsoft.Help.TopicVersion" content="100" /> will show the text "Version: .NET Framework 4" appended to that topic's info when it appears in search results (see 3rd search result item in screen shot above). This key is new to HV2 (VS 2012 help) and allows you to output custom version text under each topic's search results. Here's an example of the meta tag you would put in your topics header. <meta name="Microsoft.Help.DisplayVersion" content="ACME control library 2.0" /> ExampleI've created a small help file of South Park characters. Each topic contains the meta string <meta name="Microsoft.Help.DisplayVersion" content="South Park v 1.0" /> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>South Park - Eric Cartman</title> <link href="ms-xhelp:///?method=asset&id=XyzStyles.css&package=FABRIKAM_SOUTHPARK_EXAMPLE.mshc&topiclocale=EN-US" rel="stylesheet" type="text/css" /> <script src="ms-xhelp:///?method=asset&id=XyzScript.js&package=FABRIKAM_SOUTHPARK_EXAMPLE.mshc&topiclocale=EN-US" type="text/javascript"></script> <meta name="Description" content="South Park character Eric Cartman" /> <meta name="Microsoft.Help.Locale" content="en-us" /> <meta name="Microsoft.Help.TopicLocale" content="en-us" /> <meta name="Microsoft.Help.SelfBranded" content="true" /> <meta name="Microsoft.Help.Id" content="SouthPark.EricCartman" /> <meta name="Microsoft.Help.TOCParent" content="SouthPark.Index" /> <meta name="Microsoft.Help.TocOrder" content="1" /> <meta name="Microsoft.Help.Keywords" content="South Park" /> <meta name="Microsoft.Help.Keywords" content="South Park, Eric Cartman" /> <meta name="Microsoft.Help.Keywords" content="Eric Cartman" /> <meta name="Microsoft.Help.Keywords" content="South Park - Eric Cartman" /> <meta name="Microsoft.Help.F1" content="EricCartman" /> <meta name="Microsoft.Help.Category" content="Source Help" /> <meta name="Microsoft.Help.DisplayVersion" content="South Park v 1.0" /> </head> <body> <h1>Eric Cartman</h1> ... When we search for text "South Park" you can now see that all my South Park topic search results now appended with an extra line in italics Version: South Park v 1.0 |
MS Help Viewer >