Migrating heitml 1 applications

Here you can find useful information on how to migrate your heitml 1 application to heitml 2. See here for compatibility issues of the heitml 2 programming language.

Windows Platforms

To use your heitml 1 application (installed in c:\heitml1.23\htdocs\myapp) with heitml 2.1 (installed in c:\heitml2.1) perform the following steps:

1. Add a section to the global heitml configuration file:

[c:\heitml1.23\htdocs\myapp]
compat=1
include=c:\heitml2.1\htdocs\heitml2.1\lib1.2
lib=off

2. You might also want to add

debugwindow=t

if you want heitml error messages to be put in a separate browser window.
3. Save the global configuration.

UNIX platforms (Apache)

To use your heitml 1 application (installed in /usr/local/apache/htdocs/myapp) with heitml 2.1 (installed in /usr/local/apache/htdocs/heitml2.1) perform the following steps:

1. Add a directory configuration directive to the global heitml configuration file of your Apache Web server:

<directory /usr/local/apache/htdocs/myapp>
heitmlcompat 1
heitmlinclude /usr/local/apache/htdocs/heitml2.1/lib1.2
heitmllib off
</directory>

2. You might also want to add

heitmldebugwindow on

if you want heitml error messages to be put in a separate browser window.
3. Save the configuration file.

UNIX Platforms (CGI)

To use your heitml 1 application (installed in /usr/local/heitml/htdocs/myapp) with heitml 2.1 (installed in /usr/local/heitml/htdocs/heitml2.1) perform the following steps:

1. Add a section to the global heitml configuration file:

[/usr/local/heitml/htdocs/myapp]
compat=1
include=/usr/local/heitml/htdocs/heitml2.1/lib1.2
lib=off

2. You might also want to add

debugwindow=t

if you want heitml error messages to be put in a separate browser window.
3. Save the global configuration.

All Platforms

1. Whereever you are using defbody in your own tags there must be a > or ; (surrounded by white space) afterwards. This is another main incompatibility to heitml 1, but already has been resolved in the lib shipped with heitml 1.23.
2. Don't use variables/functions in your code that are private/internal to heitml or a library. In heitml 2.1 these variables/functions start with an underscore _.
3. Delete all session files created by heitml 1 or use a different directory for your sessiondir.
4. In heitml pages that are using dynamic includes, the include files must be preprocessed manually.