Administration Site Manual for
GlyphGate 5.1
Content
Copyright 2001-2005 Em2 Solutions AB. All rights reserved.
Introduction
From the GlyphGate Administration site you can configure your installation of GlyphGate, view available web fonts, verify that your web pages are correct and view online documentation.
The Admin site is installed with GlyphGate and can normally be found at http://localhost:8024/.
Some of the features described in this manual are not available in all editions.
Status page
This page shows license information for your copy of GlyphGate. It is password protected.
This section shows what version and which edition of GlyphGate you are running. You can
also see what rendering engine is being used to render text.
License information
Here you can see if your copy of GlyphGate is valid. It also shows how many sites and how many
CPUs you are allowed to install GG on, as well as the current number of sites it is installed on.
Server cache
With this button you can clear the server cache used by GlyphGate to store processed documents and font data.
Security page
This page lets you configure access rights to the admin server. It is password protected.
This section controls which port the admin server is listening on, as well as from where
connections to the admin server are allowed. The port can be any valid port value, as long as
it is not used by another server. The "Connections allowed from" setting can be either "localhost"
or "Internet". For "localhost" only connections from the local machine are allowed access to
the admin site, whereas for "Internet" all connections will be accepted. You can change the current
values by pushing the "Change values" button.
Admin account
Access to pages that affect the GlyphGate setup are password protected. You can choose a user
name and password for these pages here. You can also govern whether changes should be allowed only by
users on the local machine, on the local net or on the Internet. To change the values simply push the
"Change values" button och make you changes. Note that the user name and password must be alphanumeric
values.
Server run state
You can stop the admin server by pushing this button.
Site configuration page
From this page you can enable GlyphGate on your web sites. The page displays a list of all your web sites, with checkboxes indicating whether GlyphGate is active on the site or not.
Enabling/disabling GlyphGate on some sites
Enabling or disabling GG on some sites is very easy. Use the checkboxes to indicate whether you want
GG to be active on the sites and then push "Update" to make the changes.
Rebinding GlyphGate on all sites
Sometimes you may want to rebind GlyphGate to all your GlyphGate sites, e.g. when upgrading to
a new version of GlyphGate. Pushing "Rebind" will uninstall GlyphGate from all your sites and then
reinstall it on all sites with the "installed" check box checked.
Testing the sites
For sites where you already have GG enabled you can test the installation by following the "Test!" link.
Settings page
This page lets you view and edit the current configuration files for GlyphGate.
Changing a configuration setting
Across the top of the page is a list of the configuration files that GlyphGate uses (glyphgate, fonts-config, encodings, user-agents and servers). Clicking on any of these links will bring up a list of all the sections in the selected configuration file. By clicking any of the section names in turn you will be able to edit, add or delete individual settings under that section (see screenshot above). To edit or delete a value you simply click on it. This will bring up a set of four small buttons: clicking "-" will delete the setting, "+" will cause your changes (if any) to be saved. "<<" and>>" moves the value up or down in the configuration file. To add a new setting select "(add setting...)".
Logs
This page lets you view the GlyphGate log files.
Click on a file name to view the contents of that log file.
The fonts folder
A good way to see which fonts are available for use by GlyphGate is to point your web browser to the GlyphGate fonts folder. This will give you the following view of available fonts:
In this view all available font family names are listed. A small icon next to the family name indicates the type of font. Truetype fonts will have a small icon with "TT" in it, postscript fonts have a lowercase "a" and bitmap fonts have a capital "A".
To view more information about a font family just click on its family name. This will bring up a view of available font weights and variants available in that family:
From this view you will be able to see if a font exists in e.g. bold style, or if it will be synthesized by the Operating system. This page also has a link to a page that will let you see which languages this font can be used to represent. Clicking this link will give you the following screen:
All together these pages offer an easy and convenient way to choose fonts you want to use in your web pages (and readily shows which fonts will actually work for your desired language).
Page validator
GlyphGate contains a built-in HTML and CSS validator that will assist you in creating web pages that are syntactically correct. The validator will find things like missing end tags and illegal constructs in the pages processed. GlyphGate can be configured to enable the validator for all pages on the site, or only certain directories etc. Optionally, and as a great help during page development, GlyphGate can be configured to visually indicate if a page contains syntax errors. Please refer to the Admin manual for more information on the validator configuration options.
The screenshot above shows how the GlyphGate page validator indicates that it has found problems in a page. A yellow banner is inserted at the top of the page, complete with a link to the validator report page (see below).
Using the validator
The validator report page (found at http://localhost:8024/errors.fd) offers a comprehensive overview of which pages contain errors.
The page is divided into 3 frames, with the following functionality:
1. This frame shows a list of virtual servers and pages that have been found to contain syntax errors (or warnings). Note that only erroneous pages that have actually been viewed at least once (and hence processed by GlyphGate) will be listed here. Please also note that errors in script output and output from CGI programs will not be listed in this column (see "Validating dynamic pages" below).
2. This frame will show a list of errors and warnings in the current page. The current page is selected by clicking on the URL of a page in frame 1 (for dynamic pages the current page is set automatically - see below). If you have fixed all errors previously encountered in a page, then this frame will show only "no errors found" and the page will be removed from the list in frame 1.
Each entry in the list of errors/warnings consists of a small icon to quickly distinguish errors from warnings (errors have a small red stop sign, while warnings are identified by a yellow exclamation mark). Next to the icon is the line number where the error was found in the source document (for external CSS files, the file URL will also be displayed). Then follows a short description of the error or warning.
3. This frame shows the actual HTML/CSS source with the currently selected error highlighted. You select which error to display by clicking on the appropriate link in frame 2. You cannot edit the document source directly in this frame, but together with the information displayed in frame 2 you should be able to quickly identify and fix the problem in the original file using your favorite text editor.
Validating dynamic HTML pages
GlyphGate supports validation of HTML pages generated dynamically by server side scripts or CGI programs (if the server is configured to visually show errors in pages). Like in the static case, a yellow banner will be inserted across the top of the page if the page contains issues that need to be addressed.
The erroneous HTML code will not be saved and the page will not be added to the list in frame 1 of the validator report page. This is because the page HTML code can be dependent on data sent to the script or CGI program that generated the page (and GlyphGate can't reproduce these data). Rather, if you want to see the errors in the page you have to follow the link inserted in the yellow banner. This will load the validator report page and automatically update frame 2 with the list of errors in the dynamic page.
Help page
This page gives handy access to the help files for GlyphGate.
For further assistance, please contact us at Em2 Solutions. Support for this software is available free of charge through e-mail at support at glyphgate.com .