4.3. TKL

The LOT software uses TKL to produce help message files, as well as language specific items that are used in search pages, etc.

To edit the TKL content, the administrator interface of TKL must be used. Editing that requires authorization. Username and password for the admin interface is stored in lot/root/users.tkl.

Start the admin interface by using a browser and point to the home page of the portal and specify ?admin=1. For Example if the portal root is http://1.2.3.4/lot/root/, one would specify http://1.2.3.4/lot/root/?admin=1.

4.3.1. Help Files

When you first enter the administration system the page is divided in several sections and one of them is called "Sub-directories in this directory ". In this section you will see a list of subdirectories under the lot/root directory on the server. All the help files are located in the "Help" directory and you enter this directory by clicking the link saying "help - "No title"".

Inside this directory you will see a list of all the help files in the system. You can edit the individual files by clicking the "edit" link to the left of the help files title.

When clicking the edit link a edit window opens where you can edit the text in the text in the help file. The edit window consists of several fields: a title field for each language the system supports, a author field and a body field for each language where the actual help texts goes.

In the body fields valid XHTML must be entered. All elements must have a begin tag and an end tag.

Example 4-1. XHTML

This is invalid XHTML:


		and they lived happily ever after<p>
		The end.<p>
	      

This is valid XHTML:


		and they lived happily ever after<p/>
		The end.<p></p>
	      

You can also use the WYSIWYG XHTML editor by clicking on the magnifying glass to the right of the body text fields.

When you are all done, you press the Save button in the top or the bottom of the page, or the return button if you don't want to save your changes.

4.3.2. Language Files

The language files are located in the directory lang so you select this directory by clicking on the link lang - "No title" on the front admin page.

When inside the lang directory you will see a list of files identified by the English version of the text in the file. So if you want to edit the text "Please enter your name here" you should look for this text here and click the edit link to the right of the text.

The management of the language files happens much in the same way as with the help files. The major difference is that you have a ID field that is used to identify the text in the code. This ID must not be changed.