FindinSite-CD: Search engine for CD/DVD   .
 
Powered by FindinSite-MS
. Home | Examples | Starting | Set up | Advanced | Languages | Purchasing | Email .
. .
  Overview | Index loading | Word highlighting | Word rules | Search page template | Field searches

 

findinsite-cd word highlighting


Introduction

Popup blockers
Some browsers have an option to stop web pages throwing up popup windows. This will stop the FindinSite-CD word highlighting popup window. If you want to be on the safe side, then do not use this; instead highlight words to a new window or within a frameset - see here.
In some browsers, FindinSite-CD highlights search text words in displayed web pages, and adds navigation arrows to let you move between instances of the words on the found page. FindinSite-CD can only highlight words in HTML web pages, ie not in PDF/DOC/XLS/PPT/TXT files.

By default, highlighting is done to a new browser window by FindinSite-CD. Alternatively, you can highlight to the same browser window using a popup window that runs the fisLight applet. See the screen options for more details.

  • Highlighting works in Windows Internet Explorer 4+
  • 29/Sep/03: Highlighting mostly works in Windows Opera 7.11 emulating MSIE, but not in O7.20.
  • 29/Sep/03: Highlight works in Windows Netscape 6.1 to a new page, but not to self.
  • 3/Dec/07: Highlighting works in FireFox to the same window and to a new window; within framesets, highlighting is not enabled.
  • 3/Dec/07: Highlighting is not enabled in any Mac system.
Please check full compatibility here.

This page starts with various examples of highlighting in action. If word highlighting does not work or goes wrong then it may be because the page was saved from Internet Explorer or Word - both problems can be fixed.

Highlighting options can be altered as described below. If using the fisLight popup window, remember to set the relevant parameters in the popup web page instead of the main FindinSite-CD search page.


Highlighting example

Searching for brown car in Microsoft Internet Explorer 4+ or similar
Josie jumped out of the car> and landed in the <brown> mud.
A <brown car> came past and splashed her.
"<Brown car, go away!" shouted Josie.
The example on the right shows how FindinSite-CD highlights search words and adds navigation arrows to let you move between the various instances of the search words on the page. The arrows are not shown if the search words are part of a hypertext link.

The page is scrolled so that the first search word is visible in the browser window. Clicking Refresh in the browser displays the page without any word highlighting.

Adjacent words search

Searching for "brown car"
Josie jumped out of the car and landed in the brown mud.
A brown car> came past and splashed her.
"<Brown car, Go away!" shouted Josie.
An adjacent words search only finds words that are next to each other. (The search words must be surrounded by double quotes characters.) The word highlighting similarly only highlights instances where the search words are next to each other.

Letter case search

Searching for 'Brown'
Josie jumped out of the car and landed in the brown mud.
A brown car came past and splashed her.
"Brown car, Go away!" shouted Josie.
A letter case search only finds words with matching capital and lower case letters. (The search words must be surrounded by single quotes characters.) The word highlighting similarly only highlights the desired words.


No highlighting

There are various instances when no word highlighting is possible. In these cases, the page will just be shown as normal with no word highlighting.
  • The browser and Java do not implement JavaScript, eg Internet Explorer version 3.
  • Netscape Navigator version 4 or earlier
  • The displayed page is on another web site

Words between the following pairs of tags are not highlighted:

  • <APPLET> ... </APPLET>
  • <SCRIPT> ... </SCRIPT>
  • <STYLE> .. </STYLE>
  • <DIV class=nospy> ... </DIV>

Pages saved by Internet Explorer

If word highlighting does not work, it might be because you are using pages that have been saved by Internet Explorer (IE). Some versions of IE insert a "saved from url" header line. Removing this line safely makes word highlighting work.

<!-- saved from url=(0071)http://another.server/whatever.html -->

The reason for the problem is that the inserted line makes IE work as if the page came from the original URL. The word highlighter will not work if the page is on a different server, and so simply displays the page without any highlighting.

Pages saved by Microsoft Word etc

Web pages saved by Microsoft Word or other Office documents may show incorrectly:  the words are highlighted correctly, but blanks appear instead of images. This happens because the word highlighting page update process confuses the Vector Markup Language (VML) engine.

