What is DobuDish?
DobuDish is a Docbook publishing framework. It was designed with portability and extensibility in mind. DobuDish can run on any Windows or Unix platform that supports Java.
DobuDish was developed during a project for T-Systems Germany. T-Systems generously agreed to open source the newly developed parts of DobuDish (Ant script and Docbook customization layer) for which we are very grateful.
We have agreed to host DobuDish here on our website as a free product we want to give back to the DocBook community. The DobuDish framework is distributed under the GNU General Public License. The various parts of the DobuDish framework are distributed under their respective (free) licenses.
A discussion forum for DobuDish can be found here.
If you found a bug please report it through our cool bug tracker.
Feel free to contact us for any enhancements you would like to see or any bugs you find.
- 0.9.1 (24.11.2006): added a User Manual, changed Encoding to UTF-8
- 0.9.2 (26.11.2006): removed The Docbook Complete Guide from the distribution. LOC’s are now rendered in one column.
- 0.9.3 (28.11.2006): fixed problems that occured when installing Dopus on a path with spaces. Currently only fixed for Windows, a Unix patch will follow.
- 0.9.4 (01.12.2006): fixed generator.sh- if JAVA_HOME is not set it will try to find java in the PATH with “which java”. Tested on Windows XP, Vista, Intel MacOS X, SuSE Linux
- 0.9.5 (01.12.2006): fixed stupid bug in generator.sh. Sorry about that. You should update if you use MacOS or Unix.
- 0.9.6 (06.12.2006): proxy support for FOP and Saxon, bugs fixed in Javahelp support, Support for multiple DTD’s
- 0.9.7 (21.12.2006): Substitution of properties in docbook documents, multiple documents in one document directory, customization for line breaks, enhanced manual
- 0.9.8 (11.01.2007): Using Velocity preprocessor for variable substitution, timestamp support in Ant (timestamp can be used in Docbook documents: $ant.get(“TODAY”), new titlespec for HtmlHelp documents.
- 0.9.9 (22.03.2007): This version includes support for Docbook Slides. Please see the releasenotes.html for details; and please give me feedback and help enhance this feature! This version does set the executable flag of generator.sh properly (packaged on a Mac), so there is no need anymore to chmod the script. Enjoy!
- 0.9.10 (28.04.2007): Contains a bug fix for the wordml generation. Thank, Etienne!
- 0.9.11 (19.06.2007): Added the document type “set”
- 0.9.12 (10.07.2007): Bugfixes, added new target hooks so you can customize the build process better, added all available target hooks to the manual
- 0.9.13 (16.08.2007): There was a problem with the included fonts- documents created with them where not searchable. Removed a small glitch in resolve-xinclude.xsl
- 0.9.14 (15.02.2008): Support for Website creation. The new targets “ws-tab” for the creation of tabular website and “website” for non tabular websites. If you now create a directory “copy_to_output” it’s content will entirely and recursively be copied to the output directory.
You can now have a folder “common-files” in the “custom-cfg” folder of your document. If that one exists, common files will be taken from there instead from the global “custom-xsl” directory.
Cleaned up a bug in the generator script that appeared on Linux.
No more warnings when a specific style.css is not available
- 0.9.15 (02.04.2008): There is a new property in localbuild.properties which determines the type of the document. The templates have been adapted but you have to adapt your existing documents yourself. To do that please insert into localbuild.properties:document.type = <doctype>where <doctype> is one of book, article, set, slides, webpage.
The old way is still supported but deprecated.
Cleaned up some glitches with the website document type.
- 0.9.16 (01.05.2008): Fixed bug with the new document.type mechanism. There was an oversight for documents that contain sub documents of a different document type than the main document. In localbuild.properties you can now add additional entries of the form document.<file name>.type=article|book|…
Now when you process your sub document and an entry for this document is found it overwrites the document.type setting.
This also is possible for the master document. So you might set document.type to the default document type and overwrite only those that differ from that one.
- 1.1.0 (29.07.2008): I have added new global-[pre/post] targets to DobuDish as well as an initially empty file “system/etc/build-user-augments.xml” which is supposed to hold user defined actions for the global targets. The logic is as follow:
- first try to execute a local target
- if that does not exist, try to execute the corresponding global target. That way you can overwrite global actions with local ones. Please note if a local action is found, the corresponding global action is not executed- unless you explicitely call it inside the local action.
- 1.1.1 (01.08.2008): I fixed some small bugs with the new global hooks and also updated the DobuDish manual.