Jason van Zyl-2 wrote:
>
> 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.
>
So the book was in apt at some stage. Were you able actually get things like
images, table of contents, cross linking, nice html as well as pdf and
others going? I have my doubts that the current doxia tool chain can
actually do that - or I am just too dumb. I have external code nicely
executed with the sql plugin as well as included in the documentaiton with
the snippet macro and I produce html and pdf. But I cant get images to work
and the html is one big file.
If I could get images in pdf and a nice html working I would be set.
I would rather not convert to docbook but if I have to I just might. Is
there something like the snippet macro I could use in docbook? How painful
is the learning curve for docbook?
In any case it would be great to see the setup of the book source so I could
replicate folder structure and other things without too much hazzle. At
first glance the docbkx maven plugin doesnt exactly overflow with
documentation either. I also seen the jboss maven-jdocbook-plugin used e.g.
in the richfaces source and then there is the maven-docbook-plugin.
Looks like there is too much overlap and I am really not sure which one to
choose, Given that the definitive guide looks like what I need provided you
are using some sort of snippet/include setup for the code bits I would
probably go with the one you suggest...
--
View this message in context:
http://www.nabble.com/Definitive-Guide---is-it-real--tp16656704s177p16670484.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]
