Saturday, October 06, 2007

Browser Search Plugins for SunWikis and Confluence

One of the small but useful features of the next release of SunWikis, due some time next week, will be support for Open Search descriptors.

Open Search descriptors (OSD) help browsers (and other clients) to discover ways to search content of a website. If you go to a site that supports OSD and you are using an Open Search enabled browser, the browser will notify you about the possibility of adding the current site's search among the browser's search plugins (Firefox does this by glowing the down arrow in the search box).



Once the search plugin is installed, you can search SunWikis directly from your browser's search box.



While I was at it, I created this descriptor for Confluence documentation located in the DOC wiki space at confluence.atlassian.com and a second descriptor that searches the DOC, DISC (Confluence Community), and CONFEXT (Confluence Extensions) wiki spaces at the same time.

So now I can search SunWikis and Confluence docs with ease:



If you are interested in installing these plugins as well (even before we make them available at wikis.sun.com), click on the links below:

Warning: As for SunWikis, you can install the search plugin now, but once the next SunWikis release is out, you should probably reinstall it just in case we tweak and enhance it.


NameContentClick to Install1Download OSD2
SunWikiswikis.sun.com
all spaces
InstallDownload
Confluenceconfluence.atlassian.com
the DOC space
InstallDownload
Confluence+Extrasconfluence.atlassian.com
the DOC, DISC, and CONFEXT spaces
N/A3Download


Who knows, maybe Atlassian will use my code and officially support these search descriptors on their site - they have my full support.

As for technical details, I plan to write wrote another entry just about how I created and added these descriptors to Confluence.


1 Might or might not work for your browser. Click and sit tight :)
2 The OSD file can be used for an alternative installation method - If you have Firefox and Mac you can place the file into /Users/[yourname]/Library/Application\ Support/Firefox/Profiles/[the profile name]/searchplugins/ and restart Firefox, for other platforms, check out this doc
3 Due to limitations of the Sherlock format, it is not possible to craft a "click-to-install" file for the 3rd plugin, however you can still install it using the alternative2 installation method.

No comments: