Thanks for the information. I was able to build the Installation Guide with your input!
The one issue I did have, although it's not critical, is that publican was complaining that --config isn't a parameter. What I ended up doing was copying, for example, publican-adminguide.cfg, pasting it, and renaming it to publican.cfg and running without the --config parameter. Thanks again! On Wed, Dec 11, 2013 at 10:07 PM, Radhika Puthiyetath < radhika.puthiyet...@citrix.com> wrote: > Mike, > > Publican-all is not a frequently used config file. > > Do try the following: > > publican build --config=publican-adminguide.cfg --formats=test > --langs=en-US > publican build --config=publican-installation.cfg --formats=test > --langs=en-US > publican build --config=publican-devguide.cfg --formats=test --langs=en-US > > -----Original Message----- > From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com] > Sent: Wednesday, December 11, 2013 11:57 PM > To: dev@cloudstack.apache.org > Subject: Re: Documentation Question > > I tried to set this up on a Windows 7 VM to see if it worked for me. > > I seem to be able to run the build now, but have validation errors. > > Any thoughts on this? > > Processing file tmp/en-US/xml_tmp/xenserver-maintenance-mode.xml > Processing file tmp/en-US/xml_tmp/xenserver-topology-req.xml > Processing file tmp/en-US/xml_tmp/zone-add.xml Beginning work on > en-US Validation failed: cloudstack.xml:6: validity error : ID > hypervisor-support-for-primarystorage already defined > cloudstack.xml:31: validity error : ID prereq-addnic already defined > cloudstack.xml:6: validity error : ID api-throttling already defined > cloudstack.xml:30: validity error : ID api-throttling-configure already > defined > cloudstack.xml:59: validity error : ID api-throttling-limitations already > defined > cloudstack.xml:6: validity error : ID globally-configured-limits already > defined > cloudstack.xml:29: validity error : IDREF attribute linkend references an > unknown ID "sect-source-builddebs" > cloudstack.xml:30: validity error : IDREF attribute linkend references an > unknown ID "sect-source-builddebs" > cloudstack.xml:29: validity error : IDREF attribute linkend references an > unknown ID "sect-source-buildrpm" > cloudstack.xml:30: validity error : IDREF attribute linkend references an > unknown ID "sect-source-buildrpm" > > at script/publican line 453 > > > On Tue, Dec 10, 2013 at 10:40 PM, Radhika Puthiyetath < > radhika.puthiyet...@citrix.com> wrote: > > > I get a clean build. Some perl file (since it it searching for > catalog.pmfile) is missing . Not related to Publican. > > > > -----Original Message----- > > From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com] > > Sent: Wednesday, December 11, 2013 10:36 AM > > To: dev@cloudstack.apache.org > > Subject: Re: Documentation Question > > > > This is just building the current docs without my changes (and my > > changes are quite minor at this point). > > > > > > On Tue, Dec 10, 2013 at 10:05 PM, Mike Tutkowski < > > mike.tutkow...@solidfire.com> wrote: > > > > > Unfortunately got the same error message: > > > > > > mtutkowski-LT:cloudstack-docs mtutkowski$ publican build > > > --config=publican-adminguide.cfg --formats=test --langs=en-US Unable > > > to retrieve URL: [file:/etc/xml/catalog] at > > > /opt/local/lib/perl5/site_perl/5.12.4/XML/Catalog.pm line 170. > > > > > > > > > On Tue, Dec 10, 2013 at 10:00 PM, Radhika Puthiyetath < > > > radhika.puthiyet...@citrix.com> wrote: > > > > > >> Try the following: > > >> > > >> publican build --config=publican-adminguide.cfg --formats=test > > >> --langs=en-US > > >> publican build --config=publican-installation.cfg > > >> --formats=test --langs=en-US > > >> > > >> > > >> Let me pull your changes and try from my end. > > >> > > >> > > >> -----Original Message----- > > >> From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com] > > >> Sent: Wednesday, December 11, 2013 10:24 AM > > >> To: dev@cloudstack.apache.org > > >> Subject: Re: Documentation Question > > >> > > >> Thanks > > >> > > >> I was wondering if you understand what might be the problem here > > >> when I try to build the docs: > > >> > > >> mtutkowski-LT:cloudstack-docs mtutkowski$ publican build > > >> --config=publican-all.cfg --formats=pdf --langs=en-US Unable to > > >> retrieve > > >> URL: [file:/etc/xml/catalog] at > > >> /opt/local/lib/perl5/site_perl/5.12.4/XML/Catalog.pm line 170. > > >> > > >> > > >> On Tue, Dec 10, 2013 at 8:20 PM, Radhika Puthiyetath < > > >> radhika.puthiyet...@citrix.com> wrote: > > >> > > >> > Yes, I am checking into master. > > >> > > > >> > -----Original Message----- > > >> > From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com] > > >> > Sent: Wednesday, December 11, 2013 3:48 AM > > >> > To: dev@cloudstack.apache.org > > >> > Subject: Re: Documentation Question > > >> > > > >> > Hi, > > >> > > > >> > I know we are having a discussion about changing the way we do > > >> > docs in 4.3, but - for the time being - I was making a few > > >> > changes locally from this > > >> > repo: > > >> > > > >> > https://git-wip-us.apache.org/repos/asf/cloudstack-docs.git > > >> > > > >> > I notice there are only the 4.2 and master branches. > > >> > > > >> > I assume master is 4.3 in this repo? > > >> > > > >> > Thanks! > > >> > > > >> > > > >> > On Thu, Dec 5, 2013 at 10:02 PM, Mike Tutkowski < > > >> > mike.tutkow...@solidfire.com> wrote: > > >> > > > >> > > Thanks! > > >> > > > > >> > > > > >> > > On Thu, Dec 5, 2013 at 9:39 PM, Radhika Puthiyetath < > > >> > > radhika.puthiyet...@citrix.com> wrote: > > >> > > > > >> > >> Yes. It has been moved to > > >> > >> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo > > >> > >> > > >> > >> > > >> > >> > > >> > >> -----Original Message----- > > >> > >> From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com] > > >> > >> Sent: Friday, December 06, 2013 12:20 AM > > >> > >> To: dev@cloudstack.apache.org > > >> > >> Subject: Documentation Question > > >> > >> > > >> > >> Hi, > > >> > >> > > >> > >> It's been a while since I've needed to update documentation > > >> > >> for CloudStack's Admin and Installation Guides. > > >> > >> > > >> > >> I know at some point there was talk of breaking documentation > > >> > >> out into another repo. > > >> > >> > > >> > >> Can someone refresh my memory as to whether that new repo was > > >> > >> created or if we decided to keep documentation in the same > > >> > >> place it was located for 4.2? > > >> > >> > > >> > >> Thanks! > > >> > >> > > >> > >> -- > > >> > >> *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> > > >> > >> *(tm)* > > >> > >> > > >> > > > > >> > > > > >> > > > > >> > > -- > > >> > > *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> > > >> > > *(tm)* > > >> > > > > >> > > > >> > > > >> > > > >> > -- > > >> > *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> > > >> > *(tm)* > > >> > > > >> > > >> > > >> > > >> -- > > >> *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> > > >> *(tm)* > > >> > > > > > > > > > > > > -- > > > *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> > > > *(tm)* > > > > > > > > > > > -- > > *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> > > *(tm)* > > > > > > -- > *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> > *(tm)* > -- *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> *™*