Design notes

Non compliant OPML files

Some editors tend to produce badly formatted xml or opml files. This can result in errors during the conversion process or in unpredictable results. However, some of these non standard behaviors have been taken into account during the design of the converter and are supported (mainly hnb at this point).

Use of the hdoc format to represent opml trees :

The hdoc format is more expressive than opml, which means that choices had to be made regarding the subset of hdoc to use to represent opml files.

Our design is quite simple : each outline opml element is translated to a section hdoc element which header includes a H1 element containing the outlines text.

When possible, the meta-data stored in the header part of the opml file are translated to equivalent elements in the hdoc file.