`s with well-known -identifiers in any HTML page, the various components of an application +MKWS classes in any HTML page, the various components of an application can be embedded: search-boxes, results areas, target information, etc. @@ -57,17 +57,16 @@ The following is a complete MKWS-based searching application: -

-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. - +Go ahead, try it! Simply put the above in a file (e.g index.html), +drop it into a folder accessible with an ordinary web-server (e.g Apache) +and load it in your web browser (and no, usually, you can't just load the file +directly from disk as some browsers, e.g Chrome, won't allow storing cookies). +Just like that, you have working metasearching. How the example works --------------------- @@ -431,7 +430,7 @@ this is very simple: "//sp-mkws.indexdata.com/service-proxy/?command=auth&action=perconfig" }; -> TODO This should be the default setting: see MKWS-251. +> TODO This should be the default setting: see **MKWS-251**. And ensure that access to the MWKS application is from the correct Referrer URL or IP-range. @@ -446,10 +445,10 @@ URL containing that hostname, such as > TODO It should be possible to change just the hostname without > needing to repeat the rest of the URL (protocol, path, query): see -> MKWS-252. +> **MKWS-252**. > TODO When changing the SP authentication URL, the Pazpar2 URL should -> in general change along with it: see MKWS-253. +> in general change along with it: see **MKWS-253**. ### (Optional): embed credentials for access to the library @@ -461,7 +460,7 @@ by setting the `service_proxy_auth` configuration item to a URL such as > TODO It should be possible to add the username and password to the > configuration without needing to repeat the rest of the URL: see -> MKWS-254. +> **MKWS-254**. ### (Optional): conceal credentials from HTML source @@ -482,7 +481,7 @@ yourname.com: Step 1: add a rewriting authentication alias to the configuration: RewriteEngine on - RewriteRule /spauth/ http://mkws.indexdata.com/service-proxy/?command=auth&action=check,login&username=U&password=PW [P] + RewriteRule /spauth/ http://sp-mkws.indexdata.com/service-proxy/?command=auth&action=check,login&username=U&password=PW [P] Step 2: set the MKWS configuration item `service_proxy_auth` to @@ -620,9 +619,9 @@ structure. 3. [10, 20, 30, 50] -4. http://mkws.indexdata.com/service-proxy-auth +4. http://sp-mkws.indexdata.com/service-proxy-auth -5. http://mkws.indexdata.com/service-proxy/ +5. http://sp-mkws.indexdata.com/service-proxy/ 6. [["relevance"], ["title:1", "title"], ["date:0", "newest"], ["date:1", "oldest"]] @@ -701,19 +700,19 @@ from that toolkit. The relevant lines are: