At the moment tools/validate.py exits after it found an
invalid file.
I think it's better to always validate all files and to
exit then if any invalid file was found. This way the
creator of a review request can fix all found issues in
all files and has not to create several patch sets.
Change-Id: Ic5668f0791680802b8cef3b5e1016c9dc76479b9
Modifies tools/validate.py to run "mvn clean generate-sources"
in every directory that has a pom.xml file.
The script will fail with an error if any of the books fail to build.
It will terminate on the first failure.
Fixes bug 1031374
For now, we aren't gating on openstack-training
Change-Id: Ic0136e4245e8e4bfa2e790574e3ec82c944c4b02
In tools/validate.py, check for xml:id attributes.
While testing this, found a file that contained missing xml:id, that
was corrected.
See bug #1181659
Change-Id: I61f61c5f6de87bee8c7bc2eb9e3bfe23426a3adb
This patch added tools used for slicing and merging in translation process.
The patch also includes the POT files for each documents.
The PO files are not included, which can be downloaded from Transifex.
Fixes: bug #1153415
Change-Id: Ia455134c99acb1129e8f10deda0d85867b1ef9a3
With this patch, running the tools/validate.py script will return
no DocBook RelaxNG schema validation failures.
Once this patch lands, and the equivalent lands in stable/folsom,
I will follow up on getting this run automatically by Jenkins so
we can see the results when there are new doc patch proposals.
There were three XML validation failures that were addressed
openstack-compute-admin/rootwrap.xml:
rootwrap.xml had to xml:id values that were the same. These have
been changed so they are different. It turns out this file was not
being included in the documentation at all. I submitted a separate
patch to include it: https://review.openstack.org/20551
openstack-compute-admin/computeconfigure.xml:
computeconfigure.xml had xi:include elements with an 'os' attribute.
This violates the spec, and it doesn't work, either. We had two
lines that looked like this:
<xi:include os="ubuntu" ...>
<xi:include os="rhel;fedora;centos" ...>
and both files were being included in the docs. This was changed so
that only one file is included, and there's a note that has been
added that describes the difference between the two files, which
is very minor (just one parameter).
openstack-ha/ha-guide-docinfo.xml:
This isn't a real XML file, it's a fragment of XML that is used
by a non-standard toolchain. The validation script has been configured
to just ignore it for now.
Change-Id: Ie77218efc56c16b7bf162f5e02fd7a6d99116dc1
Adds a script called tools/validate.py that will check all XML
files against the DocBook 5 RELAX NG schema.
Does not check pom.xml files or files inside of directories named
"target".
Change-Id: I9614f1b10ac2da608a245c7644309a5be38c8995