pgsrc/Help%2FSemanticSearchPlugin

   1 Date: Thu, 15 Apr 2010 16:32:58 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC-20100415)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FSemanticSearchPlugin;
   6   flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
   7   markup=2;
   8   charset=UTF-8
   9 Content-Transfer-Encoding: binary
  10
  11 Search for relations/attributes and its values.
  12
  13 page - relation::object. e.g list all cities: is_a::city => relation=is_a&s=city
  14
  15 We search for both a relation and if the search is valid for attributes also, and OR combine the result.
  16
  17 An attribute has just a value, which is a number, and which is for sure no pagename, and its value goes through some units unification. (not yet)
  18
  19 We can also do numerical comparison and unit lifting with attributes:
  20 *  population > 1000000
  21 *  population > 1 million
  22
  23 Limitation:
  24 * The backends can already do simple AND/OR combination of multiple relations and attributes to search for. Just the UI not. TODO: implement the AND/OR buttons.  population < 1 million AND area > 50 km2
  25 * Due to attribute internals a relation search with matching attribute names will also find those attribute names, but not the values. You must explicitly search for attributes then.
  26
  27 The Advanced query can do a freeform query expression with multiple comparison and nesting.
  28 * "is_a::city and population > 1.000.000 and population < 10.000.000"
  29 * "(is_a::city or is_a::country) and population < 10.000.000"
  30
  31 == Usage
  32 {{{
  33 <<SemanticSearch arguments>>
  34 }}}
  35
  36 == Arguments
  37
  38 {| class="bordered"
  39 |-
  40 ! Argument
  41 ! Description
  42 ! Default value
  43 |-
  44 | **s**
  45 | linkvalue query string
  46 | *
  47 |-
  48 | **page**
  49 | which pages (glob allowed)
  50 | * (all)
  51 |-
  52 | **relation**
  53 | linkname. which relations.
  54 | all
  55 |-
  56 | **attribute**
  57 | linkname. which attributes.
  58 | all
  59 |-
  60 | **attr_op**
  61 | a funny written way for equality for pure aesthetic pleasure "All attributes which have this value set"
  62 | :=
  63 |-
  64 | **units**
  65 |
  66 |
  67 |-
  68 | **case_exact**
  69 |
  70 | true
  71 |-
  72 | **regex**
  73 | no word splitting, if no regex op is present, defaults to exact match
  74 | auto
  75 |-
  76 | **noform**
  77 | don't show form with results.
  78 | false
  79 |-
  80 | **noheader**
  81 | no caption
  82 | false
  83 |-
  84 | **info**
  85 | valid: pagename, relation, linkto, attribute, value and all other pagelist columns
  86 | false
  87 |}
  88
  89 == Example
  90
  91 {{{
  92 <<SemanticSearch>>
  93 }}}
  94
  95 <<SemanticSearch>>
  96
  97 == Author
  98 * [[PhpWiki:ReiniUrban|Reini Urban]]
  99
 100 == See Also
 101
 102 <noinclude>
 103 ----
 104 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
 105 </noinclude>