On jenkins this is what is used: cp -R /usr/share/publican/Common_Content Common_Content cp -R docs/publican-cloudstack Common_Content/cloudstack (cd docs && publican build --config=publican-adminguide.cfg --formats html,pdf --langs en-US --common_content=./Common_Content) for format in html ; do tar cjf "cloudstack-adminguide-en-US-$format.tar.bz2" -C "docs/tmp/en-US/$format" . ; done cp docs/tmp/en-US/pdf/* .
On Thu, Aug 15, 2013 at 07:22:32AM +0100, Marty Sweet wrote: > Hi Jessica, > > Should I try to fix these errors? I can't see any build tests on Jenkins > which are failing but that does seem to be looking at another source, where > is this picked up from? > > Thanks, > Marty > > On Wednesday, August 14, 2013, Jessica Tomechak wrote: > > > 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 <javascript:;>] > > Sent: Wednesday, August 14, 2013 11:18 AM > > To: dev@cloudstack.apache.org <javascript:;> > > 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 > > -- Prasanna., ------------------------ Powered by BigRock.com
