WinToHTML Menugenerator für Ein- und Mehrsprachige Sites

Manual

1. Install
   1. Download the archive WinToHTML.zip
   2. Unpack it to a directory at your local computer (we'll call this directory working directory from now on).
      Note: the script will not work in a shared folder on a remote computer.
   3. You must have full access rights to the working directory (be able to read, write, create and delete folders and files).
   
   
   That was it.
2. Create the menu structure as a Windows menu.
1. At this moment you should have the concept of the site structure almost ready.
   You can also add or delete menu items later. (Use the option "rebuild menu".)
2. Now create items in the directory "/structure".
   
   
   
   The main rule is:
   create Windows folders for the menu items which should have sub-items;
   create simple text files for items without sub-items.
   All the text files must have the extension ".txt". It is obligatory.
3. In the WinToHTML 1.1, the name of a Windows folder will be its title at the HTML page.
   (So the symbols not acceptable as a Windows folder name are not possible for HTML titles too.)
   In the WinToHTML-M, the folder name does not matter. Create for each folder one textfile "lang.txt". At first line write the title on the first (default) language followed by "_" and the language token. At the second line - the title on the next language etc.
   Example:
   
   Contact _en
   Kontakt _de
   Ваши замечания _ru
   
   
4. The line will be the title of the HTML page, and it will also be the name of the corresponding menu item.
   
5. Ordering the items:
   To order the appearance of menu elements, make a numbering digit the first symbol of the name of every folder or file.
   In WinToHTML 1.1, select the option "Cut the first (numbering) letter" when creating pages. (You can have problems with more than 10 subfolders or files in one folder, in which case you could use letters of the alphabet instead.)
3. Creating the page set
   1. After you create the menu structure, open the file /WinToHTML/main.htm for the WinToHTML 1.1 or ./WinToHTML_M/main.htm for the WinToHTML-M.
      Important: open only in Internet Explorer! VBScript doesn't work with Mozilla, Opera and other browsers.
      If your browser is configured to disable Active Scripting, enable it. Accept the Internet Explorer Security alert.
      
   2. Edit the HEAD section. If you don't know what it is, leave the content as is.
      An additional stylesheet can be added here too.
   3. Select the header and footer files. These files may be located in any readable directory at your local computer. But it is easier to store them in the /resources folder.
      In the multilingual version, the files with the same name and language token will be used as the headers for other as default language pages. Example: header.html -> header_de.html, header_fr.html.
      Local images: Local images for the header and the footer can be located in the /resources folder only!
      The image tag must begin with <img src=".
      This means that, 1) the source must be double quoted, and 2) the source must be the first attribute, other attributes such as "class", "border" etc. should follow later.
      Unfortunately, this restriction is the only way to allow local images in header and footer.
      Images from the Internet: Use the pattern "<img border="..." src=...>" to include an image from Internet.
   4. Next you have a choice of creating a new page set or rebuilding an existing one.
      In the first case the output subdirectory named "home" will be created in your working directory. If such a subdirectory exists, it will be completely rewritten. The content will be lost.
      In the second case the existing subdirectory "home" will be copied into a temporary directory. The content of the files will be preserved and copied into the corresponding files in the newly created "home" directory.
      If you open the newly created files, you will find old content again.
      The temporary directory will not be deleted for safety reasons. You should delete all temporary directories manually.
   5. Other options speak for themselves and probably don't need to be explained.
   6. Before you click the Submit button, check out whether the files from the /home directory are open somewhere. All of those files must be closed, they can't even be shown in Windows Explorer.
      If you see an error alert please close all open files and reload the main.htm.
4. Creating the page content
   1. After clicking on the Submit button the page set with the menu will be created and you will be redirected to the index page. Now you can open the new files in any HTML Editor and add content.
   2. The output pages contain the table with two cells. The left cell includes the tree menu, the right one is intended for the page content.
      
      
   3. The Rebuild option
      To rebuild the menu, edit the folder "/structure".
      Important #1: the comments inserted of WinToHTML must be kept. Once you or your HTML Editor delete these comments, rebuilding is not possible anymore.
      Important #2: If you rename a file or directory, it cannot be recognized again and will be created as a new item.
      You can retrieve the content of the renamed files from the temporary directory.
   4. Edit the stylesheet to get your pages the desired look. The stylesheet is /resources/treemenu.css.