RE: DOCBOOK-APPS: Experiences as Authors

["Ashley J.S Mills" <ug55axm at cs dot bham dot ac dot uk>]

Here is what I do:

http://supportweb.cs.bham.ac.uk/documentation/tutorials/
docsystem/build/projdoc/projdochome.html

^ Stick this together before browsing ^

The tutorials system is ready to be put under CVS and will
be done soon.

Ashley J.S Mills



On Fri, 2002-11-29 at 07:07, Stephan Wiesner wrote:
> Hi Ian and thanks for the long reply. Sounds like a nice place to work
> :-)
> I don't use catalogs for two reasons:
> A) Despite the nice tutorial from sagehill.net, I can't make them work
> :-(
> B) I work with two monitors. Writing on one and previewing the document
> in the other, using Internet Explorer, which can transfrom documents
> very fast. Of course, I do make real transfromations from time to time,
> but I really don't want to miss the fast preview (yes I know about
> seperation of content and design, but . . .)
> 
> 
> 'make' sounds interesting. Anybody doing that with Ant? (I read the
> article from http://www.dpawson.co.uk/docbook/ant.html, but didn't
> understand it).
> 
> 
> Stephan
> 
> > -----Original Message-----
> > From: Ian Castle [mailto:ian.castle@coldcomfortfarm.net] 
> > Sent: Donnerstag, 28. November 2002 20:10
> > To: Stephan Wiesner
> > Cc: docbook-apps@lists.oasis-open.org
> > Subject: Re: DOCBOOK-APPS: Experiences as Authors
> > 
> > 
> > I have a "library" of common items - such as copyright 
> > notices and so on. Each one is an entity. The documents 
> > include the entity at the relevant point. If an entity 
> > definition changes, then it only needs to be changed in the one place.
> > 
> > Everything is in CVS. Documents tend to be modular (say one 
> > chapter per file).
> > 
> > make is used to drive the production of the document.
> > 
> > Multiple authors are able to work on documents using whatever 
> > editor they like. 
> > 
> > Common material is kept in a central place.
> > 
> > Catalogs are used to avoid the use of file system specific 
> > names. This means that people can work on the documents on 
> > different machines, remotely, and even with different 
> > operating systems.
> > 
> ...
> 
> -- 
> > Ian Castle <ian.castle@coldcomfortfarm.net>
> > 
>