Adrian, Thanks for the logo links. I use Inkscape, so that will work great.
Thanks also for your thoughts on Docbook. I understand there is a steep learning curve to the format. Perhaps I will stick with HTML for the time being, but I'll think about using a word processor as well. Landon On Fri, Nov 28, 2008 at 10:08 AM, Adrian Custer <[EMAIL PROTECTED]> wrote: > 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
