From: Mike Taylor Date: Wed, 23 Jul 2014 15:39:34 +0000 (+0100) Subject: Swap sections 2 and 3 into more logical order. X-Git-Tag: 1.0.0~371^2~1 X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=commitdiff_plain;h=173a94b4cd0c4fbe5aacdaacb637dd86c5b25733 Swap sections 2 and 3 into more logical order. --- diff --git a/doc/library-configuration.txt b/doc/library-configuration.txt index 311c3b0..672cb18 100644 --- a/doc/library-configuration.txt +++ b/doc/library-configuration.txt @@ -22,38 +22,7 @@ is available, maintained using an instance of MKAdmin (often http://mkc-admin.indexdata.com/console/) -2. Choosing targets from the library ------------------------------------- - -MKWS applications can choose what subset of the library's targets to -use, by means of several alternative settings on individual widgets or -in the mkws_config structure: - -* targets -- contains a Pazpar2 targets string, typically of the form - "pz:id=" or "pz:id~" followed by a pipe-separated list of low-level - target IDs. - - At present, these IDs can take one of two forms, depending on the - configuration of the Service Proxy being used: they may be based on - ZURLs, so a typical value would be something like: - pz:id=josiah.brown.edu:210/innopac|lui.indexdata.com:8080/solr4/select?fq=database:4902 - Or they may be UDBs, so a typical value would be something like: - pz:id=brown|artstor - -* targetfilter -- contains a CQL query which is used to find relevant - targets from the relvant library. For example, - udb==Google_Images - Or - categories=news - -* target -- contains a single UDB, that of the sole target to be - used. For example - Google_Images - This is merely syntactic sugar for "targetfilter" with the query - udb==NAME - - -3. Authenticating onto the library +2. Authenticating onto the library ---------------------------------- Some MKWS applications will be content to use the default library with @@ -126,3 +95,35 @@ Once such a library has been set up, and access to it established, target selection within the set that it makes available can be done using the mechanisms above. + +3. Choosing targets from the library +------------------------------------ + +MKWS applications can choose what subset of the library's targets to +use, by means of several alternative settings on individual widgets or +in the mkws_config structure: + +* targets -- contains a Pazpar2 targets string, typically of the form + "pz:id=" or "pz:id~" followed by a pipe-separated list of low-level + target IDs. + + At present, these IDs can take one of two forms, depending on the + configuration of the Service Proxy being used: they may be based on + ZURLs, so a typical value would be something like: + pz:id=josiah.brown.edu:210/innopac|lui.indexdata.com:8080/solr4/select?fq=database:4902 + Or they may be UDBs, so a typical value would be something like: + pz:id=brown|artstor + +* targetfilter -- contains a CQL query which is used to find relevant + targets from the relvant library. For example, + udb==Google_Images + Or + categories=news + +* target -- contains a single UDB, that of the sole target to be + used. For example + Google_Images + This is merely syntactic sugar for "targetfilter" with the query + udb==NAME + +