Starting a new project

HTML Executable stores all of its settings (the project) in a file called project file (file extension: .hepx). You can use the Open/Save buttons in the main window’s bar to open or save project files at any time. But before that, you need to create a new project.

To create a project file, select New Project in the Application menu after clicking (or click Start a new publication project in the toolbar) and this window will appear:

This window is called the New Publication wizard: it will assist you in the creation of your new project and it gives you advice about the different steps you need to follow.

There are four steps that we will describe below.

1) Selecting the source folder of your website

The source folder is the folder that contains all files that compose your website. HTML Executable will consider it as the root of your website: it will become the root of your publication / ebook, and all the files inside this folder and its subdirectories (if any) will be automatically added to the publication when the project is being created. You can, of course, add/remove files later if you wish.

The directory structure of your website is stored in the publication: the source folder is set as the root of the publication/website. File paths will be stored relative to this source folder so links between HTML pages will work exactly as if you were navigating through a website on a server (see virtual paths). You can consider a compiled publication as a server.

2) Choose the index page of your publication

The index page is the first page that is displayed to your end users when the publication is run. It is considered the Home page (it will be displayed when end users click the Home button).

HTML Executable lists all files available in the source folder and you have to select which HTML page (or PDF file) you want to set as the index page. An HTML file inside a subfolder is accepted.

It is possible to choose a PDF document as the homepage, but this is recommended only if you want to convert a single PDF file to a secure ebook (“PDF to EXE”).

You can then go to the last step by clicking Continue.

3) Kind of publication you want to create

Before you continue, please read the “About Publication Types” topic.

If you still have no idea about the type of publication you need, click Help me to choose. Some questions related to the features used in your website such as JavaScript, remote Internet connection required… will be asked and then HTML Executable will select the best choice for you.

When you choose a publication type, the corresponding description is displayed.

If you are a beginner, we recommend you to use the WebBrowser (Internet Explorer) publication type.

4) Last step: output settings

You have

  1. to specify the path to the publication / ebook .exe file that will be output by HTML Executable. It must be a full path including directory, filename and extension. You can select it by clicking the Browse button.It is recommended that you do not put your output .exe file in the source folder, but rather in a different directory. Ensure that the destination directory is writeable.
  2. to give a title to your publication. The title will appear on all dialog and message boxes displayed to end users as well as in the Windows task bar. HTML Executable should have parsed your index page and read the value of the <TITLE> HTML tag if any. You can of course choose a different title.

IMPORTANT: if your title contains a quote (") character, be sure to replace it by two quotes "" in order to avoid script compilation errors.

Finally click Finish to create your project.

HTML Executable will then prepare a blank project, configure all settings by default and automatically add files from the source folder. It generally takes a few seconds depending on the number of files you have in your source folder.

When it is ready, the “Main Window” page is displayed: you are ready to edit your project and you can also immediately compile it if you wish by clicking at the top (or press F9).

About publication types

Main Window

Using the file manager

Copyright G.D.G. Software 2019. All rights reserved