On 11/03/2010 01:18 PM, Marnie McCormack wrote:
All,
Would it be possible to agree/setup an automated task on one of the various
CI instances around to build/export the master docbooks from svn ?
I'm working on Windows, and have just completed the 3 stages to create a new
user doc. Somewhat painful and now I'm stuck (I think?) at the make stage,
before I could export to the website.
What are you currently using to validate your XML?
You'll probably want to convert locally and look at the output before
publishing on the web site.
You can get a free copy of the Oxygen XML editor to do this, since
you're working on the Qpid project:
http://markmail.org/message/jphsxbfg6ilmpj2m
Or if you prefer the command line, you can install Saxon and use the
docbook stylesheets to convert to PDF and HTML. This is also free.
Seems like an automatic job to pick up any changes and export them nightly
onto the website would be a useful util.
Thoughts (aside from how much quicker wiki is!!) ?
Possibly - I'd probably set it up so that any XML that does not validate
is rejected, without generating documentation.
And I think the first step is to set things up so you can see what you
are producing locally. Once you can do that, you can check in the
results without running an automated job. And I'm not sure I want people
checking in documents they haven't looked at on their local machines
first - what do others think?
Jonathan
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]
