# Ruby-doc.org search for your browser toolbar

**URL:** <https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501>\
**Category:** Ruby\
**Created:** [March 3, 2007, 3:06am UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501 "2007-03-03T03:06:02Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![byrnejb](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/b/d2c977/32.png) [@byrnejb](https://www.ruby-forum.com/u/byrnejb)\
**Post date:** [March 3, 2007, 3:06am UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501/1 "2007-03-03T03:06:02Z")

</div>

Thanks to Greg Whiteley, [ruby-doc.org](http://ruby-doc.org) has a slick new feature.

I recently changed the search function on the site. The search covers  
not just ruby-doc, but a number of other informative Ruby Web resources.  
That part is not new; I had been using Rollyo to handle the aggregated  
Web search.

Now, though, the search is powered by Google’s custom search feature.  
It’s very, very nice (for one thing, search results are returned as a  
page in the [ruby-doc.org](http://ruby-doc.org) domain, rather than taking you off to some  
other site), but the query URLs are way fugly. To remedy this, I hacked  
up some mod\_rewrite magic, so that one can search with a clean URL, as  
in these examples:

[Ruby-Doc.org: Documenting the Ruby Language](http://www.ruby-doc.org/q/REXML)  
[Ruby-Doc.org: Documenting the Ruby Language](http://www.ruby-doc.org/q/RJS+partials)

Greg took this a step further and created a browser search toolbar  
auto-discovery file. Users of Firefox 2 and IE7 (and possibly others)  
who visit the site should now see the search toolbar icon (usually in  
the upper right of the browser) become highlighted.

Clicking the icon will then give you the option of adding the  
[ruby-doc.org](http://ruby-doc.org) search to your search toolbar.

Try it!

–  
James B.

[http://www.ruby-doc.org](http://www.ruby-doc.org) - Ruby Help & Documentation  
[http://www.rubystuff.com](http://www.rubystuff.com) - The Ruby Store for Ruby Stuff  
[http://www.jamesbritt.com](http://www.jamesbritt.com) - Playing with Better Toys

---

<div class="post-metadata">

**Author:** ![byrnejb](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/b/d2c977/32.png) [@byrnejb](https://www.ruby-forum.com/u/byrnejb)\
**Post date:** [March 3, 2007, 4:57am UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501/2 "2007-03-03T04:57:10Z")

</div>

On Mar 2, 2007, at 8:05 PM, James B. wrote:

> Thanks to Greg Whiteley, [ruby-doc.org](http://ruby-doc.org) has a slick new feature.

Forgive my subject change, but can I ask why the Core documentation  
now includes most of the standard library as well? I think this has  
hurt it’s browsibilty.

James Edward G. II

---

<div class="post-metadata">

**Author:** ![byrnejb](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/b/d2c977/32.png) [@byrnejb](https://www.ruby-forum.com/u/byrnejb)\
**Post date:** [March 3, 2007, 7:27am UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501/3 "2007-03-03T07:27:16Z")

</div>

James Edward G. II wrote:

> On Mar 2, 2007, at 8:05 PM, James B. wrote:
> 
> > Thanks to Greg Whiteley, [ruby-doc.org](http://ruby-doc.org) has a slick new feature.
> 
> Forgive my subject change, but can I ask why the Core documentation now  
> includes most of the standard library as well? I think this has hurt  
> it’s browsibilty.

What’s there is simply the output of running rdoc over the main source,  
as has always been the case. There seem to have been changes in the  
source code or the .document files.

I’d prefer to see no distinction at all, but have the docs be clear on  
whether a given class/module/method is built-in, or requires ‘requires’  
on something, and so on. But, right now, the docs show, for example,  
YAML methods as being built into core classes, such as Array. So there  
is all sorts of confusion.

However, this may be a topic better discussed on the ruby-core or  
ruby-doc lists.

–  
James B.

“A language that doesn’t affect the way you think about programming is  
not worth knowing.”

- A. Perlis

---

<div class="post-metadata">

**Author:** ![byrnejb](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/b/d2c977/32.png) [@byrnejb](https://www.ruby-forum.com/u/byrnejb)\
**Post date:** [March 4, 2007, 6:28am UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501/4 "2007-03-04T06:28:29Z")

</div>

On 3/3/07, James B. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> in these examples:  
> [Ruby-Doc.org: Documenting the Ruby Language](http://www.ruby-doc.org/q/REXML)  
> [Ruby-Doc.org: Documenting the Ruby Language](http://www.ruby-doc.org/q/RJS+partials)  
> Greg took this a step further and created a browser search toolbar  
> auto-discovery file. Users of Firefox 2 and IE7 (and possibly others)  
> who visit the site should now see the search toolbar icon (usually in  
> the upper right of the browser) become highlighted.  
> Clicking the icon will then give you the option of adding the  
> [ruby-doc.org](http://ruby-doc.org) search to your search toolbar.

indeed. ruby-doc is getting better and better. great doc + great  
language = who could ask for more. many thanks to ruby-doc team!

kind regards -botp

---

<div class="post-metadata">

**Author:** ![byrnejb](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/b/d2c977/32.png) [@byrnejb](https://www.ruby-forum.com/u/byrnejb)\
**Post date:** [March 3, 2007, 4:44pm UTC](https://www.ruby-forum.com/t/ruby-doc-org-search-for-your-browser-toolbar/87501/5 "2007-03-03T16:44:11Z")

</div>

On 3/2/07, James B. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> Greg took this a step further and created a browser search toolbar  
> auto-discovery file. Users of Firefox 2 and IE7 (and possibly others)  
> who visit the site should now see the search toolbar icon (usually in  
> the upper right of the browser) become highlighted.
> 
> Clicking the icon will then give you the option of adding the  
> [ruby-doc.org](http://ruby-doc.org) search to your search toolbar.

Any chance that someone with the right mojo might help us poor  
beknighted souls still running Firefox 1.5 with a less automatic way  
to add it to the search engine list?

–  
Rick DeNatale

My blog on Ruby  
[http://talklikeaduck.denhaven2.com/](http://talklikeaduck.denhaven2.com/)
