From your HTML book's directory, enter

% make booklist.txt 

Use more or vi to view the booklist.txt file.

% more booklist.txt 
<BOOK NAME=”Hints_Shortcuts” ALIAS=”Hints and Shortcuts (Japanese)” TYPE=”Adi3xDocument” SGITYPE=”sgi_enduser” SGIHIDE=”FALSE” SGIVERSION=”007-3567-001JP, 6/98” SGIBKADDR=”[email protected]” SGISRCHRES=”FALSE” SGISRCHTAGS=”” SGIGROUP=”HTML”>

From Netscape, select Options > Document Encoding, or from Netscape Navigator, select View > Encoding to set the browser's language encoding.

Choose Western for French, German, or Spanish books.
Choose Japanese (Auto-Detect) for Japanese books.

Point the browser to your book by entering the path to your book's index.html file in the Netsite dialog box:

file:/path/to/workarea/index.html 

Test all the links to ensure that they “jump” correctly.

Test all the thumbnail images to ensure that a larger image appears where appropriate.

Log onto your test machine, change to the location where the files would reside if they were installed (the bookshelf), and become superuser:

% rlogin guest@<test_machine> 
% cd /hosts/<machine_name>/usr/share/Insight/library/
<BOOK_LANG>_bookshelves/<BOOKSHELF>/books 
% su 

For example, the path to use for a Japanese end-user manual would be /hosts/<machine_name>/usr/share/Insight/library/ja_JP.EUC_bookshelves/
SGI_EndUser_Japanese/books

Create a directory using the book's short_title:

# mkdir <SHORT_TITLE> 

Copy the .html and booklist.txt file and all directory files into the short title directory:

# cd <SHORT_TITLE> 
# rcp /hosts/<machine_name>/path/to/book/directory/<part_number>/*.* . 
# rcp -r 
/hosts/<machine_name>/path/to/book/directory/<part_number>/<dir> . 

Use vi or jot to add this book's booklist.txt information to the bookshelf's booklist.txt file so it will appear on the IRIS InSight bookshelf.

# vi booklist.txt 

For example, the booklist.txt file for the HTLM book Hints and Shortcuts looks like this:

<BOOK NAME=”Hints_Shortcuts” ALIAS=”Hints and Shortcuts” TYPE=”Adi3xDocument” SGITYPE=”sgi_enduser” SGIHIDE=”FALSE” SGIVERSION=”007-3567-001, 3/98” SGIBKADDR=”[email protected]” SGISRCHRES=”FALSE” SGISRCHTAGS=”” SGIGROUP=”HTML”>

Highlight the string of text or copy it. Close the file.

# cd .. 
# vi booklist.txt 

Position the cursor between other book's booklist.txt information so that the new book's title will appear in alphabetical order with respect to other book titles on the bookshelf. Insert the copied text using the middle mouse key or paste function.

Save and close the booklist.txt file.

Exit root:

# exit 
% rehash 

Launch IRIS InSight on the test machine on which the book is installed:

% iiv -f 

Select the bookshelf on which the book is installed.

Double-click the book icon. The book should appear in a Netscape browser.

From a machine on which the English version is installed, launch IRIS InSight:

% iiv -f 

Select the bookshelf on which the English book is installed.

Double-click the English book's icon. The book should appear in a Netscape browser.

Place the two browsers side by side and begin comparative testing.

Click on all the links to ensure that the localized version behaves the same as the English version.

Ensure that all the images in the localized version match those in the English version.

Click on all thumbnail images to ensure that they launch enlarged versions of the images.