]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/plugins/search.mdwn
Error handling improvement for preprocess hooks. It's now safe to call error() from...
[git.ikiwiki.info.git] / doc / plugins / search.mdwn
index afeb0d4aa74d9877c0b58ee0d67a32d57f8cbfae..9336b240353ab3c0061fdffb2977e19fbd9bdcfa 100644 (file)
@@ -1,5 +1,18 @@
-This plugin is included in ikiwiki, but is not enabled by default. It adds
-full text search to ikiwiki, using the [[HyperEstraier]] engine.
+[[template id=plugin name=search author="[[Joey]]"]]
+[[tag type/useful]]
 
-It's possible to configure Hyper Estraier via one of ikiwiki's
-[[templates]].
+This plugin adds full text search to ikiwiki, using the
+[xapian](http://xapian.org/) engine, its
+[omega](http://xapian.org/docs/omega/overview.html) frontend, and the
+[[cpan Search::Xapian]], [[cpan Digest::SHA1]], and [[cpan HTML::Scrubber]]
+perl modules.
+
+The [[ikiwiki/searching]] page describes how to write search queries.
+
+Ikiwiki will handle indexing new and changed page contents. Note that since
+it only indexes page contents, files copied by the [[rawhtml]] plugin will
+not be indexed, nor will other types of data files.
+
+There is one setting you may need to use in the config file. `omega_cgi` 
+should point to the location of the omega cgi program. The default location
+is `/usr/lib/cgi-bin/omega/omega`.