ERBook 7.0.0 Extensible document processor based on eRuby http://snk.tuxfamily.org/lib/erbook/
ERBook is an extensible document processor that emits any
document you can imagine from eRuby templates that allow
scripting and dynamic content generation.
A working XHTML (web page) format is provided, while
LaTeX (PDF), UNIX manual page, and plain text
formats are planned… patches are welcome!
ERBook is exciting because:
* Its documents are scriptable eRuby templates. * It lets you define your own document formats. * Its core contains less than 300 lines of code.
These features distinguish ERBook from the competition, which
offers neither scriptable documents nor definable document
* DocBook * Deplate * SiSU * AsciiDoc * txt2tags * Grutatxt
* Release notes -- history of project releases. * Source code -- obtain via Git or browse online. * API reference -- documentation for source code. * Project home -- the ERBook project home page.
To get help or provide feedback, simply contact the
ERBook releases are numbered in major.minor.patch form
according to the RubyGems rational versioning policy,
which can be summarized thus:
What increased in the version number? The increase indicates
that the release:
Is backward compatible? Has new features? Has bug fixes?
major No Yes Yes
minor Yes Yes Yes
patch Yes No Yes
Version 7.0.0 (2009-05-03)
This release improves the appearance, usability, and validity
of XHTML (web page) output, upgrades to a new eRuby
templating system, adds new processing options to node
definitions, and fixes some bugs.
* If you add methods to the ERBook::Template class, in order to provide them to eRuby templates, you must now add those methods to the ERBook::Template::Sandbox class instead. * The Ember template processor is now used to render eRuby templates instead of the ERB library that is shipped with Ruby. + The file inclusion directive has been removed:
<%# include YOUR_FILE #%>
Ember provides equivalent functionality:
* The erbook/to_xhtml library now annotates <code> elements with a "line" or "para" class indicating whether they span a single or mulitple lines respectively. The "pre.code" CSS class is no longer emitted. * The erbook/rdoc library has been updated to work with RDoc 2.4.3. It no longer supports the old RDoc that is shipped with Ruby 1.8. * Just a reminder from the Version 5.0.0 (2008-11-22) release notes: Internet Explorer 6 and 7 do not support the application/xhtml+xml mime type, so the output generated by the XHTML (web page) format cannot be viewed in those browsers.
* Replace dark background theme with a "wide open spaces" theme. + Use icons instead of unicode glyphs for mini navigation menus. + Put mini navigation menus on right-hand side of headings + Use scrolling animation when local links (URI fragments) are visited, instead of instantly teleporting to the destination. This gives a sense of spatial existence to the web page, making it feel almost tangible! * XHTML output is now valid XHTML 1.0 Transitional! And the embedded CSS it contains is now valid CSS 3! + Minify CSS in XHTML output using the Rainpress library. + Add CSS style for HTML definition lists. * Omit target type and index ("Section X.Y.Z") in output of xref() nodes in the screen-version (CSS stylesheet) of the generated output document. This information is still present in the print-version (CSS stylesheet) of the generated output document, where it is truly helpful to the reader. * Add "bypass" option to node definitions to properly support the generic "node" node. Invalid XHTML was being generated because the `node' node was marked as simply "inline", so it was not pulled out of the <p> tag created by Maruku.
* The "silent" property in node definitions was not being honored. * Fix error when inserting reference nodes (they are not inline!). * Add workaround for Maruku treating first line of input as parameter definition, and thereby omitting it from the output! * Array#to_s is equivalent to Array#inspect in Ruby 1.9. * HelloWorld format specification file added methods to the nonexistent ERBook::Node class instead of adding them to the ERBook::Document::Node class.
* Simplify language phrases used in mini navigation menus. * Remove CSS hacks for supporting IE6; it cannot render XHTML anyway. * Render italics and boldface equally in serif font. Bold is truly bold now and italic is distinctive. * Adjust spacing between document title, author, and date headings. * Add copyright notice at the top of every file.