Link Checker


1. Introduction
1.1. Version history
2. Installing Link Checker Pro
2.1. Uninstalling Link Checker Pro
3. Using Link Checker Pro
3.1. Basic use
3.2. Data for each link
3.3. Showing and hiding links
3.4. Saving and loading projects
4. Customising Link Checker Pro
4.1. Report table HTML
4.1.1. Row start
4.1.2. Row middle
4.1.3. Row end
4.2. Report templates
4.3. HTTP connections
4.3.1. Timeout
4.3.2. Retries
4.4. Writing custom report templates
5. Entering your registration details
6. Registering Link Checker Pro
6.1. Payment by credit card
6.2. Payment by bank transfer
6.3. Payment by cash
7. Contacting KyoSoft
8. Joining the KyoSoft mailing list

Link Checker Pro help (September 7th 2003)



1. Introduction

Link Checker Pro is an essential utility for anybody wishing to check 
internal and external links within their Internet site. Link Checker Pro has 
many customisable settings and allows reports of link data to be saved in HTML 
format that may be easily viewed in any Internet browser.

Link Checker Pro is just one of a range of useful utilities available from 
KyoSoft (http://www.KyoSoft.com). Make sure to visit our Internet homepage and 
sign up to our mailing list in order to keep informed of product releases and 
updates.

Link Checker Pro may be used free of charge for 30 days, during which an 
Unregistered message will occasionally appear on screen. If you wish to use 
Link Checker Pro for more than 30 days then you must register this software. 

NOTE: The current version of Link Checker Pro (v3.1) has been tested on 
Windows 95/98/Me/NT/2000 systems prior to release.



1.1. Version history

Version number: 3.1.33
Release date: September 7th 2003
Details: Fixes minor bugs.

Link Checker Pro is copyright of KyoSoft ((c) 2003)



2. Installing Link Checker Pro

The main programme files for Link Checker Pro can be installed by running 
the installation programme on your system. This will install KyoSoft Link 
Checker into a directory of your choice in addition to placing links to the 
programme and help file on your desktop.

If you have any problems installing Link Checker Pro then please 
contact KyoSoft using either the online contact form at 
http://www.KyoSoft.com/contact.htm or else by sending an e-mail to 
support@KyoSoft.com. 



2.1. Uninstalling Link Checker Pro

Should you need to remove the Link Checker Pro from your system then do the 
following:

(i) Click on the My Computer icon on your Windows desktop.
(ii) Click on the Control Panel icon in the My Computer window.
(iii) Click on the Add/Remove Programs icon in the Control Panel window.
(iv) Select Link Checker Pro and click on the Add/Remove... button.



3. Using Link Checker Pro

3.1 Basic use

To start checking links, you need to first choose a base HTML directory or file. 
For example, in the following picture the site http://www.KyoSoft.com/ has been 
selected:

IMPORTANT: If you select a base HTML folder then it is important to put a "/" at 
the end of the folder address. For example, you should use

http://www.KyoSoft.com/linkchecker/ 

NOT

http://www.KyoSoft.com/linkchecker 

The reason is that Link Checker Pro will check all links below the base 
directory. For example, if you select

http://www.KyoSoft.com/linkchecker/

then Link Checker Pro will also checks links in all sub folders of this 
address, for example

http://www.KyoSoft.com/linkchecker/subfolder1/
http://www.KyoSoft.com/linkchecker/subfolder2/
http://www.KyoSoft.com/linkchecker/subfolder3/
etc.

However, if you don't put the "/" at the end of the base directory, for example

http://www.KyoSoft.com/linkchecker

then Link Checker Pro will instead check links in all sub folders of the 
base folder with the trailing "/", for example

http://www.KyoSoft.com/folder1/subfolder1/
http://www.KyoSoft.com/folder1/subfolder2/
http://www.KyoSoft.com/folder2/subfolder1/
http://www.KyoSoft.com/folder2/subfolder2/
etc.

To start checking for links press the green Play button. You may pause KyoSoft 
Link Checker at any time by pressing the Pause button. If you wish to stop the 
link checking then press the red Stop button. Link Checker Pro may take a 
few seconds to completely stop checking and downloading links.

The next section deals with the link data available from using KyoSoft Link 
Checker.


3.2 Data for each link

This section describes the data available for each link and how to view it. As 
each link is checked, the data obtained from the link is displayed in the main 
screen.

The first column shows the URL (i.e., Internet address) of the link checked. 
Moving the mouse over this column shows the URL of the link and can be useful 
when the length of the URL is wider than the display column.

The next column shows the title of the link. Moving the mouse over this column 
shows the title of the link and can be useful when the length of the title is 
wider than the display column. The title is generally only available for HTML 
files and only when the TITLE variable is defined in the META header of the 
link.

The next column shows the status information for the link. Moving the mouse over 
this column shows the status for the link together with all other information 
received from the server.

The next column shows the protocol for the link. Moving the mouse over this 
column shows the protocol for the link. For HTML files the protocol is http (and 
https) whilst e-mail links are mailto.

The next column shows the content type for the link. Moving the mouse over this 
column shows the content type for the link.

The next column shows the size (in bytes) of the link. Moving the mouse over 
this column shows the size of the link.

The next column shows the number of links into the current link. Moving the 
mouse over this column shows a list of all the links into the current link.

The next column shows the number of links out of the current link (i.e., the 
number of links found in the current link). Moving the mouse over this column 
shows a list of all the links out of the current link.

The next column shows the time that the current link was last modified (i.e., 
last changed or edited)

The next section explains how to show and hide the different types of links.

3.3 Showing and hiding links

Once the programme has checked links in a particular site, it may be useful to 
hide particular types of links. For example, hiding all good links will quickly 
show links where there might be a problem. Showing or hiding links can be 
achieved using the buttons at the bottom left of the main screen:

The left set of buttons relates to the status of the links:

Shows/hides OK links
Shows/hides Missing links
Shows/hides Restricted links
Shows/hides Other links
Shows/hides Unknown links

The middle set of buttons relates to the type of link:

Shows/hides HTML links
Shows/hides Image links
Shows/hides e-mail links
Shows/hides Text links
Shows/hides Video links
Shows/hides Audio links
Shows/hides Script links
Shows/hides Application links
Shows/hides Other links
Shows/hides Unknown links

The middle set of buttons relates to internal and external links:

Shows/hides Internal links
Shows/hides External links

3.4 Saving and loading projects

In order to save your project then either choose Save As... from the File 
pulldown menu or else click on the Save Project button. You will be prompted to 
select a new filename to save the project as. Link Checker Pro project files 
end in the extension ky1.

In order to load your project then either choose Open from the File pulldown 
menu or else click on the Open Project button. You will be prompted to select a 
project filename to load.



4. Customising Link Checker Pro

In order to configure Link Checker Pro you will need to first open the 
programme settings screen. The registration screen can be acessed by choosing 
the Programme settings... option in the File pulldown menu or else by clicking 
the Programme settings button.

The configuration screen contains a number of options that can be tailored to 
personalise your copy of Link Checker Pro. These are as follows:

4.1 Report table HTML
This option decides the HTML code used in generating reports. Three sub-options 
exists for this section:

4.1.1 Row start
This option decides the HTML code used before each table row when generating 
reports. The default settings for this option is <TR><TD ALIGN=LEFT><FONT SIZE=-
1>.

4.1.2 Row middle
This option decides the HTML code used between each table column when generating 
reports. The default settings for this option is </FONT></TD><TD 
ALIGN=CENTER><FONT SIZE=-1>.

4.1.3 Row end
This option decides the HTML code used at the end of each table row when 
generating reports. The default settings for this option is </FONT></TD></TR>.

4.2 Report templates
This option allows the selection of 5 user templates.for use when making HTML 
reports.

4.3 HTTP connections
This option affects the programme behaviour when checking links. Two sub-options 
exists for this section:

4.3.1 Timeout
This option decides how long Link Checker Pro should wait for a reply when 
checking each link. The default value for this option is 30 seconds.

4.3.2 Retries
This option decides how many times Link Checker Pro should try to check a 
link should there be a connection problem. The default value for this option is 
5.

4.4 Writing custom report templates

A powerful feature of Link Checker Pro is the possibility to write custom 
report templates. An example of a very simple report template is shown below:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>Sample report template</TITLE>
</HEAD>
<BODY>
<BR>
<BR>This is a sample report template that lists all links found by KyoSoft Link 
Checker.
<BR>
<BR>
<TABLE BORDER="1" COLS="9" WIDTH="100%">
<!-- KY_111111111_11111_1111111111_KY -->
</TABLE>
</BODY>
</HTML>

You can customise which links to include in the report by changing the line in 
the format:

<!-- KY_ABCDEFGHI_JKLMN_OPQRSTUVWX_KY -->

Each of the letters A ... X should be replaced by a number as follows:

The letters A ... I decides what data should be shown for each link:

If A is replaced by 0 then the URL for the link is not included in the report. 
Other values will show the URL for the link according to the following criteria:
0 - No URL data is shown
1 - URL data is shown as text with the full address
2 - URL data is shown as hyperlinked text with the full address
3 - URL data is shown as text only with relative address when the link is below 
the base directory or filename.
4 - URL data is shown as hyperlinked text with relative address when the link is 
below the base directory or filename.

If B is replaced by 0 then the Title for the link is not included in the report. 
Other values will show the Title for the link according to the following 
criteria:
0 - No Title data is shown
1 - Title data is shown as text
2 - Title data is shown as hyperlinked text

If C is replaced by 0 then the Status code for the link is not included in the 
report. Other values will show the Status for the link according to the 
following criteria:
0 - No Status code data is shown
1 - Status code data is shown as text
2 - Status code data is shown as code numbers
3 - Status code is shown as full header information received from the Internet 
server

If D is replaced by 0 then the Protocol for the link is not included in the 
report. Other values will show the Protocol for the link according to the 
following criteria:
0 - No Protocol data is shown
1 - Protocol data is shown as text

If E is replaced by 0 then the Content type for the link is not included in the 
report. Other values will show the Content type for the link according to the 
following criteria:
0 - No Content type data is shown
1 - Content data is shown as text

If F is replaced by 0 then the File size for the link is not included in the 
report. Other values will show the File size for the link according to the 
following criteria:
0 - No File size data is shown
1 - File size data is shown (given in bytes)

If G is replaced by 0 then the Links in data for the link is not included in the 
report. Other values will show the Links in date for the link according to the 
following criteria:
0 - No Links in data is shown
1 - Links in data is shown as the total number of links in
2 - Links in data is shown as text with the full address
3 - Links in data is shown as hyperlinked text with the full address
4 - Links in data is shown as text with the relative address when the link is 
below the base directory or filename.
5 - Links in data is shown as hyperlinked text with the relative address when 
the link is below the base directory or filename.

If H is replaced by 0 then the Links out data for the link is not included in 
the report. Other values will show the Links out date for the link according to 
the following criteria:
0 - No Links out data is shown
1 - Links out data is shown as the total number of links in
2 - Links out data is shown as text with the full address
3 - Links out data is shown as hyperlinked text with the full address
4 - Links out data is shown as text with the relative address when the link is 
below the base directory or filename.
5 - Links out data is shown as hyperlinked text with the relative address when 
the link is below the base directory or filename.

If I is replaced by 0 then the Last modified date for the link is not included 
in the report. Other values will show the Last modified date for the link 
according to the following criteria:
0 - No Last modified date is shown
1 - Last modified date is shown as text

Note: The number of columns in the report HTML table (set to 9 in the above 
example) will simply be the number of options A ... I that are not set to zero.

The letters J ... N decides what links should be shown according to the link 
status:

If J is replaced by 0 then OK links are not included in the report. Other values 
will show the OK links according to the following criteria:
0 - No OK links are shown
1 - OK links are shown

If K is replaced by 0 then Missing links are not included in the report. Other 
values will show the Missing links according to the following criteria:
0 - No Missing links are shown
1 - Missing links are shown

If L is replaced by 0 then Restricted links are not included in the report. 
Other values will show the Restricted links according to the following criteria:
0 - No Restricted links are shown
1 - Restricted links are shown

If M is replaced by 0 then Other links are not included in the report. Other 
values will show the Other links according to the following criteria:
0 - No Other links are shown
1 - Other links are shown

If N is replaced by 0 then Unknown links are not included in the report. Other 
values will show the Unknown links according to the following criteria:
0 - No Unknown links are shown
1 - Unknown links are shown

The letters O ... X decides what links should be shown according to the link 
type:

If O is replaced by 0 then HTML links are not included in the report. Other 
values will show the HTML links according to the following criteria:
0 - No HTML links are shown
1 - HTML links are shown

If P is replaced by 0 then Image links are not included in the report. Other 
values will show the Image links according to the following criteria:
0 - No Image links are shown
1 - Image links are shown

If Q is replaced by 0 then e-mail links are not included in the report. Other 
values will show the e-mail links according to the following criteria:
0 - No e-mail links are shown
1 - e-mail links are shown

If R is replaced by 0 then Text links are not included in the report. Other 
values will show the Text links according to the following criteria:
0 - No Text links are shown
1 - Text links are shown

If S is replaced by 0 then Video links are not included in the report. Other 
values will show the Video links according to the following criteria:
0 - No Video links are shown
1 - Video links are shown

If T is replaced by 0 then Audio links are not included in the report. Other 
values will show the Audio links according to the following criteria:
0 - No Audio links are shown
1 - Audio links are shown

If U is replaced by 0 then Script links are not included in the report. Other 
values will show the Script links according to the following criteria:
0 - No Script links are shown
1 - Script links are shown

If V is replaced by 0 then Application links are not included in the report. 
Other values will show the Application links according to the following 
criteria:
0 - No Application links are shown
1 - Application links are shown

If W is replaced by 0 then Other links are not included in the report. Other 
values will show the Other links according to the following criteria:
0 - No Other links are shown
1 - Other links are shown

If X is replaced by 0 then Unknown links are not included in the report. Other 
values will show the Unknown links according to the following criteria:
0 - No Unknown links are shown
1 - Unknown links are shown



5. Entering your registration details

Once you have registered your copy of Link Checker Pro, you will need to 
enter your registration details using the registration screen. The registration 
screen can be acessed by choosing the Enter registration details... option in 
the Help pulldown menu.

Enter your Username and Password details exactly as you received them from 
KyoSoft. The easiest way to do this is to cut and copy the Username and Password 
from the confirmation e-mail sent by KyoSoft (assuming that you received your 
registration details by e-mail). 

Note that any uppercase (i.e., capital) or lowercase (i.e., small) letters 
should be used exactly as supplied. Once you have done this you should press the 
Register button and receive a message that Link Checker Pro was successfully 
registered.

If you have any problems entering your registration details then please contact 
KyoSoft by either filling out the online support form 
(http://www.KyoSoft.com/contact.htm) or else sending an e-mail to 
support@kyosoft.com



6. Registering Link Checker Pro

Link Checker Pro may be used free of charge for 30 days, during which an 
Unregistered message will occasionally appear on screen. If you wish to use 
Link Checker Pro for more than 30 days then you must register this software. 
Registering the programme will allow you free unlimited upgrades and technical 
support from KyoSoft.

6.1 Payment by credit card 
You may pay by credit card safely and quickly online by following the details 
given at http://www.KyoSoft.com/register.htm or else by requesting details from 
register@kyosoft.com

6.2 Payment by bank transfer 
If you wish to pay by bank transfer then follow the instructions given at 
http://www.KyoSoft.com/register.htm or else request details from 
register@kyosoft.com

6.3 Payment by cash 
Customers wishing to register Link Checker Pro by cash should request 
further details by sending an e-mail to register@kyosoft.com



7. Contacting KyoSoft

KyoSoft welcomes any comments, suggestions, or technical questions that you may 
have regarding Link Checker Pro or any other of our products. The easiest 
way to contact KyoSoft is through the online contact form at 
http://www.KyoSoft.com/contact.htm or else by sending an e-mail to 
support@KyoSoft.com. If you are reporting a problem or a suspected bug then 
please include the version number of the product (found at the top of the 
configuration or about screen).



8. Joining the KyoSoft mailing list

If you wish to be kept informed of product releases and upgrades from KyoSoft 
then please send a blank e-mail to subscribe@KyoSoft.com. If you are already a 
member of the mailing list and wish to stop receiving information then send a 
blank e-mail to unsubscribe@KyoSoft.com. You can also subscribe or unsubscribe 
using the online form at http://www.KyoSoft.com

Please note that KyoSoft will not sell or otherwise divulge your e-mail address 
to any third parties. 
