Hey, DocBook is a decent format but, ultimately, has a non-zero threshold for getting started which eliminates a bunch of contributors. I wrote the gnumeric manual in docbook and it was pretty good once GNOME rewrote the whole help system to handle our manual.
In consequence of that experience though, my advice to you is: write your doc in a word processor. You know how to do it, others can figure out how to copy paste your text to where they need it, and it is the most likely strategy to both yield a nice doc and a doc that can also have a future. Export to PDF and HTML is trivial, as is cut and paste. But do whatever works for you. You can wget these svg files: http://baobab.geomatys.fr/files/geotoolsGraphics.svg http://baobab.geomatys.fr/files/GeotoolsBoxLogo.svg which are inkscape .xml files. (Clicking on the links won't do what you want it to.) The former has a colour palette defined if you want to do more tweaks. --adrian On Tue, 2008-11-25 at 12:40 -0800, Sunburned Surveyor wrote: > I've attached a sample of some very simple HTML documentation that I > am working on for my GPX2 module. I've created a color scheme based on > the current GeoTools website. I can make a template based on the > sample available for other programmers if they are interested. My > supplemental docs basically have three (3) sections: > > - Introduction/About > - Code Examples > - Opportunities for Extension/Improvement > > Is there a way to get a raster or SVG copy of the GeoTools logo that I > can include in the template? > > Please let me know if you have suggestions for improving the HTML > documentation. Remember that I wanted something simple, and something > that would look decent coming off of a printer. > > I considered Martin's suggestion about using APT, and I noticed that > Maven also supports and XML "book" format. On the OSGeo education > committe mailing list we have talked about writing a simple DocBook to > HTML converter. I'm wondering if the same thing wouldn't work for > supplemental GeoTools module documentation. We could create a DocBook > template and then write a tool that would convert this to the simple > HTML format I have whipped up, or to something similar. > > The nice thing about using DocBook as the foundation is that you can > convert it to other formats, and it is more "computer digestable" than > HTML. > > Just thinking out loud... > > Landon > ------------------------------------------------------------------------- > This SF.Net email is sponsored by the Moblin Your Move Developer's challenge > Build the coolest Linux based applications with Moblin SDK & win great prizes > Grand prize is a trip for two to an Open Source event anywhere in the world > http://moblin-contest.org/redirect.php?banner_id=100&url=/ > _______________________________________________ Geotools-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/geotools-devel ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ Geotools-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geotools-devel
