X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/af9566ff1ae55d273ff96c7ca39e34265623a55d..623c7e17989f53ef049f12639950d2c50c9edd4f:/doc/plugins/search.mdwn diff --git a/doc/plugins/search.mdwn b/doc/plugins/search.mdwn index afeb0d4aa..4d517a266 100644 --- a/doc/plugins/search.mdwn +++ b/doc/plugins/search.mdwn @@ -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/web]] -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::SHA]], and [[!cpan HTML::Scrubber]] +perl modules (on debian, check that you have packages `xapian-omega`, `libsearch-xapian-perl`, `libdigest-sha-perl` and `libhtml-scrubber-perl` installed). + +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`.