To fix this problem, you must strip the excess Office markup from your saved pages using the Office HTML Filter available from this page: http://office.microsoft.com/downloads/2000/Msohtmf2.aspx. Then:

  • Either run the "Microsoft Office HTML Filter 2.0" tool from "Microsoft Office Tools" on the Start menu. Add the files to strip and then click Apply.
  • Or, you can create VML-free documents from Word as follows: On the File menu, select "Export To" and then "Compact HTML".

Existing JavaScript onLoad event handler

Another possible problem occurs if you have JavaScript code that runs when the onLoad() event is fired. FindinSite-CD does highlighting by rewriting the entire page HTML; this may confuse the page JavaScript or the FindinSite-CD word highlighting. In this case, the only realistic option is to turn off word highlighting.


Configuring Highlighting

FindinSite-CD word highlighting can be configured in several ways. For full details, please see the various Highlight parameters described on the parameters page.

You configure FindinSite-CD by adding (or altering) the HTML in your search page. For example, to turn off word highlighting completely, add this line:

<PARAM NAME=highlight VALUE="off">

If you use fisLight to do word highlighting (in a popup window or as a part of frameset) then various highlighting parameters need to be set for fisLight as well. For the standard popup window, also add the parameters to the popup window page fiscdpop.htm. Do this for these parameters: HighlightStart, HighlightStop, HighlightNavBack, HighlightNavNext and HighlightAnchorName.

Highlight parameter

on Turns on word highlighting in Windows IE4+
off Turns off word highlighting completely
nojump Turns off jumping to first instance of word.
nonav Turns off navigation arrows in Internet Explorer 4 or later
frameset[,frameno] Enables word highlighting in a frameset.
Specify a frameno if fisLight is not in frame number 0. See example
nopopup Turns off highlighting using a popup window

HighlightStart and HighlightStop parameters

Give these parameters if you want to override the default highlighting shown in this table:
HighlightStart <SPAN STYLE='background: yellow;'><FONT COLOR=red><B>
HighlightStop </B></FONT></SPAN>

HighlightNavBack and HighlightNavNext parameters

Give these parameters if you want to override the default navigation arrows shown in this table:
HighlightNavBack <B>&lt;</B>
HighlightNavNext <B>&gt;</B>

HighlightAnchorName parameter

FindinSite-CD inserts anchors into the page for the navigation arrows. By default the anchor names are "fisanchor" followed by a number, eg "fisanchor1".

Specify this parameter if you want to override the default base anchor name shown in this table:

HighlightAnchorName fisanchor

PopupWindow parameter

By default, FindinSite-CD's popup window is contained in a file called fiscdpop.htm - this is one of the standard FindinSite-CD runtime files. If you want to use a different filename, then set this parameter.

PopupUsingURL parameter

The highlighting popup window is run from FindinSite-CD using JavaScript. The normal method works with most Java VM versions for Internet Explorer. However if the PopupWindow parameter is set to a different host (eg http://127.0.0.1:8080/fiscdpop.htm) then the normal method does not work. Set the PopupUsingURL parameter to any value to use a method that does work. However note that this method does not work if you use the Sun VM 1.4.1 in Internet Explorer - your users must upgrade to version 1.4.2.

If you use PopupUsingURL, then the popup window page must set the fisLight "useURL" parameter. It is also recommended that the fisLight "die" parameter be set to "30" so that has 30 seconds to do its job:

<PARAM NAME=useURL VALUE="yes">
<PARAM NAME=die VALUE="30">
The PopupWindow and PopupUsingURL parameters are normally used when running FindinSite-CD and Dynamic-CD together on one CD - more information.

IEhiliteLoadMethod parameter

If you are highlighting using FindinSite-CD then you can specify a JavaScript method that is called after highlighting when run Internet Explorer. This might be useful to repeat some "onload" functionality which might otherwise not be done.

To do this, set the IEhiliteLoadMethod parameter,. eg:
<param name="IEhiliteLoadMethod" value="onloaded">

The following JavaScript code is then run after highlighting:
if( w.onloaded!==null) { w.onloaded(); } ";

  All site Copyright © 1996-2011 PHD Computer Consultants Ltd, PHDCC   Privacy  

Last modified: 12 August 2010.

Valid HTML 4.01 Transitional Valid CSS!