docbook-apps

Richard,
Check here: http://forgedp.fusesource.org/
It is an easy to install package that uses ant to drive the build process.
Cheers,
Eric

> On Friday, November 18, 2011, Kerry, Richard <richard.kerry@atos.net>
wrote:
>>
>> Team,
>>
>> I am setting up a Docbook system.
>> When I did so for the first time for some tests a couple of years ago I
didn't worry too much about whether everything was done using the best
tools, or in the best way.
>> This time I want to be a bit more certain I'm doing things the best way
and not missing anything. I want to produce a susyem that colleagues can
use and foresee resistence if it is more difficult than it needs to be.
>>
>> I've started out by looking at Bob Stayton's book on-line. But, I think
it is a bit out of date.
>> Can anyone direct me to any more up-to-date Getting Started guides ?
>> Or Bob, is there any chance that you might update your on-line book, in
particular the version numbers referenced for Saxon and Fop ? And the
class names to use (The section on Saxon still refers to version 6 and the
ICL version of the class-name).
>>
>>
>>
>>
>>
>> Appreciatively,
>> Richard.
>>
>>
>>
>>
>>
>>
>> Richard Kerry
>>
>> BNCS Engineer
>>
>>
>>
>> T: +44 (0)20 82259063
>>
>> M: +44 (0)7812 325518
>>
>> Room 457 Drama Building, BBC Television Centre, Wood Lane, London, W12
7RJ
>>
>> richard.kerry@atos.net
>>
>> uk.atos.net
>>
>>
>>
>>
>>
>>
>>
>> This e-mail and the documents attached are confidential and intended
solely for the addressee; it may also be privileged. If you receive this
e-mail in error, please notify the sender immediately and destroy it. As
its integrity cannot be secured on the Internet, the Atos group liability
cannot be triggered for the message content. Although the sender endeavours
to maintain a computer virus-free network, the sender does not warrant that
this transmission is virus-free and will not be liable for any damages
resulting from any virus transmitted.
>>
>>
>
> --
> Principle Technical Writer
> FuseSource
> Phone: (781) 280-4174
> E-Mail: emjohnson@fusesource.com
> Blog: http://documentingit.blogspot.com/
> Twitter: finnmccumial
>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Richard,
When using the DocBook xsls from sourceforge (docbook-xsl or
docbook-ns-xsl), Saxon 6 is the correct version. These xsls were
implemented as 1.0 xsls and contain features that do not work in the
xsl 2.0 version of Saxon.

For the DocBook 2.0 xsls, see:

http://norman.walsh.name/2011/08/25/docbook-xslt-2

If you're starting from scratch today, the idea of starting with the
DocBook 2.0 xsls is very appealing, but keep in mind that you would be
among the first to do so. If you goal is stable, tried-and-true xsls,
then the 1.0 distribution is probably what you want.

Regarding the build system, in addition to the Fuse system mentioned
in this thread, if you're familiar with Maven, you might look at Docbkx:

https://code.google.com/p/docbkx-tools/
http://blog.kasunbg.org/2010/12/how-to-use-docbkx-tools-as-maven.html

Finally, if commercial tools are an option, the XML editors oXygen and
XMLMind both come with build-in support for DocBook.

David

