Helpviewer/OpenSearch/OpenSearchEngine.py

changeset 4739
bbd2cc223fc7
parent 4631
5c1a96925da4
child 5389
9b1c800daff3
--- a/Helpviewer/OpenSearch/OpenSearchEngine.py	Sun Feb 14 13:09:41 2016 +0100
+++ b/Helpviewer/OpenSearch/OpenSearchEngine.py	Sun Feb 14 13:19:05 2016 +0100
@@ -136,6 +136,30 @@
         """
         Public method to set the engine search URL template.
         
+        The URL template is processed according to the specification:
+        <a
+          href="http://www.opensearch.org/Specifications/OpenSearch/1.1#OpenSearch_URL_template_syntax">
+        http://www.opensearch.org/Specifications/OpenSearch/1.1#OpenSearch_URL_template_syntax</a>
+
+        A list of template parameters currently supported and what they are
+        replaced with:
+        <table>
+        <tr><td><b>Parameter</b></td><td><b>Value</b></td></tr>
+        <tr><td>{count}</td><td>20</td></tr>
+        <tr><td>{startIndex}</td><td>0</td></tr>
+        <tr><td>{startPage}</td><td>0</td></tr>
+        <tr><td>{language}</td>
+          <td>the default language code (RFC 3066)</td></tr>
+        <tr><td>{country}</td>
+          <td>the default language code (RFC 3066) converted to lower
+              case</td></tr>
+        <tr><td>{inputEncoding}</td><td>UTF-8</td></tr>
+        <tr><td>{outputEncoding}</td><td>UTF-8</td></tr>
+        <tr><td>{searchTerms}</td><td>the string supplied by the user</td></tr>
+        <tr><td>{*:source}</td>
+          <td>application name, QCoreApplication::applicationName()</td></tr>
+        </table>
+        
         @param searchUrlTemplate search URL template of the engine (string)
         """
         self._searchUrlTemplate = searchUrlTemplate

eric ide

mercurial