HHC File and unorder list tags

[Tommy]

Question, but I beat my brains on this because it appears that I have
to conform to how the compiler is reading the hhc file, I am manually
editing the hhc file to create my table of contents.

I noticed that the <UL> and <LI> originally created were not quite in
HTML expected format where it doesn't use </LI> tags.

For example, AFAIK, this is correct usage

<UL>
<LI>xxxx</LI>
<LI>
<UL>
<LI>xxxx</LI>
<LI>xxx</LI>
</UL>
</LI>
</UL>

However, what is written is without </LI> terminating tags:

<UL>
<LI>xxxx
<LI>
<UL>
<LI>xxxx
<LI>xxx
</UL>
</UL>

Can I use the correct format without a problem or it going to create
issues?

The reason is that we create HTML files for the CHM creation but also
putting the HTML files on our web server. We have a utility to takes
the HHC to create a HTML file and my parser gets confused when its
using he HelpHTML format for HHC outlines.

Suggestions?

Thanks

[Rob Chandler [MVP]]

Hi Tommy
HHC and HHK files are Microsoft Sitemap format. The resemble HTML.

Ideally your conversion app should create 2 different files
- A) .HHC for HTML Help
- B) .HTM for the web. This one should have the </LI>

You can try adding the </LI> to the the HHC if you think it will make
life easier. Either it will work or it wont. There is no documentation
for sitemap format so you just have to try it.

Cheers
Rob
http://helpware.net/FAR/

Question, but I beat my brains on this because it appears that I have to
conform to how the compiler is reading the hhc file, I am manually
editing the hhc file to create my table of contents.
I noticed that the <UL> and <LI> originally created were not quite in HTML
expected format where it doesn't use </LI> tags.
For example, AFAIK, this is correct usage
<UL>
<LI>xxxx</LI>
<LI>
<UL>
<LI>xxxx</LI>
<LI>xxx</LI>
</UL>
</LI>
</UL>
<UL>
<LI>xxxx
<LI>
<UL>
<LI>xxxx
<LI>xxx
</UL>
</UL>
Can I use the correct format without a problem or it going to create
issues?
The reason is that we create HTML files for the CHM creation but also
putting the HTML files on our web server. We have a utility to takes the
HHC to create a HTML file and my parser gets confused when its using he
HelpHTML format for HHC outlines.
Suggestions?
Thanks

[Rob Cavicchio]

I've had quite a bit of experience auto-generating HHC files. Using closing
</li> tags does work fine, but there are some other "gotchas". One that
comes to mind is that the opening <li> tag and the opening <object> tag for
the entry *must* be on the same line of the file. Thus this works:

<li><object>

but ths does not:

<li>
<object>

Post by Rob Chandler [MVP]
Hi Tommy
HHC and HHK files are Microsoft Sitemap format. The resemble HTML.
Ideally your conversion app should create 2 different files
- A) .HHC for HTML Help
- B) .HTM for the web. This one should have the </LI>
You can try adding the </LI> to the the HHC if you think it will make
life easier. Either it will work or it wont. There is no documentation
for sitemap format so you just have to try it.
Cheers
Rob
http://helpware.net/FAR/

Question, but I beat my brains on this because it appears that I have to
conform to how the compiler is reading the hhc file, I am manually
editing the hhc file to create my table of contents.
I noticed that the <UL> and <LI> originally created were not quite in
HTML expected format where it doesn't use </LI> tags.
For example, AFAIK, this is correct usage
<UL>
<LI>xxxx</LI>
<LI>
<UL>
<LI>xxxx</LI>
<LI>xxx</LI>
</UL>
</LI>
</UL>
<UL>
<LI>xxxx
<LI>
<UL>
<LI>xxxx
<LI>xxx
</UL>
</UL>
Can I use the correct format without a problem or it going to create
issues?
The reason is that we create HTML files for the CHM creation but also
putting the HTML files on our web server. We have a utility to takes the
HHC to create a HTML file and my parser gets confused when its using he
HelpHTML format for HHC outlines.
Suggestions?
Thanks

[Rob Chandler [MVP]]

Ha! Thanks Rob

Post by Rob Cavicchio
I've had quite a bit of experience auto-generating HHC files. Using
closing </li> tags does work fine, but there are some other "gotchas". One
that comes to mind is that the opening <li> tag and the opening <object>
<li><object>
<li>
<object>

[Tommy]

Post by Rob Chandler [MVP]
Ha! Thanks Rob

Post by Rob Cavicchio
I've had quite a bit of experience auto-generating HHC files. Using
closing </li> tags does work fine, but there are some other "gotchas". One
that comes to mind is that the opening <li> tag and the opening <object>
<li><object>
<li>
<object>

Another gotcha is using comment tags <!-- -->, it works somethings,
but depends where they are at.

What I ended up doing was single sourcing a TOC file in a XML format
with information that our "make help" utility uses to create the HHC,
a web based version HTM file.

--

[Tommy]

Thanks Rob and Rob. :-)

Post by Rob Chandler [MVP]
Hi Tommy
HHC and HHK files are Microsoft Sitemap format. The resemble HTML.
Ideally your conversion app should create 2 different files
- A) .HHC for HTML Help
- B) .HTM for the web. This one should have the </LI>
You can try adding the </LI> to the the HHC if you think it will make
life easier. Either it will work or it wont. There is no documentation
for sitemap format so you just have to try it.
Cheers
Rob
http://helpware.net/FAR/

Question, but I beat my brains on this because it appears that I have to
conform to how the compiler is reading the hhc file, I am manually
editing the hhc file to create my table of contents.
I noticed that the <UL> and <LI> originally created were not quite in HTML
expected format where it doesn't use </LI> tags.
For example, AFAIK, this is correct usage
<UL>
<LI>xxxx</LI>
<LI>
<UL>
<LI>xxxx</LI>
<LI>xxx</LI>
</UL>
</LI>
</UL>
<UL>
<LI>xxxx
<LI>
<UL>
<LI>xxxx
<LI>xxx
</UL>
</UL>
Can I use the correct format without a problem or it going to create
issues?
The reason is that we create HTML files for the CHM creation but also
putting the HTML files on our web server. We have a utility to takes the
HHC to create a HTML file and my parser gets confused when its using he
HelpHTML format for HHC outlines.
Suggestions?
Thanks