Warning on .topic file

Feb 1, 2008 at 6:29 PM

I am defining a simple .topic file as the main page of my help document. The help file is generated ok, but when I open the .topic file with Visual Studio 2005, I receive the following warning:

"The root element name must match the DocType name 'bodyText'."

Also, my logo image always appear on the left side of my title, though I had the placement tag defined as "above".

That's my .topic file, based on a sample in the SHFB help:

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE bodyText [
<!ENTITY nbsp " ">

<topic xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<!-- Add a logo -->
<logoFile filename="logo_index.gif" altText="My Logo" placement="above" alignment="left" />
<!-- The page title -->
<!-- The body text for the topic -->
This is the main topic of that help file </bodyText>

Is there any fault on the above .topic file?

Feb 1, 2008 at 6:42 PM
Wrong project, you need to post SHFB stuff over in the discussion forum at http://www.codeplex.com/SHFB.

Anyway, the warning is normal and you can ignore it. Visual Studio is just trying to apply its rules for XML to the file. It will still get transformed okay when you build the help file. Regarding logo placement, I only support left aligned right now. I haven't had time to add support for other placement styles yet. You can edit the template or modify it to create your own if you need it for now.