We have implemented a trial of HTML snippets in the current beta of 7.3, which you can download here:http://download.ec-software.com/help-an ... 0-beta.exe
Please don't get your hopes up too much, however. There are serious restrictions that you need to consider: The HTML must be converted to HM XML and then back again, and there are problems with images and links that may or may not be solvable for you, depending on how your HTML files are and can be formatted.How to use it:
- Use the Snippet tool with the From File option, navigate to the folder containing the HTML snippet file and type in the name of the file manually in the open field, but with the extension .xml. For example, if the file is called myfile.html, type in myfile.xml and then press ENTER.
- You will get an error message. This is important, because then you have passed through a parsing step. Now manually change the extension in the Open field and press ENTER again. Now the file will read in without any errors.
CSS will be parsed as far as possible, if it is included in the file. IMPORTANT:
After inserting the snippet, you can't edit the insertion by double-clicking it at the moment.
Now let's look at all the problems involved:Graphics:
Only the names of the graphics can be imported. If your images are not stored in folders located in the project's search path they will not be found. NO path information can or will be taken into account. If the images are not on the search path they won't be found and won't be used.Hyperlinks:
Normal web links to external sites and files should continue to work but topic links won't unless you format them as topic links in your HTML. This means your HTML would need to contain links to topic IDs that would be invalid in normal HTML, like this:
- Code: Select all
<a href="mytopic">Link Text</a>
It must be entered like that, without a file extension. In a snippet it's not possible to do things like check whether the link might be to a topic or an external file. HTML:
Only HTML will be imported that can be meaningfully processed in the Help+Manual editor. If your HTML doesn't import properly this means you will need to change your HTML. Changes in Help+Manual are categorically not possible to cater to different kinds of HTML in snippets. This is an absolute restriction and not up for discussion.