root/Apache-CustomKeywords/trunk/README

Revision 708 (checked in by miyagawa, 18 years ago)

Initial revision

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1 NAME
2     Apache::CustomKeywords - Customizable toolbar for MSIE
3
4 SYNOPSIS
5       # 1. As an Apache proxy
6       Listen 8888
7       <VirtualHost *:8888>
8       PerlTransHandler +Apache::CustomKeywords
9       CustomKeyword cpan http://search.cpan.org/search?mode=module&query=%s
10       CustomKeyword perldoc http://perldoc.com/cgi-bin/htsearch?words=%s&restrict=perl5.8.0
11       CustomKeyword google http://www.google.com/search?q=%s
12       </VirtualHost>
13
14       # 2. As a pseudo-MSN
15       <Location /response.asp>
16       SetHandler perl-script
17       PerlHandler +Apache::CustomKeywords
18       CustomKeyword cpan http://search.cpan.org/search?mode=module&query=%s
19       # ...
20       </Location>
21
22 DESCRIPTION
23     Apache::CustomKeywords is a customizable proxy/webapp to change your
24     MSIE's Location box to your favourite toolbar!
25
26     See http://www.mozilla.org/docs/end-user/keywords.html for what Custom
27     Keywords means in Mozilla. This module enables Custom Keywords in MSIE.
28
29     With "CustomKeyword" settings shown in the section on "SYNOPSIS", you
30     type "cpan CustomKeywords" or "google blah blah" in your browser's
31     Location: box, then you will be redirected to the page you wanna go to!
32
33     Here's the way this handler works:
34
35     *   Type "foo bar" in Location: box
36
37     *   MSIE sends request to "auto.search.msn.com"
38
39     *   Apache::CustomKeywords detects it and redirects browser to your
40         favourite search engine.
41
42 CONFIGURATION
43     There're two ways to let your browser use this module:
44
45     As a proxy server
46         configure "httpd.conf" with a proxy version and set up your
47         browser's proxy setting.
48
49     As a pseudo MSN
50         configure "httpd.conf" with psuedo MSN version and set up your Hosts
51         file ("/etc/hosts" in Un*x, "Windows/Hosts" or
52         "windows/system/drivers/etc/Hosts" in Win32) or local DNS so that
53         "auto.search.msn.com" points to the server this module is installed.
54
55 NOTE
56     If you put ":" or "@" as a query in Location: box, MSIE recognizes it as
57     protocol or authentication password stuff, hence this module might not
58     work.
59
60 TODO
61     *   User-definable conversion of query paramers, including encoding
62         conversions. Currenty only %s interpolates to URI-Escaped string
63         encoded in UTF8.
64
65 AUTHOR
66     Tatsuhiko Miyagawa <miyagawa@bulknews.net>
67
68     This library is free software; you can redistribute it and/or modify it
69     under the same terms as Perl itself.
70
71 SEE ALSO
72     the mod_perl manpage, http://www.mozilla.org/docs/end-user/keywords.html
73
Note: See TracBrowser for help on using the browser.