Marty, These errors are caused by files being included in the docs twice as well as links pointing to destinations that aren't included in the same book. I have a page on this in the project wiki.
https://cwiki.apache.org/confluence/display/CLOUDSTACK/Publican+Troubleshooting+Guide In the end, the root cause is people adding/changing things in the docs repo without doing a test build locally in publican first. Jessica T. ________________________________________ From: Marty Sweet [msweet....@gmail.com] Sent: Wednesday, August 14, 2013 11:18 AM To: dev@cloudstack.apache.org Subject: Building Documents with publican Hi, I am trying to build the documentation from the latest git pull. After running the following, lots of processing file entries appear, then the following errors: marty@devbox:~/workspace/cloudstack/docs$ publican build --formats html --langs en-US --common_content=/home/marty/workspace/cloudstack/Common_Content Setting up en-US Processing file tmp/en-US/xml/Common_Content/Conventions.xml -> tmp/en-US/xml/Common_Content/Conventions.xml Processing file tmp/en-US/xml/Common_Content/Feedback.xml -> tmp/en-US/xml/Common_Content/Feedback.xml Processing file tmp/en-US/xml_tmp/xenserver-topology-req.xml -> tmp/en-US/xml/xenserver-topology-req.xml Processing file tmp/en-US/xml_tmp/zone-add.xml -> tmp/en-US/xml/zone-add.xml Beginning work on en-US Validation failed: hypervisor-support-for-primarystorage.xml:6: validity error : ID hypervisor-support-for-primarystorage already defined add-remove-nic.xml:31: validity error : ID prereq-addnic already defined api-throttling.xml:6: validity error : ID api-throttling already defined api-throttling.xml:30: validity error : ID api-throttling-configure already defined api-throttling.xml:61: validity error : ID api-throttling-limitations already defined globally-configured-limits.xml:6: validity error : ID globally-configured-limits already defined configure-package-repository.xml:28: validity error : IDREF attribute linkend references an unknown ID "sect-source-builddebs" management-server-install-multi-node.xml:30: validity error : IDREF attribute linkend references an unknown ID "sect-source-builddebs" using-netscaler-load-balancers.xml:41: validity error : IDREF attribute linkend references an unknown ID "external-guest-lb-integration" configure-package-repository.xml:28: validity error : IDREF attribute linkend references an unknown ID "sect-source-buildrpm" management-server-install-multi-node.xml:30: validity error : IDREF attribute linkend references an unknown ID "sect-source-buildrpm" Anyone got any ideas? I don't understand the docs folder well enough yet to make sense of these errors. Thanks, Marty
