<PRETTY> HTML - HELP
(click ‘?‘-button again to hide help)

The main purpose of this software is, to select easily some html files and quickly format or compress them. Advanced users should have the opportunity to customize options as they like.

Main Window

Button ”Single HMTL File”:
You can choose only a single file to compress or format. The advantage of  this mode is, that you can edit the file after formatting. 

Button ”Multiple Files”:
To select more than one file for batch processing. 
(Note: the free version has a 5 files limitation, enough for many private websites)

Button ”Directory Tree”:
For batch processing a whole directory tree. Select the start directory and PRETTY HTML will search for html files in all subdirectories. After the search you can manually deselect some of the files if you like.
(Note: selecting the root directory of a drive is not allowed )
(Note: in the free version, this features is not working)

Button ”Format”:
Will start to outline selected html files. Processed files will automatically saved and backup files will be created (if choosen in the options window).

Button ”Compress”:
Will start to compress selected html files. Processed files will automatically saved and backup files will be created (if choosen in the options window).

Button ”Options”:
Shows the options window.

Button ”Edit”:
This button is only active after formatting a single file! PRETTY HTML is not an html-editor (at least in this version...). But at this point,. We give you the opportunity to edit the formatted file (not a compressed file, that makes no sense...) to make last manual changes if necessary. 

Button ”Browser”:
This button is only active while working with a single file! Displays this file with your default browser.

•	General information about backup‘s:

”Single File” and ”Multiple Files”,  will create the backup files with the extension ”.bak”, in the same directory like the original files. 

”Directory Tree” will copy the whole tree structure and the original hmtl-files, to a new directory. In this case no ”.bak” extension for files will be created, so it’s easier to restore them.

Example: 
Source directory is:           C:\WEBS\MYPAGES\....
Backup directory will be:  C:\WEBS\MYPAGES_BAK00\....

A backup directory will never be overwritten, if a tree already exists the next backup tree will be named e.g. C:\WEBS\MYPAGES_BAK01\.... and so on. 
(Note:  in each backup directory you will find a log-file named ”report.txt”, with useful informations about this directory)
(Note:  you can disable creating backup’s in the option window)

Options Window

This dialog allows you to set many individual format and compression options. You can immediately preview the effects of your settings using a testfile. The preview file will never be overwritten.

Listbox ”Preview File”:
Choose your preferred preview file to see the results of your settings. You can easily add your own files, by copy them in the ”/PREVIEW”-Folder (which is found in the PRETTY-HTML  program directory).

Left option panel:
Contains general format and compress options.

Purge comments in compressed files:
Is only considered if you compress your files. All comments (<!--...-->) in html files will be purged, no automatic comments will be created. 
(Note:  scripts will never be purged!)  

Disable all auto-comments:
No automatic comments will be generated. It overrules settings in ”tag properties”. It’s a comfortable method to quickly disable/enable auto comments, without the need to change tag properties one by one.

Create backup files:
Disables generating backup files. Be careful with this option!

Testblock linesize:
Preferred maximum number of characters in a single line.

Indent stepsize:
Number of blanks used for line indents.

Right option panel:
Allows you, to customize your preferences for each single tag. These settings will only have effects when formatting a file. Press the ”Preview Format”  to see how your settings work.

Customize Tag:
Choose a tag to set it’s properties.

Extra line before opening tag:
Inserts a blank line in source code before an opening tag (e.g. <TABLE> ).

Extra line after closing tag:
Inserts a blank line in source code after a closing tag (e.g. </TABLE> ).

Selfindent tag:
This tag itself will be indented. 

Indent contents:
Everything between the opening tag and the closing tag will be indented.

Generate auto comments:
Enables auto comments generation for this specific tag. If you want to disable comments for the selected tag just uncheck this option. You do not need to clear the start-tag and end-tag textfields!
(Note: this option can be overruled by the ”disable auto comment” option)

Comment at start tag:
This text will appear in the auto comment line before the opening tag.

Comment at end tag:
This text will appear in the auto comment line after the closing tag.

Symbol:
Select the comment autofill symbol for this tag.

Length:
Set the length of the auto comment line for this tag.

Button ”Reload File”:
Reloads the preview file from disk.

Button ”Preview Format” and  ”Preview Compress”:
See how your settings work.

•	General information about auto comments:

An auto comment will only generated if:
•	”disable auto comments” is unchecked, 
•	”generate auto comments” for specific tags be checked, 
•	and only if you format the file (not when you compress). 
It’s irrelevant if the start-tag and end-tag textfields are empty or not.

© media++
Maderthaner & Petek OEG 
A-1030 Vienna, Hiessgasse 16
Austria/Europe 
http://www.mpp.at
office@mpp.at