Just a note on XMLMind. I have been using this tool for generating my
finished output, but I do not like using it as an editor because of its
nasty habit of reformatting the white space, screwing up the version
control.
I have had good results using Eclipse and working around the limitations
mentioned in the "Authoring With Eclipse" article, but if you want
WYSIWYG, how about using Open Office?
http://xml.openoffice.org/xmerge/docbook/
I have not tried it yet but it looks promising.
Also, I agree with those who suggest adding both the source docbook
files and the generated output to version control. One of the reasons
it is beneficial to have a build process is because of the hierarchical
nature of JAVA. Changes in one package can affect the compilation of
another package. With docbook, this is not a concern.
[EMAIL PROTECTED] wrote:
Date: Thu, 17 Aug 2006 13:07:52 +0200
From: Andrea Aime <[EMAIL PROTECTED]>
Subject: Re: [Geotools-devel] Docbook tool support
To: Adrian Custer <[EMAIL PROTECTED]>
Cc: Jody Garnett <[EMAIL PROTECTED]>, Paul Ramsey
<[EMAIL PROTECTED]>, geotools-devel
<[email protected]>
Message-ID: <[EMAIL PROTECTED]>
Content-Type: text/plain; charset=ISO-8859-15; format=flowed
Adrian Custer ha scritto:
Hey Andrea, all,
Andrea, as you are right to say automating the build may be difficult.
However, I don't really see the point. It's easy enough to have a PDF in
subversion and have the authors regenerate that from Docbook
periodically. Same for html. If you are editing docbook, you have a
production chain since you want to see your output. Easy enough to
commit your changes, create a PDF, commit the PDF. I'm not going to
worry about maven doing docbook. Either someone will create a Maven2
plugin that 'just works' or I can do it by hand. I've got enough on my
plate worrying about the words to not worry about the automated magic.
Well, I guess either the docs are and stay editable with XMLMind, or
you're going the road of the lone fighter (and you won't like like
in the long run...).
Speaking for myself, I'm not going to work on docs if the cannot be
edited with a more or less assisted (wysiwyg would be better) and
cross platform tool, and have at least one way to generate the output
and see how it looks for good from time to time.
As for beautiful pdf, there is a way of converting docbook to latex and
then latex to pdf that should generate top notch output but I fear it'll
work on linux only.
Cheers
Andrea
begin:vcard
fn:Jeff Yutzler
n:Yutzler;Jeff
org:IONIC Enterprise, Inc.
adr;dom:Suite 300;;901 N. Pitt St.;Alexandria;VA;22314
email;internet:[EMAIL PROTECTED]
title:Senior Geospatial Systems Engineer
tel;work:(703) 535-5973
tel;cell:(703) 981-8753
x-mozilla-html:TRUE
version:2.1
end:vcard
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel
