[ANN] Gerbil 3.1.0

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.