On 11/18/2011 08:03 PM, Eric Johnson wrote:
> Richard, Check here: http://forgedp.fusesource.org/ It is an easy
> to install package that uses ant to drive the build process.
> Cheers, Eric
>
>> On Friday, November 18, 2011, Kerry, Richard
>> <richard.kerry@atos.net
> <mailto:richard.kerry@atos.net>> wrote:
>>>
>>> Team,
>>>
>>> I am setting up a Docbook system. When I did so for the first
>>> time for some tests a couple of years ago
> I didn't worry too much about whether everything was done using the
> best tools, or in the best way.
>>> This time I want to be a bit more certain I'm doing things the
>>> best
> way and not missing anything. I want to produce a susyem that
> colleagues can use and foresee resistence if it is more difficult
> than it needs to be.
>>>
>>> I've started out by looking at Bob Stayton's book on-line.
>>> But, I
> think it is a bit out of date.
>>> Can anyone direct me to any more up-to-date Getting Started
>>> guides ? Or Bob, is there any chance that you might update your
>>> on-line book,
> in particular the version numbers referenced for Saxon and Fop ?
> And the class names to use (The section on Saxon still refers to
> version 6 and the ICL version of the class-name).
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEbBAEBAgAGBQJOxzxVAAoJEMHeSXG7afUh1eQH90TzH8r/TCtBJPkYrepe8Py3
4Z/4z4jjvxTFhpmOH1cShkCBEydDUBWJZOPolvQOCTb8WSKDfeWiibUb+67X374W
quq/t8F6ZPIaPCcAUoo8MmjoRJr3oT5ylKQZEI6N2pOJjvn8+9LHI3o3KHeHDNPp
A1gzfa+cOaY2E3dX/YpdjvI8fmDCwM9EcFk4Q5Il9mZZAur6tn3ckhY1cJkFfFuU
ObQjMyUxmk6q8ULNrgzjQSR3bf+RxXNjHg+VzL7DfY3U2CEZXA3NtMlsw25W0f6s
rlJIe/TtZuETkHltxdq8cvmFOxkdtQp2en5hQIjznGXtOzJw+WNQxWUi8slQ7g==
=TByz
-----END PGP SIGNATURE-----

Hello Richard,

David Cramer is write in mentioning user-friendly editors.
Templates/examples for typical documents might help, too.

Few complaints from part-time or novice authors concern the build system.
Instead, they get lost in markup choices or putting a document together
from scratch.

Regards,
Mark

On Sat, Nov 19, 2011 at 3:03 AM, Eric Johnson <ericjohnson@apache.org>wrote:

> Richard,
> Check here: http://forgedp.fusesource.org/
> It is an easy to install package that uses ant to drive the build process.
> Cheers,
> Eric
>
> > On Friday, November 18, 2011, Kerry, Richard <richard.kerry@atos.net>
> wrote:
> >>
> >> Team,
> >>
> >> I am setting up a Docbook system.
> >> When I did so for the first time for some tests a couple of years ago I
> didn't worry too much about whether everything was done using the best
> tools, or in the best way.
> >> This time I want to be a bit more certain I'm doing things the best way
> and not missing anything. I want to produce a susyem that colleagues can
> use and foresee resistence if it is more difficult than it needs to be.
> >>
> >> I've started out by looking at Bob Stayton's book on-line. But, I
> think it is a bit out of date.
> >> Can anyone direct me to any more up-to-date Getting Started guides ?
> >> Or Bob, is there any chance that you might update your on-line book, in
> particular the version numbers referenced for Saxon and Fop ? And the
> class names to use (The section on Saxon still refers to version 6 and the
> ICL version of the class-name).
> >>
> >>
> >>
> >>
> >>
> >> Appreciatively,
> >> Richard.
> >>
> >>
> >>
> >>
> >>
> >>
> >> Richard Kerry
> >>
> >> BNCS Engineer
> >>
> >>
> >>
> >> T: +44 (0)20 82259063
> >>
> >> M: +44 (0)7812 325518
> >>
> >> Room 457 Drama Building, BBC Television Centre, Wood Lane, London, W12
> 7RJ
> >>
> >> richard.kerry@atos.net
> >>
> >> uk.atos.net
> >>
> >>
> >>
> >>
> >>
> >>
> >>
> >> This e-mail and the documents attached are confidential and intended
> solely for the addressee; it may also be privileged. If you receive this
> e-mail in error, please notify the sender immediately and destroy it. As
> its integrity cannot be secured on the Internet, the Atos group liability
> cannot be triggered for the message content. Although the sender endeavours
> to maintain a computer virus-free network, the sender does not warrant that
> this transmission is virus-free and will not be liable for any damages
> resulting from any virus transmitted.
> >>
> >>
> >
> > --
> > Principle Technical Writer
> > FuseSource
> > Phone: (781) 280-4174
> > E-Mail: emjohnson@fusesource.com
> > Blog: http://documentingit.blogspot.com/
> > Twitter: finnmccumial
> >