Document, for each config setting, which widgets it pertains to.
[mkws-moved-to-github.git] / doc / mkws-manual.markdown
index 0ff995a..55c5f67 100644 (file)
@@ -858,114 +858,164 @@ 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
---------                  ------  -----   --------- ------------
-auth_hostname
+Element                   Widget    Type    Default   Description
+--------                  ------    -----   --------- ------------
+auth_hostname             _global_
 
-autosearch
+autosearch                facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-facet
+facet                     facet
 
-facet_caption_*
+facet_caption_*           facet
 
-facet_max_*
+facet_max_*               facet
 
-facets                            array   *Note 1*  Ordered list of names of facets to display. Supported facet names are
-                                                    `xtargets`, `subject` and `author`.
+facets                    _team_    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                      _team_    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              lang      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_*                _global_  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
+limit                     facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-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                 _global_  int     1         Level of debugging output to emit. 0 = none, 1 = messages, 2 = messages with
+                                                      datestamps, 3 = messages with datestamps and stack-traces.
 
-maxrecs
+maxrecs                   facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-paragraphs
+paragraphs                reference
 
-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               _global_  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                   facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-perpage_default                   string  20        The initial value for the number of records to show on each page.
+perpage_default           _team_    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           ranking   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
+pp2_hostname              _global_
 
-pp2_path
+pp2_path                  _global_
 
-query
+query_width               _search_  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   _global_  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            _global_
 
-scan_all_nodes
+sentences                 reference
 
-sentences
+service_proxy_auth        _global_  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 _global_  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                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             ranking    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                ranking    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              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                      facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-sort
+sort_default              _team_    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              ranking   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       _global_
 
-sp_auth_credentials
+sp_auth_path              _global_
 
-sp_auth_path
+sp_auth_query             _global_
 
-sp_auth_query
+target                    facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-target
+targetfilter              facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-targetfilter
+targets                   facet,
+                          facets,
+                          record,
+                          records,
+                          results
 
-targets
+template                  details,
+                          done,
+                          facet,
+                          facets,
+                          images,
+                          lang,
+                          navi,
+                          pager,
+                          progress,
+                          ranking,
+                          record,
+                          records,
+                          reference,
+                          results,
+                          search,
+                          stat,
+                          switch,
+                          targets
 
-template
+text                      builder
 
-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         _global_  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`,