erbook : write books and documents in eRuby
erbook is an extensible document processor that emits XHTML
(web page), LaTeX (PDF), man (UNIX manual page), plain text,
and any document format you can imagine from eRuby templates
that allow scripting and dynamic content generation.
erbook is a light (210 source lines of code), extensible
(create your own document formats), and flexible (your content
is scriptable) alternative to DocBook, Deplate, and SiSU.
Visit http://snk.tuxfamily.org/lib/erbook/ for more information.
* * * RELEASE NOTES * * *
â€¢ 1 Caution
â€¢ 2 Improvements
â€¢ 3 Repairs
This release renames the â€œhtmlâ€ format to â€œxhtmlâ€, moves
previously global stuff into the ERBook namespace, improves
error reporting and usability, reduces the file size of
XHTML output, and fixes some bugs.
â€¢ Renamed the â€œhtmlâ€ format to â€œxhtmlâ€ (and all similarly
named methods and files) in order to support custom DTD
extensions which reduce the overall file size of the
output. See this note in the user manual for the
consequences of this change.
â€¢ Removed the $use_icons parameter from the XHTML format.
Now, icons are always used, whether you like it or not!
â€¢ Replaced the implicit ERB::Util#h method with a
verbatim() method in the XHTML format.
â€¢ The Trollop library (used for command-line options
parsing) is now required to run erbook. See the â€œSetupâ€
section in the user manual for details.
â€¢ Added support for single-line eRuby directives (lines
which begin with â€œ%â€), both in general and in the
–unindent option. See this section of the user manual
â€¢ Enhanced stack traces with information about the input
file and also <%#include#%>-ed files. This was done at
the cost of increasing the number of source lines of
code to more than 200 (it is 207 right now). Oh well,
â€¢ Omitted erbook internals from stack traces (unless in
$DEBUG mode). This helps users concentrate on problems
in their input document.
â€¢ Used colors for hyperlinks and suffix icon for external
hyperlinks from the MediaWiki software, which powers
the famous Wikipedia.
â€¢ Could not jump to examples and admonitions from the
list of figures.
â€¢ Reorganized icons for the XHTML format to better
reflect their origin (the directory layout of the
source code of the open-source projects they came from)
so that others can easily find them in their original
â€¢ Added API documentation for all methods listed in the
user manual, while also omitting many irrelevant
methods from the list.