`s to your page
+that have special `class` attributes. We do the rest.
+
+Supported Browsers
+------------------
+
+Any modern browser will work fine. JavaScript must be enabled.
+
+* IE8 or later
+* Firefox 17 or later
+* Google Chrome 27 or later
+* Safari 6 or later
+* Opera 12 or later
+* iOS 6.x (iPhone, iPad)
+* Android 4.x
+
+Not supported: IE6, IE7
A minimal example
-----------------
@@ -20,20 +38,62 @@ A minimal example
Here is a completely functional (though ugly) MKWS-based
searching application:
-
-
That's it. A complete metasearching application. Everything
else is refinement.
+Configuring a client (short version)
+------------------------------------
+
+The application's HTML must contains the following elements as well as
+whatever makes up the application itself:
+
+Prerequisites:
+
+~~~
+
`s can be added (with no content), and
+will be filled in by MKWS:
+
+* `
` -- switch between record and target views
+* `
` -- switch between English, Danish and German
+* `
` -- search box and button
+* `
` -- result list, including pager/sorting
+* `
` -- target list, including status
+* `
` -- summary statistics
+
+You can configure and control the client by creating an `mkws_config`
+object before loading the widget-set. Here is an example showing how
+to use options to offer a choice between English and German UI
+languages, and to default to sorting by title ascending:
+
+~~~
+
+~~~
+
+For much more detail, see:
+[Embedded metasearching with the MasterKey Widget Set](mkws-manual.html)
+
Documentation
-------------
-* The
README -- mostly technical details.
+* This file.
+ [
PDF version]
* The
MKWS manual, including a reference section.
- This is a much better introduction.
+ [
PDF version]
+* The
MKWS developers' guide.
+ [
PDF version]
Tools
-----
@@ -45,10 +105,12 @@ Here are the files that this web-site provides:
*
pazpar2/js/pz2.js --
Low-level JavaScript library for access to the MasterKey web
service.
-*
handlebars-v1.1.2.js --
+*
handlebars-v2.0.0.js --
A local copy of
the Handlebars templating library,
since it doesn't like to be hotlinked.
+* Local copy of
jquery-1.10.0.min.js
+* Local copy of
jquery.json-2.4.js
*
mkws-complete.js --
A single large JavaScript file containing everything needed for
MKWS to work: the widget-set itself, the API library, and
@@ -56,22 +118,16 @@ Here are the files that this web-site provides:
*
mkws.css --
A stylesheet which styles only MasterKey widgets, and does not
otherwise interfere with application-site's styles.
+*
mkws-jquery.js --
+ An experimental jQuery plugin that provides an MKWS-based
+ metasearching applet.
Minified versions of the MKWS JavaScript files are also available:
*
mkws.min.js
*
mkws-complete.min.js
-(This domain also hosts two web-service endpoints that are used by
-running MKWS-based applications:
-`/service-proxy-auth`
-is used to authenticate new sessions and
-`/service-proxy/`
-is the main endpoint for searching and retrieval. But there is
-no need to use these directly: the widgets take care of that.)
-
-Versions
---------
+### Specific versions
The links above to the various forms of the widget-set JavaScript
(
mkws.js,