X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fwhitepaper.markdown;fp=doc%2Fwhitepaper.markdown;h=484252e52719e738ee69f14df973c8bbe18ddb0b;hb=844473c38f99f2a966b44e6dd13f75e5b1f405e8;hp=55c56ec9326904032e8edf4bd7776fc4691ac075;hpb=60afd17f51bc15184a7d59f29549318c90a7242a;p=mkws-moved-to-github.git
diff --git a/doc/whitepaper.markdown b/doc/whitepaper.markdown
index 55c56ec..484252e 100644
--- a/doc/whitepaper.markdown
+++ b/doc/whitepaper.markdown
@@ -84,7 +84,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 +273,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 +355,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 +485,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