[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [docbook-apps] Very basic svn and DocBook question
Karen, 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]