Forum: Ruby Rote 0.3.0 (doc/web)

Announcement (2017-05-07): www.ruby-forum.com is now read-only since I unfortunately do not have the time to support and maintain the forum any more. Please see rubyonrails.org/community and ruby-lang.org/en/community for other Rails- und Ruby-related community platforms.
82e62c756d89bc6fa0a0a2d7f2b1e617?d=identicon&s=25 Ross Bamford (Guest)
on 2005-12-12 14:35
(Received via mailing list)
Hi,

Rote 0.3.0 is now available for download from
http://rote.rubyforge.org/.
This is a big step for Rote, and incorporates many new features along
with
many improvements and fixes to existing functionality.

New features such as page filters, Ruby syntax highlighting (surprise
surprise ;) and integration with HTML Tidy, along with more flexible
configuration when the defaults won't do and improved resource / page
dependency handling make this version of Rote a more capable package
than
ever before.

Rote is a Ruby-based templating / documentation builder based on Rake
that
lets you fully integrate your documentation build with your Rake tasks,
and supports ERB rendering, plaintext formatting, arbitrary filtering,
and
layout. Although very flexible, Rote favours convention and has no
'configuration' beyond the Rake task definition and Ruby code applied to
pages.

This upgrade introduces some incompatibilities with Rote 0.2.x builds
(only small changes needed).

Please note a small error has been found in the template project
distributed with Rote. After creating a project you will need to remove
the 'format_opts << ...' line from doc/pages/index.rb. That'll teach me
to
make releases late at night...

Cheers,
Ross
82e62c756d89bc6fa0a0a2d7f2b1e617?d=identicon&s=25 Ross Bamford (Guest)
on 2005-12-14 21:13
(Received via mailing list)
(Straight to the fix:
http://rubyforge.org/frs/?group_id=1120&release_id=3802 )

On Mon, 12 Dec 2005 13:26:13 -0000, I innocently wrote:

> Please note a small error has been found in the template project
> distributed with Rote...

How innocuous it seemed at first :(

===[CUT]===

In response to a number of late-breaking issues with the recent Rote
0.3.0
release, a maintainence release is now available from Rubyforge FRS and
Gems, numbered version 0.3.0.2. This release fixes the following
critical
issues with 0.3.0:

	* Template project / builtin rakefile inoperable
	* Common code inhertance malfunction
	* Base macro filter was an old version
	* Formatting unit test was an old version

These issues were at the root of many problems with 0.3.0, which may
have
been masked if you migrated with a custom Rakefile. This mistake was
allowed to happen due to a build-machine misconfiguration which caused a
prior development version of Rote to be tested and packaged. I'd like to
apologise for any inconvenience this may cause.

All Rote 0.3.0 users should upgrade, even if their installation has not
exhibited the aforementioned issues.

===[CUT]===

So, anyone who did download 0.3.0 and found it broken, I'm sorry for
that.
I hope you'll give it another chance :)

One more (quick) thing - I want to put out a direct plea for some
feedback. I've had some great contributions with Rote and we've put a
lot
in, but we're at the point now where we could go several ways. Rather
than
just randomly picking features (;)) to put on the todo list, I'd really
love to hear some feedback on what people want from a Rake-based
software
doc system. I have set up a user mailing list now at
rote-users@rubyforge.org.

Cheers,
Ross
This topic is locked and can not be replied to.