Natural Docs
Output Formats

These are the output formats that are currently implemented in Natural Docs.

HTMLExampleHTML output.  Each page is self-contained.  Linking to specific pages is easy, but every file has to be updated whenever the menu changes.
FramedHTMLExampleHTML output based on frames.  The menu is updated quickly, but linking to individual pages is difficult and some people just plain hate frames.

Natural Docs is designed to be extended for different output formats, but it requires a strong knowledge of Perl.  See the Extending page for more information.

HTML Compatibility

These are the browsers Natural Docs’ HTML output has been tested with.

Gecko
Mozilla, FireFox, etc.
Works on 1.0+Mozilla 1.4 works flawlessly.
Mozilla 1.0.2 has trivial padding issues with prototypes in tooltips.
Mozilla-only bonus: rounded corners.
Internet ExplorerWorks on 4+IE 6.0 works flawlessly.
IE 5.0 occasionally slightly mispositions the tooltips, but they’re still usable and are usually fine.
IE 4.0 can’t collapse the menu and makes tooltips the full page width, although it positions them correctly.
OperaWorks on 5+Opera 7.02 works flawlessly.
Opera 6.05 can’t collapse the menu.
Opera 5.12 can’t collapse the menu or size/position the tooltips very well, but they’re usable most of the time.
KHTML
Konqueror, Safari
Works on 3+Konqueror 3.1.1 has some minor margin issues and shows tooltips immediately because it has problems doing so on a timer.
Netscape 4.xNope.I’ve stopped trying to support NS4 in my projects long ago.  It’s not good for one’s sanity.

Note that a browser not being able to collapse the menu isn’t a compatibility concern.  The menu defaults to completely open if the browser can’t handle collapsing it, so it’s always usable.  It’s just better on browsers that support it.

Also note that if a browser doesn’t support frames, the user will automatically be forwarded to the menu file when using framed HTML output so it will still be usable.