OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [docbook-apps] Creating a DocBook glossary in a distributed documentation production environment


For a simple distributed DocBook production environment, I'd
suggest a Subversion repository that all authors use for their
individual parts, as well as shared parts (like the glossary).

I'd use a glossary database (Chapter 17 of Bob's book) that is
writable by any author. Authors can populate it with whatever
terms they like, using a simple rule for id disambiguation (I
use gloss.term, where gloss is constant and term is the term
itself. If you need to disambiguate two forms of the same term,
you can add something at the end.)

If two authors need to use the same term, they will need to
discuss whether they can create one entry for both uses, or
if they need separate entries, but beyond that, there's not
much need for coordination.

The build process described in Bob's book buildsa glossary for
each document based on the terms used in that document. Simple
and automated.

Hope that helps.
Dick Hamilton
XML Press
XML for Technical Communicators
(970) 231-3624 

> -----Original Message-----
> From: Karen Schneider [mailto:kgschneider@gmail.com] 
> Sent: Monday, September 07, 2009 12:11 PM
> To: docbook-apps
> Subject: [docbook-apps] Creating a DocBook glossary in a 
> distributed documentation production environment
> This is half a DocBook question and half a "process" question for
> anyone on this list working in a distributed DocBook production
> environment where for a particular assembled document you are
> generating at least one common glossary. (In this case, the assembled
> document is planned as a set with two books, multiple chapters within
> each book, and sections within each chapter.) Authors will be working
> on chapters and sections independently of one another.
> I am trying to figure out the logistics of having authors generate
> glossterms/glossentries that are unique and consistently-formed and
> contribute to a common glossary. It may well be that this isn't
> possible, or that it is best done as a sort of kludge, where they mark
> up glossterms and then submit the full glossary entries in a separate
> document, for editors to manually integrate this content into a main
> glossary after human review. Either that, or authors ignore glossary
> creation altogether and the next tier of editors is responsible for
> glossary creation.
> I have read through the instructions for glossary databases in
> Stayton's guide, thought about manual vs. automated creation, etc. but
> am still stuck at the "process" level of all this.
> -- 
> -- 
> | Karen G. Schneider
> | Community Librarian
> | Equinox Software Inc. "The Evergreen Experts"
> | Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
> | kgs@esilibrary.com
> | Web: http://www.esilibrary.com
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: 
> docbook-apps-help@lists.oasis-open.org

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]