[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.
--
Posted via http://www.ruby-forum.com/\.