Siyuan, Here is how I build the docs with publican:
cd docs cp -R /usr/share/publican/Common_Content Common_Content cp -R publican-cloudstack Common_Content/cloudstack publican build --config=publican-adminguide.cfg --formats=pdf --langs=en-US --common_content=./Common_Content That's from memory, you may have to tweak the location of the Common_Content directory. Pick the guide that you want to build (different *.cfg file) The resulting pdf will be in /docs/tmp directory Hope that helps, -Sebastien On Nov 29, 2012, at 6:21 AM, Siyuan Tian <tiansiy...@gmail.com> wrote: > Hi Sebastien, > > Nice blog! > > I have some issue with publican on docs directory in git. > > I have the updated git checkout and follow the steps in README.txt. > > I installed publican on my Ubuntu 12.10 via > > sudo apt-get install publican > > The version installed is 2.8 > > Then I try to run > > publican build --formats test --langs en-US > > I get > > "Config file not found: publican.cfg. Perhaps you need to run 'publican > old2new' at /usr/bin/publican line 647" > > I try > > publican old2new > > and get > > "Cannot open Makefile for reading: no such file or directory at > /usr/bin/publican line 493" > > I try again with > > publican build --config=publican-all.cfg --formats test --langs en-US > > I get > > "Failed to load brand file: > /usr/share/publican/Common_Content/cloudstack/publican.cfg at > /usr/bin/publican line 647" > > It seems the README.txt file is out of date. At the beginning of it, it > says: > > "... > Updated: August 8, 2012 > ... > The files are currently incomplete as we are in the process of converting > documentation from an outdated file format into XML files for this repo. > " > > Thanks, > > Tian > > On Wed, Nov 28, 2012 at 11:26 PM, Sebastien Goasguen <run...@gmail.com>wrote: > >> Hi folks, >> >> I just posted a blog on how to help translate the documentation using >> Transifex: >> >> >> http://sebgoa.blogspot.ch/2012/11/translating-apache-cloudstack-docs-with.html >> >> We need tooonnnns of help !! >> >> -Sebastien
