aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/jssearchfield.mdwn
blob: 2d41ee24fc2fe173fc300a07abee097cbc180d22 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
[[!template id=plugin name=jssearchfield author="[[rubykat]]"]]
[[!tag type/search]]
IkiWiki::Plugin::jssearchfield - Create a search form to search page field data.

This plugin provides the [[ikiwiki/directive/jssearchfield]] directive.  This
enables one to search the structured data ("field" values) of multiple pages.
This uses Javascript for the searching, which means that the entire thing
is self-contained and does not require a server or CGI access, unlike
the default IkiWiki search. This means that it can be used in places such
as ebook readers.  The disadvantage is that because Javascript runs
in the browser, the searching is only as fast as the machine your browser
is running on.

Because this uses Javascript, the htmlscrubber must be turned off for any page where the directive is used.

This plugin depends on the [[!iki plugins/contrib/field]] plugin.

## Activate the plugin

    # activate the plugin
    add_plugins => [qw{goodstuff field jssearchfield ....}],

    # disable scrubbing for search page
    htmlscrubber_skip => 'mysearchpage',

## PREREQUISITES

    IkiWiki
    IkiWiki::Plugin::field
    HTML::Template

## DOWNLOAD

* browse at GitHub: <http://github.com/rubykat/ikiplugins/blob/master/IkiWiki/Plugin/jssearchfield.pm>
* git repo at git://github.com/rubykat/ikiplugins.git