pgsrc/Help%2FSemanticSearchPlugin

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