Hi Mike, Try the --config=publican-all.cfg option. Please let me know if you can get it to build successfully?
Thanks, Marty On Thu, Aug 15, 2013 at 5:58 PM, Mike Tutkowski < mike.tutkow...@solidfire.com> wrote: > 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> > *™* >
