I'm new to Publican, as well. When I run the following:
c:\docs\en-US>publican build --formats=test --langs=en-US I get the following error message: Config file not found: publican.cfg. at script/publican line 689 Unfortunately I don't know much about Publican. I'm just trying to document the storage plug-in I developed for 4.2. :) Any thoughts on this one? Thanks! On Thu, Aug 15, 2013 at 12:31 AM, Prasanna Santhanam <t...@apache.org> wrote: > 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 > > -- *Mike Tutkowski* *Senior CloudStack Developer, SolidFire Inc.* e: mike.tutkow...@solidfire.com o: 303.746.7302 Advancing the way the world uses the cloud<http://solidfire.com/solution/overview/?video=play> *™*
