X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Findex.markdown;h=d0cb8c433073eda270814a71ff73a9a48092777f;hb=d8748a0afe2f674734f5d2a1995b6059a613dd7c;hp=4484c19d4064a722d1c34e4f520c0a5568c15eba;hpb=39eac47536fb243f9b871312832412a6394ddf75;p=mkws-moved-to-github.git

diff --git a/doc/index.markdown b/doc/index.markdown
index 4484c19..d0cb8c4 100644
--- a/doc/index.markdown
+++ b/doc/index.markdown
@@ -17,6 +17,21 @@ searching with minimal effort.  All you need to do is pull in our
 JavaScript and optional stylesheet, then add `<div>`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
 -----------------
 
@@ -30,28 +45,51 @@ searching application:
 That's it. A complete metasearching application. Everything
 else is refinement.
 
-Supported Browsers
-------------------
+Configuring a client (short version)
+------------------------------------
 
-Any modern browser will work fine. JavaScript must be enabled.
+The application's HTML must contains the following elements as well as
+whatever makes up the application itself:
 
-* 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
+Prerequisites:
 
-Not supported: IE6, IE7
+~~~
+	<link rel="stylesheet" href="http://mkws.indexdata.com/mkws.css" />
+	<script type="text/javascript" src="http://mkws.indexdata.com/mkws-complete.js"></script>
+~~~
+
+Then the following special `<div>`s can be added (with no content), and
+will be filled in by MKWS:
+
+* `<div id="mkwsSwitch"></div>` -- switch between record and target views
+* `<div id="mkwsLang"></div>  ` -- switch between English, Danish and German
+* `<div id="mkwsSearch"></div>` -- search box and button
+* `<div id="mkwsResults"></div>` -- result list, including pager/sorting
+* `<div id="mkwsTargets"></div>` -- target list, including status
+* `<div id="mkwsStat"></div>` -- 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:
+
+~~~
+    <script type="text/javascript">
+      var mkws_config = {
+        lang_options: ["en", "de" ],
+        sort_default: "title:1"
+      };
+    </script>
+~~~
+
+For much more detail, see:
+[Embedded metasearching with the MasterKey Widget Set](mkws-manual.html)
 
 Documentation
 -------------
 
 * This file.
   [<a href="index.pdf">PDF version</a>]
-* The <a href="README.html">README</a> -- mostly technical details.
-  [<a href="README.pdf">PDF version</a>]
 * The <a href="mkws-manual.html">MKWS manual, including a reference section.</a>
   [<a href="mkws-manual.pdf">PDF version</a>]
 * The <a href="mkws-developer.html">MKWS developers' guide.</a>
@@ -89,8 +127,7 @@ Minified versions of the MKWS JavaScript files are also available:
 * <a href="mkws.min.js">mkws.min.js</a>
 * <a href="mkws-complete.min.js">mkws-complete.min.js</a>
 
-Versions
---------
+### Specific versions
 
 The links above to the various forms of the widget-set JavaScript
 (<a href="mkws.js">mkws.js</a>,