Standard CDs

A Standard CD uses a viewer program, lbview.exe, to view content on the CD.   Web pages and search forms appear exactly as they would in a web browser, and all search functions work as they would on a web site, including any JavaScript embedded in search forms. 

Because no HTTP server is needed, the CD is not affected by firewall software.

CD Layout

The top-level folder of the CD will contain these files:

File Purpose

autorun.inf

Specifies the program to start when the CD is inserted

cdrun.exe

The program launched when the CD is inserted, as specified in autorun.inf

cdrun.xml

Options specifying what cdrun.exe should do when it starts

Below this folder will be a root folder with two sub-folders: 

The root\data folder will be equivalent to the / folder on a web site, so /something.html would be found in root\data\something.html

The root\cgi-bin folder will be equivalent to the /cgi-bin folder on a web site, and can hold any CGI programs for the web site.

Startup

The startup sequence when a CD is inserted into a user's CD drive is as follows.

  1. Windows opens the autorun.inf file to get the program to launch, which is cdrun.exe.

  2. cdrun.exe starts and checks that the components listed in the dependencies section of cdrun.xml are present.  If any components are missing, cdrun.exe will display a warning message (as specified in cdrun.xml) and exit. 

  3. cdrun.exe launches lbview.exe, the browser that accesses the CD.

  4. lbview.exe starts and checks the lbview.ini file for the recommended Internet Explorer and Adobe Reader versions.  If either product is older than the recommended version, the user will be prompted to download the latest version from the Microsoft or Adobe web site.

  5. lbview.exe opens the home page for the CD, root\data\index.html

  6. If the user clicks the search icon in the browser, the search page for the CD will open, root\data\dtsearch.html

System Requirements

Windows version:  Windows 10 or later. 

Internet Explorer version:  Internet Explorer is required to enable hit navigation and hit highlighting to work. 

Adobe Reader version:  A PDF viewer that supports highlighting hits is required or PDF files will appear without hit highlighting.  For information on PDF viewers that support hit highlighting, please see PDF viewers that support highlighting hits.

Error Pages

The root\data\builtin folder on the CD contains these pages that are displayed in lbview.exe when an error occurs.

File Purpose

GetNewIE.html

Appears at startup when the Internet Explorer version is older than what is specified in lbview.ini as the minimum recommended Internet Explorer version.  This page contains a link that the user can click to suppress the page from appearing the next time the CD starts.

GetAdobe.html

Appears at startup when the Adobe Reader version is older than what is specified in lbview.ini as the minimum recommended version.  This page contains a link that the user can click to suppress the page from appearing the next time the CD starts.

GetPlugin.html

Appears at startup when an Adobe Reader plug-in is needed to highlight hits in PDF files.  This page contains a link that the user can click to suppress the page from appearing the next time the CD starts.

Error.html

Appears when any other browsing error occurs, such as a broken link leading to a "page not found" error.

 

lbview.ini Settings

The following settings in lbview.ini can be used to control the behavior of lbview.exe

HomePage=/index.html
Specifies the first page that opens when the CD starts.

SearchPage=/dtSearch.html
Specifies the page that opens when the user clicks the search button.

WebLinksInBrowser=1
Specifies whether external links should open in the user's web browser or in the lbview.exe program.   For example, suppose a page on your CD contains a link to https://www.microsoft.com.  If WebLinksInBrowser is set to 1, when this link is clicked the user's web browser will open over the lbview.exe program.  If WebLinksInBrowser is set to 0, the link will open in the lbview.exe program.

ExternalLaunchExtensions=xls;doc;ppt;wpd;docx;pptx;xlsx;rtf
List extensions to launch outside of the lbview.exe program.  This enables you to create links in the CD to Word or other Office documents and have them open in their application when the user clicks a link.

CopyFileExtensions=zip
List extensions to copy instead of opening when clicked.  These extensions can be used to create links to automatically copy certain files from the CD.

MinimumAdobeReaderVersion=6
Specifies the minimum version of Adobe Reader (or Adobe Acrobat) recommended to use with this CD.   If an older version is present, or if Adobe Reader is not installed, the user will be prompted to get Adobe Reader from the Adobe web site.  If your CD will not contain PDF files, you can set this to 0 (zero).

GetAdobeReaderPage=/builtin/GetAdobe.html
The page to display when a newer version of Adobe Reader is needed. 

MinimumIEVersion=5
The minimum version of Internet Explorer recommended to use with this CD.  If an older version is present, the user will be prompted to upgrade.

GetNewIEPage=/builtin/GetNewIE.html
The page to display when a newer version of Internet Explorer is needed.

MinimumPdfPluginVersion=1
The minimum version the dtSearch PDF Search Highlighter Plug-in for Adobe Reader that is needed to highlight hits.  Set to zero to suppress prompts to download the plug-in.

GetPdfPluginPage=/builtin/GetPlugin.html
The page to display when the dtSearch PDF Search Highlighter Plug-in for Adobe Reader is not installed.

EnablePdfHighlightMessage=Would you like to enable hit highlighting for PDF files (currently disabled in Adobe Reader or Adobe Acrobat)?
SilentEnablePdfHighlighting=1
If PDF hit highlighting is disabled in Adobe Reader 9 or Adobe Acrobat 9, the lbview.exe program can change this setting to enable hit highlighting before opening a PDF file.  You can use EnablePdfHighlightMessage to ask permission to make this change, or set SilentEnablePdfHiglighting to have lbview.exe make the change without asking permission.

The option to disable hit highlighting is present starting in Adobe Reader and Adobe Acrobat 9.0, in the Preferences > Search settings ("Enable search highlights from external highlight server").

Launching Programs from the Viewer

Standard CDs support a special URL format that lets you launch a program from a link in a page on the CD.  To create a link that launches a program,

(1) Put the program in the root/cgi-bin folder under the CD master folder.

(2) Create a link on a page as follows:

<a href="cmd://launch/YourProgramName.exe">Click here to launch the program</a>

The lbview.exe viewer will execute the program YourProgramName.exe in root/cgi-bin when this linked is clicked.

Using Tabs

You can make a link open in a different tab using the target attribute in the link tag, like this:

<a href="othertab.html" target="_new">click here</a>

A user can close a tab by clicking the X icon, or you can create a link to close a tab by using javascript:window.close(), like this:

<a href="javascript:window.close();">click here to close this tab</a>

Internet Explorer normally pops up a warning message when a script attempts to close a window.  To prevent this, lbview.exe watches for the exact sequence "javascript:window.close();" and closes the current tab silently when this occurs in a link.