Hi,
The content of the book has been converted to docbook as that's what
O'Reilly can consume more easily. The editing tools that Tim prefers
are docbook tools so he converted the source from APT to docbook. But
you could use Doxia to go from whatever to docbook and then use the
tools we have. We are using docbook and the docbkx-maven-plugin. I
don't have any problem letting people use the tools. The book is a
community service, we don't make money off it or use it as a marketing
tool (we, in fact forfeit our royalties to give it away for free and
you don't have to register so we don't track anyone for leads) so let
Tim sort out what's what and we'll publish what we have.
You could theoretically write the book in whatever you want but you'll
need a docbook sink that's accurate. Once you have that then you
should be able to do the same things we are. Or just write the content
in docbook. There are some limitations in doxia right now and Tim is a
sadist and prefers docbook so that's what we have.
On 12-Apr-08, at 9:02 PM, Manfred Moser wrote:
Hi!
I really appreciate the great guide Jason and gang have put together
with
Maven: The Definitive Guide, which you can all get here as you
probably know
http://sonatype.com/book/index.html
As far as I believe somehow these guys are making the book with
Maven. At
least I hope so. I have started to write some documentation using
the doxia
book plugin and have run into all sorts of issues. I am able to
create the
book in various formats including pdf and html as well as embedding
external
code snippets (SQL in my case).
However I have not managed to get a nice table of content and
multiple html
pages happeing as nicely has Sonatype has on the site. And I
definitely have
not managed to get any images embedded. There are all sorts of
issues in
JIRA and on the wiki as various documentation on the site and in the
forums.
So far to no avail though.
So here are my questions:
Can something like the Definitive Guide be done with the doxia maven
plugin
or should I start looking elsewhere asap?
If so how? Ideally there would be an example available that does the
various
formats, uses all the macros, get sthe book on the site (generated
with mvn
site) as well as generated downloadable artifacts (I am using the
assembly
plugin just fine for that) and uses images and whatever else can be
done
with doxia. I have however not found something like it.
If the book source code would be available I could just look at it
is done
there but I have not found anything on the web? Otherwise does any
open
source project use it like I mentioned so that I could download that
source
code and check it out. Or maybe there is some snapshot or whatever
website
from doxia that contains working examples?
Any help would be greatly appreciated.
manfred
--
View this message in context:
http://www.nabble.com/Definitive-Guide---is-it-real--tp16656704s177p16656704.html
Sent from the Maven - Users mailing list archive at Nabble.com.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder, Apache Maven
jason at sonatype dot com
----------------------------------------------------------
We know what we are, but know not what we may be.
-- Shakespeare
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
