DocBooksInfrastructure

Introduction

How to generate grid school tutorials using DocBooks.

Recipe for fetching and modifying source

• You must have rights to commit in the osgedu svn on the CI machines.

• Login to login.ci.uchicago.edu and cd to a work area in your /home directory.

• Checkout the tree of OSG grid school packages:

  svn co https://svn.ci.uchicago.edu/svn/osgedu

• Go to the directory where the new workshop (newworkshop) will be created:

  cd osgedu/schools/2009

• Copy a workshop:

  svn cp oldworkshop newworkshop

  (in this case oldworkshop was in the 2009 directory)

• Commit the change

  svn ci -m 'cloned oldworkshop to newworkshop'

• Make changes as desired to the .xml files using an XML editor to your liking.

• Then commit all these changes back to svn:

  svn ci -m 'modifications for newworkshop'

Upload changes

Then, in order to make this page http://www.ci.uchicago.edu/osgedu/schools/2009/newworkshop/ visible, you need to generate it from the SVN docbook material. So

• log in to login.ci.uchicago.edu

• edit /ci/www/projects/osgedu/update.sh to add a line for the school you just created. (following pattern)

Then

• run ./update.sh in that directory

• The http://www.ci.uchicago.edu/osgedu/schools/2009/newworkshop/ will now be visible.

References

• The docbook book: http://docbook.org/tdg/en/html/docbook.html and this reference to the mechanics of the xsl: DocBook XSL: The Complete Guide: http://www.sagehill.net/docbookxsl/index.html
• Also the O'Reilly stylesheet guide: http://oreilly.com/oreilly/author/stylesheet.html
• http://subversion.tigris.org/
• SVN tutorial

-- RobGardner - 09 Oct 2009