File Properties Editor

Properties for file compression, security, scripting and dependencies can be edited via the File Manager. To edit the properties of the files, select one or more files, then click Properties (or press Ctrl+P). The following window will appear:

img

If the selected file is a HTML page, you have four tabs: Properties, Security, Scripting and Dependencies. Otherwise you only have the Properties one.

You can see the name and the type of the selected file or "Multiple files" is shown if you have actually selected several files. If you leave the mouse cursor on this name, the full path to the file will be indicated in a small hint window.

imgCompilation Properties

  • Do not include the selected file: if you turn this option on, HTML Executable will exclude the file from the compilation; it will not be available at all.

  • Do not compress the selected file: when enabled, HTML Executable will compile the file but it won't be compressed: it is stored - uncompressed - in the publication's data. You can use this option if you are going to include already-compressed files.

imgKeep file external

When a file was compiled in the publication .exe file, it needs to be unpacked in memory in order to be viewed. This operation may require a lot of time, depending on the size of the file.
To skip the decompression step, large files like media files can be kept outside of the publication. When these files need to be loaded, the runtime module will automatically look for them in the folder whose path is specified and therefore the loading time will be highly decreased.

External files are not compiled and consequently they must be deployed with your publication .exe file. You will generally place them in the same folder as this .exe file, or a subfolder.

imgSee how to use and link to external files

This tab is important because it provides you with several security features for your HTML pages. You can for example restrict what end users can do: copy text, print page, etc... You may assign passwords, exclude the file from being indexed by the search engine, etc...

Security profiles may be assigned to Flash SWF files too if you want to control whether they can be accessed or not (useful for Flash-based presentations to control which slides may be accessed or not).

imgAbout security profiles

HTML Executable uses a system based on "security profiles" to manage the different actions allowed for HTML pages.

Security profiles determine if a page can be accessed (given some conditions like password, restricted publication, script function result...) and what end users can do when viewing this page (usual actions like copying text, printing page, copying images, etc...).

imgSee this sample about how to use a security profile to password protect pages

These security profiles are managed by you in the Security tab: you first create one or more security profiles (in addition to the default one always created when a new project is started). Then you use the File Properties to assign your security profiles to different HTML pages or Flash files.

imgSelected Security Profile

To assign a security profile to the selected HTML page(s) or Flash file(s), use the list to choose the one you wish. By default, the "Default" security profile is always selected.

imgSearch engine properties

The search engine by default automatically indexes all HTML pages when the publication is being compiled. You can prevent the selected HTML page(s) from being indexed too by turning the option named "Exclude this file from searching" on. In this case, the page(s) will be ignored.

imgThe publication can be extended via scripting functionality. HTML Executable has its own script language called "HEScript": you can write your own scripts in order to control the behavior of your publication and actually do what you want.

Several reasons why you can use scripting:

  • HTML Viewer publications do not support JavaScript, but they have extended support for HEScript.

  • IE publications also provide some additional JavaScript options, so you can combine HEScript-JavaScript functionality.

  • Publications feature several built-in HEScript functions to control their behavior and manage user interactions.

Some scripts contain several functions that actually play the role of "events": when an event is triggered, the publication will execute the associated function.

imgScript for HTML pages have events like:

  • when the page has been loaded.

  • when an URL is clicked.

  • when a form is submitted.

  • when the publication is going to quit the page for another one

  • etc...

You can therefore associate a script to a HTML page: when this HTML page is viewed, the associated script is loaded by the publication. Then when an event occurs, the related function is executed. Thus, you may respond to a specific event with your own actions.

In HTML Executable, scripts are compiled during the compilation into p-code for faster execution at runtime (contrary to JavaScript). That's why scripts are separated from HTML pages and stored in a script manager. You can manage scripts using the User Scripts tab of the main window.

imgIn the Scripting tab of the File Properties window, you can choose which script should be associated to the selected HTML page(s). All existing scripts are available in the list: just select the one you wish.

  • You can create a new script by clicking "Create an associated script". You will be prompted to give a name to your script, then the script editor will be displayed.

  • You can edit the selected script by clicking "Edit this script". If no script is selected ("None"), nothing will happen.

imgTo manage HEScript scripts, please go to the User Scripts tab.

imgMore information about HEScript in HTML Executable.

imgIf a HTML page contains active objects like Flash, Java applets or other ActiveX controls, they may require additional resource files (like JPEG picture files, FLV video files, CLASS files). In some cases, an ActiveX control does not automatically request these files and thus it will not work properly because these files are missing.

For instance, in HTML Viewer publications, if you have a Flash movie (SWF) that requires a video file (FLV), the Flash Player does not request that video file itself and your Flash movie will not play your video.

imgThe solution is to tell the runtime module that some resource files are required when a HTML page is displayed: these resource files are called dependencies of the HTML page.

img You can manage dependencies for any HTML page: see a screencast about how to add dependencies for a HTML page.

When the HTML page is loaded, the runtime module extracts all dependencies to a temporary folder, and thus they can be found by the ActiveX control.

imgOnline screencast and information about working with dependencies