<html><head> | |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | |
<title>5. Acknowledgements</title><link rel="stylesheet" href="css/stylesheet.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.70.0"><link rel="start" href="index.html" title="DocBook Framework (DBF)"><link rel="up" href="index.html" title="DocBook Framework (DBF)"><link rel="prev" href="ch04s08.html" title="4.8 Titlepages"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">5. Acknowledgements</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch04s08.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="section-acknowledgements"></a>5. Acknowledgements</h2></div></div></div><p>DocBook is a fairly complex format and using and customizing the XSL | |
style sheets available is not really straightforward. So by googling left | |
and right and looking at other DocBook rendering frameworks that are in | |
the open source, we tried to model similarities and sometimes just copied | |
some of the ideas.</p><p>This DocBook Framework is literally standing on the shoulders of | |
other projects, in particular:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>The DocBook Format</em></span> by Norman Walsh; (C) | |
1999-2006 by Norman Walsh, OASIS and O'Reilly, especially all the | |
documentation that is available from | |
<code class="uri">http://www.docbook.org/</code></p></li><li><p><span class="emphasis"><em>The DocBook FAQ</em></span> maintained by Dave Pawson | |
and available from <code class="uri">http://www.dpawson.co.uk/docbook/</code>. We | |
wouldn't have survived without it.</p></li><li><p><span class="emphasis"><em>DocBook XSL: The Complete Guide</em></span> by Bob | |
Stayton. This is an invaluable reference to the DocBook style sheets. | |
Find it online at <code class="uri">http://sagehill.net/</code> or buy the | |
E-book.</p></li><li><p><span class="emphasis"><em>The DocBook Project</em></span> located at | |
<code class="uri">http://docbook.sourceforge.net/</code>. They maintain the XSL | |
style sheets used to transform DocBook into other formats and also | |
link to the docbook mailing list archives.</p></li><li><p><span class="emphasis"><em>The Apache XML commons resolver</em></span> available | |
from | |
<code class="uri">http://xml.apache.org/commons/components/resolver/</code></p></li><li><p><span class="emphasis"><em>The XMLmind XML Editor</em></span> from XMLMind, | |
available through <code class="uri">http://www.xmlmind.com/xmleditor/</code> This | |
cross-platform, pure Java editor not only runs well on Linux, Windows | |
and MacOS but also offers DocBook WYSIWYG support and has a free | |
version! And if you pay for it, you get the source code for it | |
too.</p></li></ul></div><p>Ideas on how to render elements, to arrange things and how to do | |
more obscure things like title pages or use CSS to render HTML, we've | |
taken (sometimes literally by cut and paste) from the following | |
projects:</p><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>The Spring Framework documentation</em></span>. It | |
hooked us on the idea that Velocity should have DocBook documentation, | |
too. Their DocBook framework is really nice, however it proved to be | |
'not exactly what we were looking for' (see above). Spring is an | |
example on how good documentation makes all the difference between a | |
successful and popular project and 'the others'. Thanks a lot, Spring | |
guys! Download Spring Framework from | |
<code class="uri">http://www.springframework.org/</code>.</p></li><li><p><span class="emphasis"><em>The "ant and docbook" styler suite</em></span> by Dawid | |
Weiss, available from | |
<code class="uri">http://www.cs.put.poznan.pl/dweiss/xml/projects/ant-docbook-styler/index.xml</code> | |
. We stole his CSS style sheet almost verbatim. Thanks a lot, | |
Dawid!</p></li><li><p><span class="emphasis"><em>The Maven sdocbook plugin</em></span> by Siegfried | |
Goeschl, Per Olesen and Carlos Sanchez, available at the SourceForge | |
Maven plugin page at | |
<code class="uri">http://maven-plugins.sourceforge.net/maven-sdocbook-plugin/</code></p></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch04s08.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">4.8 Titlepages </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html> |