[Openstack-docs] Can't build compute admin guide

David Cramer david.cramer at rackspace.com
Thu Apr 11 23:01:34 UTC 2013


On 04/11/2013 03:55 PM, Lorin Hochstein wrote:
> I can't build the compute admin guide
> (https://bugs.launchpad.net/openstack-manuals/+bug/1168149). It might
> just be my setup, but I noticed that Joe's recent "boot from volume"
> changes (merged three days ago) aren't reflected on the website: 
> 
> https://review.openstack.org/25947
> 
> http://docs.openstack.org/trunk/openstack-compute/admin/content/boot-from-volume.html

Hi Lorin,
I just did a pull and that doc builds off of master for me. In your
target directory you'll find a file named something like:

bk-compute-adminguide.xml-invalid-2013-04-11T17:57:48.071-05:00.xml

Please send me that file. Alternatively, you can open that file in
Oxygen and validate it. You'll see where the problem is and you can fix
it in the real source file.

That file is the intermediate version of the doc that was validated.
There can be cases where due to profiling, the doc that was valid in the
editor is no longer valid 1/2 through processing.

Btw., an improvement coming when I cut the next release of the plugin is
validation error messages will look like this:

@@@@@@@@@@@@@@@@@@@@@@
!!!VALIDATION ERRORS!!
!!!!!!!!!!!!!!!!!!!!!!

Note: Open the temporary file:

file:////home/dcramer/Documents/openstack/openstack-manuals-new/doc/src/docbkx/openstack-compute-admin/target/bk-compute-adminguide.xml-invalid-2013-04-11T17:57:48.071-05:00.xml

to see all the errors in context.
You must correct the errors in the original
source DocBook or wadl files however.

You can control whether build fails or not by
setting failOnValidationError to no in your pom.

lineNumber:  20411; columnNumber: 10; element "para" not allowed yet;
expected element "info", "subtitle", "title" or "titleabbrev"

!!!!!!!!!!!!!!!!!!!!!!
!!!VALIDATION ERRORS!!
@@@@@@@@@@@@@@@@@@@@@@

Thanks,
David




More information about the Openstack-docs mailing list