# \[ANN\] Gerbil 3.1.0

**URL:** <https://www.ruby-forum.com/t/ann-gerbil-3-1-0/141163>\
**Category:** Ruby\
**Created:** [June 23, 2008, 2:28am UTC](https://www.ruby-forum.com/t/ann-gerbil-3-1-0/141163 "2008-06-23T02:28:16Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![snk](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/s/d9b06d/32.png) [@snk](https://www.ruby-forum.com/u/snk)\
**Post date:** [June 23, 2008, 2:28am UTC](https://www.ruby-forum.com/t/ann-gerbil-3-1-0/141163/1 "2008-06-23T02:28:16Z")

</div>

Gerbil is an extensible document generator based on eRuby  
that outputs to any format you want: plain text, HTML,  
LaTeX, UNIX man page, your own custom format, and so on.

```
           http://gerbil.rubyforge.org

```

###########################################################

Gerbil 3.1.0

This release improves the HTML format by reducing the  
output file size, improving on-line usability and document  
printability (please try the â€œprint previewâ€ function in  
your browser; the output is simply beautiful!), and  
repairing some defects.

1 Improvements

â€¢ The file size of the HTML formatâ€™s output has been  
significantly reduced by reusing the data for embedded  
admonition icons through CSS. So use admonitions  
generously; they will not bloat the output file size!

1.1 Usability

1 Please see the ./doc/guide.html file in your Web browser.  
â€¢ All headings are now hyperlinks to themselves. This  
allows readers to obtain a â€œpermanent linkâ€ to any  
section in your HTML document.

â€¢ A meta navigation menu is now emitted at the top of the  
HTML document. This menu contains hyperlinks to the  
various structural elements of a document, such as the  
abstract, table of contents, list of figures, and  
references.

â€¢ The color of visited hyperlinks has been darkened to  
improve readability.

â€¢ The style of blockquote now provides better focus on  
its content.

â€¢ Cross-reference (xref) hyperlinks now have a  
mouse-hover title when you override the default link  
text.

1.2 Printing

â€¢ Page breaks are now inserted before major sections in  
the document. This allows for easier printing (you can  
print a subset of pages without fear of discontinuity)  
and improves readability through better organization.

â€¢ In browsers that support CSS3 pseudo-class selectors,  
cross-reference hyperlinks now show the name and index  
of their destination node.

â€¢ Internal hyperlinks (which point to internal URI  
fragments) that are not cross-references are now shown  
as normal text to reduce distraction.

2 Repairs

â€¢ Cross-reference (xref) hyperlinks to paragraphs were  
broken due to a missing id attribute.

â€¢ Removed useless CSS styles and fixed some XHTML  
validation issues.
