X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fwhitepaper.markdown;h=c9b3fad211700a282f115eb444a06d9e4b682890;hb=a357fd9c277761f924834010520997d65f916cf1;hp=55c56ec9326904032e8edf4bd7776fc4691ac075;hpb=332476fc8812c7d656ed8fddb5a1e61d873802f5;p=mkws-moved-to-github.git
diff --git a/doc/whitepaper.markdown b/doc/whitepaper.markdown
index 55c56ec..c9b3fad 100644
--- a/doc/whitepaper.markdown
+++ b/doc/whitepaper.markdown
@@ -1,6 +1,5 @@
% Embedded metasearching with the MasterKey Widget Set
% Mike Taylor
-% July-September 2013
Introduction
@@ -84,7 +83,7 @@ header, which are loaded from the tool site mkws.indexdata.com:
contains all the JavaScript needed by the widget-set.
* `mkws.css`
- provides the default CSS styling
+ provides the default CSS styling
Second, within the HTML body, `
` elements with special IDs that
begin `mkws` can be provided. These are filled in by the MKWS code,
@@ -273,9 +272,14 @@ generally visible on the page is a search box, and the results appear
in a popup. The key part of such an application is this invocation of
the MKWS jQuery plugin:
-
+
+
+
+
+
+
+
+
The necessary scaffolding can be seen in an example application,
http://example.indexdata.com/index-popup.html
@@ -350,7 +354,7 @@ Element Type Default Description
debug_level int 1 Level of debugging output to emit. 0 = none, 1 = messages, 2 = messages with
datestamps, 3 = messages with datestamps and stack-traces.
-facets array *Note 1* Ordered list of names of facets to display. Supported facet names are
+facets array *Note 1* Ordered list of names of facets to display. Supported facet names are
`xtargets`, `subject` and `author`.
lang string en Code of the default language to display the UI in. Supported language codes are `en` =
@@ -480,48 +484,43 @@ and
-### jQuery plugin invocation
+### jQuery UI popup invocation
-The MasterKey Widget Set can be invoked as a jQuery plugin rather than
-by providing an HTML skeleton explicitly. When this approach is used,
-the invocation is a single line of JavaScript:
+The MasterKey Widget Set can be invoked in a popup window on top of the page.
-
+Note that when using the `popup` layout, facilities from the jQuery UI
+toolkit are used, so it's necessary to include both CSS and JavaScript
+from that toolkit. The relevant lines are:
-This code should be inserted in the page at the position where the
-metasearch should occur.
+
+
-When invoking this plugin, a key-value lookup table of named options
-may be passed in to modify the default behaviour, as in the exaple
-above. The available options are as follows:
+
+
+
+
+
+
+
+
-
+---
### The structure of the HTML generated by the MKWS widgets
@@ -595,4 +594,4 @@ and .CLASS indicates an instance of a class.
- - -
-Copyright (C) 2013 by IndexData ApS,
+Copyright (C) 2013-2014 by IndexData ApS,