<script type="text/javascript" src="http://mkws.indexdata.com/mkws-complete.js"></script>
</head>
<body>
- <div id="mkwsSwitch"></div>
- <div id="mkwsLang"></div>
<div id="mkwsSearch"></div>
<div id="mkwsResults"></div>
- <div id="mkwsTargets"></div>
- <div id="mkwsStat"></div>
</body>
</html>
+Go ahead, try it! You don't even need a web-server. Just copy and
+paste this HTML into a file on your computer -- `/tmp/magic.html`,
+say -- and point your web-browser at it:
+`file:///tmp/magic.html`. Just like that, you have working
+metasearching.
+
+
+Explanation
+-----------
+
+If you know any HTML, the structure of the file will be familar to
+you: the `<html>` element at the top level contains a `<head>` and a
+`<body>`. In addition to whatever else you might want to put on your
+page, you can add MKWS elements.
+
+These fall into two categories. First, the prerequisites in the HTML
+header, which are loaded from the tool site mkws.indexdata.com:
+
+* `mkws-complete.js`
+ contains all the JavaScript needed by the widget-set.
+
+* `mkwsStyle.css`
+ provides the default CSS styling
+
+Second, the `<div>` elements with special IDs that begin `mkws` can be
+provided. These are filled in by the MKWS code, and provide the
+components of the searching UI. The very simple application above has
+only two such components: a search box and a results area. But more
+are supported. The main `<div>`s are:
+
+* `mkwsSearch` -- provides the search box and button.
+
+* `mkwsResults` -- provides the results area, including a list of
+ brief records (which open out into full versions when clicked),
+ paging for large results sets, facets for refining a search, sorting
+ facilities, etc.
+
+* `mkwsLang` -- provides links to switch between one of several
+ different UI languages. By default, English, Danish and German are
+ provided.
+
+* `mkwsSwitch` --
+
+* `mkwsTargets` --
+* `mkwsStat` --
+
+### different HTML structure
+
More sophisticated applications will not simply place the `<div>`s
together, but position them carefully within an existing page
framework -- such as a Drupal template, an OPAC or a SharePoint page.
+Breaking up mkwsResults
+
+### configuration object
+
+resposive resize
+
+### overriding styles
+
+### use jQuery popup
+
+### Authentication setups
+
+Configuring targets
+
+### Reference
+
+Configuration object
+
+jQuery plugin invocation
+
+The structure of the HTML generated by the MKWS widgets
+
- - -
Copyright (C) 2013 by IndexData ApS, <http://www.indexdata.com>
projects / mkws-moved-to-github.git / commitdiff