
               Step-by-step Instructions for translating
                       Hardy files to HTML format
      
                          Jessica Chen-Burger
                                May 2001 

0. To run hardy without translation facility, double click on the 
   
   hardy.exe

   To run with execution facility, double click on the short-cut
   below:

   hardy-html.

1. Hardy v1.87 converts and translates text and diagram files into 
   HTML format, but it does not convert hypertext files. 

2. To run Hardy with export facility to HTML format use the 
   short-cut below: 

   C:\Hardy\Hardy.exe -dir c:\hardy\ -clips c:\hardy\html\loader.clp

   and change the according directory names - if hardy is not stored 
   in C:\hardy\. Also change the directory names in loader.clp to the
   full path name, i.e. if *.clp files are not in c:\hardy\html\ 
   directory - use '\\' instead of '\', e.g. c:\\hardy\\html\\. 

3. Specify translation facility in diagrams.def file: (appears as a 
   menu-button in the Hardy control window when done)

   custom(custom_menu_name = "&Translation",
   custom_menu_strings = ["Translate to &HTML"]).

4. Run Hardy and open the desired hardy index, e.g. demo.ind.

5. Load the Hardy translator from the development window by using 
   the "Batch" command to load the clips file: Loader.clp, which will then load   
   the rest of the files. If you have used the shortcut as specified in step 1, 
   you can skip this step. 

   ./html/loader.clp

6. Close all Hardy windows, except for the top-level control window

7. Flatten the control window as small as possible to allow maximum space
   on your desktop. 

8. Choose the menu-item below on the control window to
   start the translation:

    /Translation/Translate to HTML/

9. A Hardy Translation window will now pop up. Specify the fields in 
    the window similar to the examples below:

    1. "Destination Directory": 
       give it a temporary directory, e.g.

       c:/temp/ 

    2. "Standard Document Directory":
       give the directory where Hardy stores HTML-related
       files: i.e. bg.gif, bg-2.gif, help.htm, etc.
       It is normally under the subdirectory 

       C:/hardy/standard

    3. "Title":  give a title to the translated model

    4. "Author": give author names for the model 

    5. "Object Identifier Attributes":
       The common (ID) attribute for all the model objects which will 
       be used by the translator to distinguish different model 
       objects, e.g. 

       name
  
    6. click OK to start the translation ! 

10. A message box will now show as below:
  
   "JESS: bmp to gif command: cview.exe -O -G ..path-name.. ..path-name..
   The automatically generated images are stored in the working
   Directory specified by -dir at Hardy command line."

   Click ok on this box. (This function is currently disabled.)

11. A second message box is shown as below:

    "Translation finished. Do you want to delete all of the bmp files."

    Click "No" on the command line'; or leave it there and
    choose "Yes" when we finished all of the steps in this document. 

12. To translate all of the .bmp files in a batch action,
    run "Paint Shop Pro 7"

13. On "Paint Shop Pro", select

     /File/Batch Conversion/

14. A window labelled "Batch Conversion" will pop up. 

15. Locate the temporary directory where all of the html and
    bmp files are, e.g. in the example given previously, 

    c:/temp/ 
    
16. Change the field "Files of type:" to the value below:

    "Windows or OS/2 Bitmap (*.bmp)"
      
17. Change the field "Output Settings/Type:" to the value below:
       
    "CompuServe Graphics Interchange (*.gif)"

18. Change the "Output folder" to the temporary directory,
    e.g. 

     c:/temp/ 

19. click "Select All" to activate the conversion for all
    bmp files to gif files. 

20. The translation is now done, you can now delete all of 
    the bmp files - refer back to step 11. 

21. To view all of the html files, open the file below from the 
    html directory: 

     top-level.html 



    
