Hi all,
I came across this nifty looking sidebar for Python documentation at
http://projects.edgewall.com/python-sidebar/. Is there something
similar for Ruby? If not, does someone need a project? 
Regards,
Dan
Daniel Berger wrote:
Hi all,
I came across this nifty looking sidebar for Python documentation at
http://projects.edgewall.com/python-sidebar/\. Is there something
similar for Ruby? If not, does someone need a project?
Actually, it looks pretty trivial; : % s/Python/Ruby/g did 1/3 the work. I think; have to test this.
I can put one together for ruby-doc.org.
James
James Britt wrote:
Daniel Berger wrote:
Hi all,
I came across this nifty looking sidebar for Python documentation at
http://projects.edgewall.com/python-sidebar/\. Is there something
similar for Ruby? If not, does someone need a project?Actually, it looks pretty trivial; : % s/Python/Ruby/g did 1/3 the work. I think; have to test this.
Less trivial than my first glance suggested, but then I wasn't happy
with the prospect of hand-coding XHTML and maintaining consistent, tabbed headings if pages are added or removed.
So, I wrote a tool to write a tool: code that slurps in a combo of YAML
and Textile, gloms them with some simple templates, and writes out set of files suitable for an attractive Firefox sidebar.
I can put one together for ruby-doc.org.
Which you can see here:
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically update the source files so that current versions can be generated using cron.
Comments welcome.
James
James Britt wrote:
> I can put one together for ruby-doc.org.
Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically
update the source files so that current versions can be generated using
cron.Comments welcome.
Very nice! Covers all the obvious bases content-wise
I'll toss in a vote for a RubyGarden Wiki search for a future version.
I sure wish that search box was on the top of the page.
running on WInXP Mozilla 1.7.2 for your records.
Thx much! 
···
--
Bill Guindon (aka aGorilla)
Oh yes, very good. Runs very well under Firefox 0.9.1
Thank you for this nice toolbar. --David Ross
Running DragonFlyBSD with Firefox 0.9.1 
···
--- James Britt <jamesUNDERBARb@neurogami.com> wrote:
James Britt wrote:
> Daniel Berger wrote:
>
>> Hi all,
>>
>> I came across this nifty looking sidebar for
Python documentation at
>> http://projects.edgewall.com/python-sidebar/\. Is
there something
>> similar for Ruby? If not, does someone need a
project?
>
>
> Actually, it looks pretty trivial; : %
s/Python/Ruby/g did 1/3 the
> work. I think; have to test this.Less trivial than my first glance suggested, but
then I wasn't happy
with the prospect of hand-coding XHTML and
maintaining consistent,
tabbed headings if pages are added or removed.So, I wrote a tool to write a tool: code that slurps
in a combo of YAML
and Textile, gloms them with some simple templates,
and writes out set
of files suitable for an attractive Firefox sidebar.>
> I can put one together for ruby-doc.org.Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll
do much more for the
moment. Down the line, though, there needs to be a
way to automagically
update the source files so that current versions can
be generated using
cron.Comments welcome.
James
__________________________________
Do you Yahoo!?
Yahoo! Mail Address AutoComplete - You start. We finish.
http://promotions.yahoo.com/new_mail
would it be possible to get a developer section on
there for announcements and Ruby changes? Mainly the
commit messages out of the CVS for Ruby_1_8. I watch
the cvs bot that was set up on IRC, but it would be
nice to see it when I browse the web :). --David Ross
···
--- James Britt <jamesUNDERBARb@neurogami.com> wrote:
James Britt wrote:
> Daniel Berger wrote:
>
>> Hi all,
>>
>> I came across this nifty looking sidebar for
Python documentation at
>> http://projects.edgewall.com/python-sidebar/\. Is
there something
>> similar for Ruby? If not, does someone need a
project?
>
>
> Actually, it looks pretty trivial; : %
s/Python/Ruby/g did 1/3 the
> work. I think; have to test this.Less trivial than my first glance suggested, but
then I wasn't happy
with the prospect of hand-coding XHTML and
maintaining consistent,
tabbed headings if pages are added or removed.So, I wrote a tool to write a tool: code that slurps
in a combo of YAML
and Textile, gloms them with some simple templates,
and writes out set
of files suitable for an attractive Firefox sidebar.>
> I can put one together for ruby-doc.org.Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll
do much more for the
moment. Down the line, though, there needs to be a
way to automagically
update the source files so that current versions can
be generated using
cron.Comments welcome.
James
__________________________________
Do you Yahoo!?
Yahoo! Mail Address AutoComplete - You start. We finish.
http://promotions.yahoo.com/new_mail
Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically
update the source files so that current versions can be generated using
cron.
Looks good and will be quite useful.
One thing that would be nice is for the sidebar to be listed as a
"proper" side bar i.e. available in View -> Sidebar -> xxx, rather
than something accessed by a bookmark.
Firefox 0.9.3, WinXP Pro
James Britt <jamesUNDERBARb@neurogami.com> wrote in message news:<413D4D1B.1060104@neurogami.com>...
James Britt wrote:
> Daniel Berger wrote:
>
>> Hi all,
>>
>> I came across this nifty looking sidebar for Python documentation at
>> http://projects.edgewall.com/python-sidebar/\. Is there something
>> similar for Ruby? If not, does someone need a project?
>
>
> Actually, it looks pretty trivial; : % s/Python/Ruby/g did 1/3 the
> work. I think; have to test this.Less trivial than my first glance suggested, but then I wasn't happy
with the prospect of hand-coding XHTML and maintaining consistent,
tabbed headings if pages are added or removed.So, I wrote a tool to write a tool: code that slurps in a combo of YAML
and Textile, gloms them with some simple templates, and writes out set
of files suitable for an attractive Firefox sidebar.>
> I can put one together for ruby-doc.org.Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically
update the source files so that current versions can be generated using
cron.Comments welcome.
James
Awesome! Thanks James!
- Dan
It probabbly did not get to the list the first time (at least I do not
see it):
The sidebar is very nice.
But to be useful for me I would have to see readable text in the sidebar
and the linked documentation.
Because the background is set to some light color or image, the text
color is not set on the web pages, and my default text color is light
the text is almost invisible.
This applies to links in the sidebar, text in stdlib, visited links in
ruby cookbook, all text in Unofficial Ruby Usage Guide, all text in
Programming ruby, text in core classes.
I keep a fixed copy of ProgrammingRuby around while writing some ruby
stuff but I am not going to try mirroring and fixing all that.
Thanks
Michal Suchanek
···
On Tue, Sep 07, 2004 at 02:55:02PM +0900, James Britt wrote:
James Britt wrote:
Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically
update the source files so that current versions can be generated using
cron.
Robert McGovern wrote:
Which you can see here:
Ruby-Doc.org: Documenting the Ruby Language
version 0.1 for safety's sake, though I doubt I'll do much more for the
moment. Down the line, though, there needs to be a way to automagically
update the source files so that current versions can be generated using
cron.Looks good and will be quite useful.
One thing that would be nice is for the sidebar to be listed as a
"proper" side bar i.e. available in View -> Sidebar -> xxx, rather
than something accessed by a bookmark.
I followed whatever instructions I could find on making this happen; all the pages I came across said to use a mozilla/firefox-specific javascript call:
window.sidebar.addPanel ("Ruby Sidebar",
"http://www.ruby-doc.org/docbar/toc_tut.html",""\);
But that does not do quite what I would have expected.
If anyone knows of a better way to get the pages added as a true sidebar, rather than as a bookmark-that-may-be-opened-in-the-sidebar, please let me know.
James
Bill Guindon wrote:
Very nice! Covers all the obvious bases content-wise
I'll toss in a vote for a RubyGarden Wiki search for a future version.
I sure wish that search box was on the top of the page.
I added RubyGarden wiki search.
James
Michal 'hramrach' Suchanek wrote:
It probabbly did not get to the list the first time (at least I do not
see it):
I posted to the mailing list, not Usenet.
The sidebar is very nice.
Thank you.
But to be useful for me I would have to see readable text in the sidebar
and the linked documentation.
Because the background is set to some light color or image, the text
color is not set on the web pages, and my default text color is light
the text is almost invisible.
All styles, including the background image, are set in an external CSS file.
What browser are you using that the default text color is a light color, rather than, say, black?
Are you explicitly overriding page styles?
James
I followed whatever instructions I could find on making this happen; all
the pages I came across said to use a mozilla/firefox-specific
javascript call:window.sidebar.addPanel ("Ruby Sidebar",
"http://www.ruby-doc.org/docbar/toc_tut.html",""\);But that does not do quite what I would have expected.
No, not very intuitive.
If anyone knows of a better way to get the pages added as a true
sidebar, rather than as a bookmark-that-may-be-opened-in-the-sidebar,
please let me know.
I'll keep an eye out.
Rob
thx much. can it be set to display results in the main window? right
now they stay in the sidebar, and things get a bit screwy there.
···
On Tue, 7 Sep 2004 23:18:59 +0900, James Britt <jamesunderbarb@neurogami.com> wrote:
I added RubyGarden wiki search.
--
Bill Guindon (aka aGorilla)
Michal 'hramrach' Suchanek wrote:
>
>It probabbly did not get to the list the first time (at least I do not
>see it):I posted to the mailing list, not Usenet.
I was speaking about my message I posted earlier.
>
>The sidebar is very nice.Thank you.
>
>But to be useful for me I would have to see readable text in the sidebar
>and the linked documentation.
>Because the background is set to some light color or image, the text
>color is not set on the web pages, and my default text color is light
>the text is almost invisible.All styles, including the background image, are set in an external CSS file.
What browser are you using that the default text color is a light color,
rather than, say, black?
It is not important which browser is it. Most work this way.
I set the default background to dark green and the text and link to
light yellowish color. The pages that do not have any style render in
these colors, those that have complete, correct style render in their own
colors, and those that have partial style (ie only background) render
partially with their own colors and partially with the default colors.
It is also not important if the style is in the page or an external
stylesheet, except the stylesheet is easier to fix.
I hope it is obvious that if the page has only partial style it may (and
will) break with default colors that are different from the author's
default colors.
Are you explicitly overriding page styles?
No. If I did that, I would see everything perfectly but all pages would
be the same.
Thanks
Michal Suchanek
···
On Fri, Sep 10, 2004 at 12:26:58AM +0900, James Britt wrote:
If anyone knows of a better way to get the pages added as a true
sidebar, rather than as a bookmark-that-may-be-opened-in-the-sidebar,
please let me know.
Here: http://v2studio.com/k/moz/rubysidebar.xpi
It may be overkill to write an extension to do it, but it was the only way I found.
Perhaps in the future I could implement a local copy to use when offline.
Bill Guindon wrote:
···
On Tue, 7 Sep 2004 23:18:59 +0900, James Britt > <jamesunderbarb@neurogami.com> wrote:
I added RubyGarden wiki search.
thx much. can it be set to display results in the main window? right
now they stay in the sidebar, and things get a bit screwy there.
Well, that won't do. I'll go fix it.
Thanks for the heads up.
James
Michal 'hramrach' Suchanek wrote:
It is not important which browser is it. Most work this way.
I set the default background to dark green and the text and link to
light yellowish color. The pages that do not have any style render in
these colors, those that have complete, correct style render in their own
colors, and those that have partial style (ie only background) render
partially with their own colors and partially with the default colors.
It is also not important if the style is in the page or an external
stylesheet, except the stylesheet is easier to fix.I hope it is obvious that if the page has only partial style it may (and
will) break with default colors that are different from the author's
default colors.Are you explicitly overriding page styles?
No. If I did that, I would see everything perfectly but all pages would
be the same.
OK, now I understand. Should be better now.
Thanks for pointing this out.
James
If anyone knows of a better way to get the pages added as a true
sidebar, rather than as a bookmark-that-may-be-opened-in-the-sidebar,
please let me know.
actually, the server admin is lazy to set a proper mime type, so try this link for a direct install:
···
It may be overkill to write an extension to do it, but it was the only way I found.
Perhaps in the future I could implement a local copy to use when offline.
... and some folks would like the results to stay in the sidebar. Any
hopes for configurability in future version?
Oh, by the way. The Ruby sidebar is incredibly awesome. I think it's
the most useful tool for me since the Developer sidebar from Devedge.
Nice job to all parties
-- Brian Wisti
http://coolnamehere.com/
···
--- James Britt <jamesUNDERBARb@neurogami.com> wrote:
Bill Guindon wrote:
> On Tue, 7 Sep 2004 23:18:59 +0900, James Britt > > <jamesunderbarb@neurogami.com> wrote:
>
>>I added RubyGarden wiki search.
>>
>
>
> thx much. can it be set to display results in the main window?
right
> now they stay in the sidebar, and things get a bit screwy there.
>Well, that won't do. I'll go fix it.
Thanks for the heads up.
James