Add list of widgets that can use "autosearch" config setting.
authorMike Taylor <mike@indexdata.com>
Wed, 5 Nov 2014 15:04:10 +0000 (15:04 +0000)
committerMike Taylor <mike@indexdata.com>
Wed, 5 Nov 2014 15:04:10 +0000 (15:04 +0000)
Re-indent all completed entries again to make space *sigh*.

doc/mkws-manual.markdown

index 0ff995a..f346691 100644 (file)
@@ -858,11 +858,15 @@ the relevant widgets are listed. All entries are optional, but if specified must
 default values are in footnotes to keep the table reasonably narrow.
 
 ----
-Element                   Widget  Type    Default   Description
---------                  ------  -----   --------- ------------
+Element                   Widget    Type    Default   Description
+--------                  ------    -----   --------- ------------
 auth_hostname
 
-autosearch
+autosearch                facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
 facet
 
@@ -870,40 +874,40 @@ facet_caption_*
 
 facet_max_*
 
-facets                            array   *Note 1*  Ordered list of names of facets to display. Supported facet names are
-                                                    `xtargets`, `subject` and `author`.
+facets                              array   *Note 1*  Ordered list of names of facets to display. Supported facet names are
+                                                      `xtargets`, `subject` and `author`.
 
-lang                              string  en        Code of the default language to display the UI in. Supported language codes are
-                                                    `en` = English, `de` = German, `da` = Danish, and whatever additional languages
-                                                    are configured using `language_*` entries (see below).
+lang                                string  en        Code of the default language to display the UI in. Supported language codes are
+                                                      `en` = English, `de` = German, `da` = Danish, and whatever additional languages
+                                                      are configured using `language_*` entries (see below).
 
-lang_options                      array   []        A list of the languages to offer as options. If empty (the default), then all
-                                                    configured languages are listed.
+lang_options                        array   []        A list of the languages to offer as options. If empty (the default), then all
+                                                      configured languages are listed.
 
-language_*                        hash              Support for any number of languages can be added by providing entries whose
-                                                    name is `language_` followed by the code of the language. See the separate
-                                                    section below for details.
+language_*                          hash              Support for any number of languages can be added by providing entries whose
+                                                      name is `language_` followed by the code of the language. See the separate
+                                                      section below for details.
 
 limit
 
-log_level                         int     1         Level of debugging output to emit. 0 = none, 1 = messages, 2 = messages with
-                                                    datestamps, 3 = messages with datestamps and stack-traces.
+log_level                           int     1         Level of debugging output to emit. 0 = none, 1 = messages, 2 = messages with
+                                                      datestamps, 3 = messages with datestamps and stack-traces.
 
 maxrecs
 
 paragraphs
 
-pazpar2_url                       string  *Note 2*  The URL used to access the metasearch middleware. This service must be
-                                                    configured to provide search results, facets, etc. It may be either unmediated
-                                                    or Pazpar2 the MasterKey Service Proxy, which mediates access to an underlying
-                                                    Pazpar2 instance. In the latter case, `service_proxy_auth` must be provided.
+pazpar2_url                         string  *Note 2*  The URL used to access the metasearch middleware. This service must be
+                                                      configured to provide search results, facets, etc. It may be either unmediated
+                                                      or Pazpar2 the MasterKey Service Proxy, which mediates access to an underlying
+                                                      Pazpar2 instance. In the latter case, `service_proxy_auth` must be provided.
 
 perpage
 
-perpage_default                   string  20        The initial value for the number of records to show on each page.
+perpage_default                     string  20        The initial value for the number of records to show on each page.
 
-perpage_options                   array   *Note 3*  A list of candidate page sizes. Users can choose between these to determine how
-                                                    many records are displayed on each page of results.
+perpage_options                     array   *Note 3*  A list of candidate page sizes. Users can choose between these to determine how
+                                                      many records are displayed on each page of results.
 
 pp2_hostname
 
@@ -911,42 +915,42 @@ pp2_path
 
 query
 
-query_width                       int     50        The width of the query box, in characters.
+query_width                         int     50        The width of the query box, in characters.
 
-responsive_design_width           int               If defined, then the facets display moves between two locations as the
-                                                    screen-width varies, as described above. The specified number is the threshhold
-                                                    width, in pixels, at which the facets move between their two locations.
+responsive_design_width             int               If defined, then the facets display moves between two locations as the
+                                                      screen-width varies, as described above. The specified number is the threshhold
+                                                      width, in pixels, at which the facets move between their two locations.
 
 scan_all_nodes
 
 sentences
 
-service_proxy_auth                url     *Note 4*  A URL which, when `use_service_proxy` is true, is fetched once at the beginning
-                                                    of each session to authenticate the user and establish a session that
-                                                    encompasses a defined set of targets to search in.
+service_proxy_auth                  url     *Note 4*  A URL which, when `use_service_proxy` is true, is fetched once at the beginning
+                                                      of each session to authenticate the user and establish a session that
+                                                      encompasses a defined set of targets to search in.
 
-service_proxy_auth_domain         domain            Can be set to the domain for which `service_proxy_auth` proxies authentication,
-                                                    so that cookies are rewritten to appear to be from this domain. In general,
-                                                    this is not necessary, as this setting defaults to the domain of `pazpar2_url`.
+service_proxy_auth_domain           domain            Can be set to the domain for which `service_proxy_auth` proxies authentication,
+                                                      so that cookies are rewritten to appear to be from this domain. In general,
+                                                      this is not necessary, as this setting defaults to the domain of `pazpar2_url`.
 
-show_lang                         bool    true      Indicates whether or not to display the language menu.
+show_lang                           bool    true      Indicates whether or not to display the language menu.
 
-show_perpage                      bool    true      Indicates whether or not to display the perpage menu.
+show_perpage                        bool    true      Indicates whether or not to display the perpage menu.
 
-show_sort                         bool    true      Indicates whether or not to display the sort menu.
+show_sort                           bool    true      Indicates whether or not to display the sort menu.
 
-show_switch                       bool    true      Indicates whether or not to display the switch menu, for switching between
-                                                    showing retrieved records and target information.
+show_switch                         bool    true      Indicates whether or not to display the switch menu, for switching between
+                                                      showing retrieved records and target information.
 
 sort
 
-sort_default                      string  relevance The label of the default sort criterion to use. Must be one of those in the
-                                                    `sort` array.
+sort_default                        string  relevance The label of the default sort criterion to use. Must be one of those in the
+                                                      `sort` array.
 
-sort_options                      array   *Note 6*  List of supported sort criteria. Each element of the list is itself a
-                                                    two-element list: the first element of each sublist is a pazpar2
-                                                    sort-expression such as `data:0` and the second is a human-readable label such
-                                                    as `newest`.
+sort_options                        array   *Note 6*  List of supported sort criteria. Each element of the list is itself a
+                                                      two-element list: the first element of each sublist is a pazpar2
+                                                      sort-expression such as `data:0` and the second is a human-readable label such
+                                                      as `newest`.
 
 sp_auth_credentials
 
@@ -964,8 +968,8 @@ template
 
 text
 
-use_service_proxy                 bool    true      If true, then a Service Proxy is used to deliver searching services rather than
-                                                    raw Pazpar2.
+use_service_proxy                   bool    true      If true, then a Service Proxy is used to deliver searching services rather than
+                                                      raw Pazpar2.
 ----
 
 Perhaps we should get rid of the `show_lang`, `show_perpage`,