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] Very basic svn and DocBook question


The XML is what needs to be preserved in your source tree.  If some of your documentation is shipped with a product, the result files are likely to be checked into the product build tree (we check in ZIP files of the help system for most of our products along with some PDF documents).  While it is possible to build on demand, we found that building large, multilingual document sets on demand was too much of a time sync and introduced other issues that independent document builds eliminated.

In terms of tracking the production system used, we use a versioned production system (based on Ant build files and some extensive customizations of the standard DocBook transforms) and embed an HTML comment in each HTML result file that identifies the version of the transform tree used.  The transform tree is in a separate Subversion repository, so it can easily be rolled back to any specific version if questions about the production environment come up.

If you have any specific questions about this, feel free to contact me directly.

Best Regards,
Larry Rowland

-----Original Message-----
From: Karen Schneider [mailto:kgschneider@gmail.com] 
Sent: Wednesday, April 29, 2009 9:03 AM
To: docbook-apps
Subject: [docbook-apps] Very basic svn and DocBook question

As some of you have picked up I am working with a project in the
"proof of concept" stage for DocBook. We do have a small amount of
documentation developed in DocBook, and we have a dedicated directory,
and SVN for revision control. Right now we're producing plain HTML
(yeah, I know, but we're getting somewhere at least).

In terms of workflow, assuming there is one person reviewing the XML
and processing it into HTML, I'm wondering: what gets checked in? The
HTML... or the XML, and the HTML?

Also, in terms of documenting the transformation process, is there a
convention for noting in the code what XSL processor was used (and
what switches, if any)?

| 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
| Be a part of the Evergreen International Conference, May 20-22, 2009!
| http://www.lyrasis.org/evergreen

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]