# Rote 0.3.0 (doc/web)

**URL:** <https://www.ruby-forum.com/t/rote-0-3-0-doc-web/50041>\
**Category:** Ruby\
**Created:** [December 12, 2005, 2:35pm UTC](https://www.ruby-forum.com/t/rote-0-3-0-doc-web/50041 "2005-12-12T14:35:40Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![ross\_b](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/8edcca/32.png) [@ross\_b](https://www.ruby-forum.com/u/ross_b)\
**Post date:** [December 12, 2005, 2:35pm UTC](https://www.ruby-forum.com/t/rote-0-3-0-doc-web/50041/1 "2005-12-12T14:35:40Z")

</div>

Hi,

Rote 0.3.0 is now available for download from  
[http://rote.rubyforge.org/](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

---

<div class="post-metadata">

**Author:** ![ross\_b](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/r/8edcca/32.png) [@ross\_b](https://www.ruby-forum.com/u/ross_b)\
**Post date:** [December 14, 2005, 9:13pm UTC](https://www.ruby-forum.com/t/rote-0-3-0-doc-web/50041/2 "2005-12-14T21:13:44Z")

</div>

(Straight to the fix:  
[http://rubyforge.org/frs/?group\_id=1120&release\_id=3802](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  
removed\_email\_address@domain.invalid.

Cheers,  
Ross