If you click on [A], the markup in the HTML file that you have opened or created will be analysed using HTML-Tidy, a software written by Dave Raggett and a group of volunteers.
HTML-Tidy performs a syntax check of your file’s markup. It returns a list of line numbers whenever violations of the language rules, as defined in the HTML specification> by the World Wide Web Consortium, have been detected. You should correct these errors in the editor because the GMS typesetter then will have fewer problems to render a nice portable document.
Especially if you have produced your HTML file with a what-you-see-is-what-you-get editor like FrontPage, Fusion or DreamWeaver, the markup may be incomplete, verbose, proprietary or deprecated. If the file was converted from a Word document, it will be inflated with masses of information that is only relevant for Microsoft Office products.
If there are no severe markup errors in the input file, HTML-Tidy also
produces a cleaned up version, where less important mistakes are corrected
automatically and the layout is made uniform. That file is given the
same base name with an OK
extension.
You can analyse the markup of a given HTML file by pressing [A]. The result of the syntax check will be displayed in the text viewer. Press [Q] (Linux) or [Esc] (Dos, Windows) to quit.
If there are multiple HTML files in one folder, you can analyse them all at once, if no special file is selected. Press [O] to display the open file dialog and select an empty line, or change into the higher directory, return to the folder that you just have left and quit the dialog before pressing [A] in the GMS main menu.
The precise behaviour of HTML-Tidy is defined in the
[GMS_ROOT]/etc/
tidy.cfg
configuration file. For instance, if there is a line write-back:
yes
, HTML-Tidy will replace the input file with its corrected
version instead of writing it to an OK
file. This may result in
data losses, e.g. if parts of a text are marked as an attribute by mistake.
You can select another syntax checker, if you press
[S] and [P]. The Tidy
binary should be found in the search path or in a sub-directory of
[GMS_ROOT]/
bin
.
In the command line, enter
gms
-a
/myfolder/myfile.htm
(Linux)
or gms
/a
x:\myfolder\myfile.htm
(Dos,
Windows) to analyse the markup of a document. If
the file was opened or created before, it is sufficient to call
gms
-a
or
gms
/a
.
Alternatively, you can execute the commands cd
[GMS_ROOT]/doc/default
and
[GMS_ROOT]/bin/[dos|win|linux]/tidy
-config
[GMS_ROOT]/etc/tidy.cfg
-f
default.err
default.htm
>
default.ok
.