diff --git a/mediawiki/Specifications/OpenSearch/Extensions/Parameter/1.0/Draft 2.wiki b/mediawiki/Specifications/OpenSearch/Extensions/Parameter/1.0/Draft 2.wiki index d7bea7a..b7ace21 100644 --- a/mediawiki/Specifications/OpenSearch/Extensions/Parameter/1.0/Draft 2.wiki +++ b/mediawiki/Specifications/OpenSearch/Extensions/Parameter/1.0/Draft 2.wiki @@ -23,7 +23,7 @@ multipart/form-data". The XML Namespaces URI for the OpenSearch parameter extension is: -: http://a9.com/-/spec/opensearch/extensions/parameters/1.0/ +: http://a9.com/-/spec/opensearch/extensions/parameters/1.0/ == Elements == @@ -67,33 +67,38 @@ Describes a name/value pair to be included in the search request. ::: Default: "1" ::: Requirements: This attribute is optional. :: maximum - Contains a string that identifies the maximum number of times this parameter must be included in the search request. The literal string "*" will be interpreted to mean that the parameter may repeat an arbitrary number of times. -::: Restrictions: The value must be a non-negative integer or the literal string "*". +::: Restrictions: The value must be a non-negative integer or the literal string "*". ::: Default: "1" ::: Requirements: This attribute is optional. :: pattern - Contains a string that specifies a regular expression against which the parameter's value. When present the element should also include a title attribute to inform the client application of the format expected. -::: Restrictions: Must be a valid pattern according to the [http://www.ecma-international.org/publications/standards/Ecma-262.htm JavaScript] Pattern production. +::: Restrictions: Must be a valid pattern according to the [http://www.ecma-international.org/publications/standards/Ecma-262.htm JavaScript] Pattern production. ::: Default: "" ::: Requirements: This element may appear zero or one time. :: title - Contains a string with advisory information for the format and valid values of the parameter, such as would be appropriate for a tooltip. -::: Restrictions: The value must contain 1024 or fewer characters of plain text. The value must not contain HTML or other markup. +::: Restrictions: The value must contain 1024 or fewer characters of plain text. The value must not contain HTML or other markup. ::: Default: "" ::: Requirements: This attribute is optional but recommended when a pattern attribute is present. -:: minExclusive - Contains a string that identifies the minimum value for the element that cannot be reached. Applies only to numeric and date types. +:: minExclusive - Contains a string that identifies the minimum value for the element that cannot be reached. Applies only to numeric and date types. ::: Default: "" ::: Requirements: This element may appear zero or one time. -:: maxExclusive - Contains a string that identifies maximum value for the element that cannot be reached. Applies only to numeric and date types. +:: maxExclusive - Contains a string that identifies maximum value for the element that cannot be reached. Applies only to numeric and date types. ::: Default: "" ::: Requirements: This element may appear zero or one time. -:: minInclusive - Contains a string that identifies minimum value for the element that can be reached. Applies only to numeric and date types. +:: minInclusive - Contains a string that identifies minimum value for the element that can be reached. Applies only to numeric and date types. ::: Default: "" ::: Requirements: This element may appear zero or one time. :: maxInclusive - Contains a string that identifies maximum value for the element that can be reached. Applies only to numeric and date types. ::: Default: "" ::: Requirements: This element may appear zero or one time. - -:: step - Contains a string that identifies the granularity of the allowed values between the minimal and maximal range. +:: step - Contains a string that identifies the granularity of the allowed values between the minimal and maximal range. ::: Default: "" ::: Requirements: This element may appear zero or one time (only relevant when the max or min attributes are present). +:: maxPeriod - Contains a string that identifies the maximum temporal period allowed and is defined as a string value consistent with ISO_8601 duration. +::: Default: "" +::: Requirements: This element may appear zero or one time. +:: relativeTo - In the case where a maxPeriod is defined for a temporal parameter, the relativeTo attribute will reference the other temporal parameter name and vice versa. +::: Default: "" +::: Requirements: This element may appear zero or one time. (only relevant when the maxPeriod attribute is present). ''Example of a Parameter element used to represent a simple required core search parameter:'' @@ -106,15 +111,15 @@ Describes a name/value pair to be included in the search request. ''Example of a Parameter element used to represent a repeating custom search parameter:'' - - + ''Example of a Parameter element used to represent an optional time extension custom search parameter restricted to 2011'' - +''Example of a Parameter element used to represent an optional time extension custom search parameter with maxPeriod of 6 months'' + + + + + === The "Option" element === Describes a value/label pair suggested to the client for the parent element. : Parent: Parameter -: Attributes: -:: value - Contains a string with the value of the option. -::: Restrictions: The value must be URL-encoded. +: Attributes: +:: value - Contains a string with the value of the option. +::: Restrictions: The value must be URL-encoded. ::: Requirements: This attribute is '''required'''. :: label - Contains a string that provides a label for the option. ::: Default: The value must contain 512 or fewer characters of plain text. The value must not contain HTML or other markup. @@ -138,49 +161,49 @@ Describes a value/label pair suggested to the client for the parent element. ''Example of a Parameter element used to represent a optional hexadecimal RGB color custom search parameter, with 3 suggested values:'' - - + '' Example of a OpenSearch Description supporting the Earth Observation and Temporal Extensions. The OpenSearch Parameter extension elements are used to suggest clients the possible values for temporal range and acquisition station names'' - - + - - Web Search - Example.com Web Search - Use Example.com to search the Web. - example web - admin@example.com - Web Search + Example.com Web Search + Use Example.com to search the Web. + example web + admin@example.com + - + - + - Copyright 2005, Example.com, Inc. - open + Copyright 2005, Example.com, Inc. + open - - + + == Processing Rules == @@ -207,4 +230,4 @@ Pedro Gonçalves This document is made available by [http://a9.com A9.com] subject to the terms of the [http://creativecommons.org/licenses/by-sa/2.5/ Creative Commons Attribution-ShareAlike 2.5 License]. [[Category:Specification]] -[[Category:Extension]] \ No newline at end of file +[[Category:Extension]]