This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
RE: Experiences as Authors
- From: "Ashley J.S Mills" <ug55axm at cs dot bham dot ac dot uk>
- To: Stephan Wiesner <stephan at stephan-wiesner dot de>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Fri, 29 Nov 2002 09:53:59 +0000
- Subject: RE: DOCBOOK-APPS: Experiences as Authors
- References: <000101c29775$f94a0220$0100a8c0@littleone>
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>
> >
>