Mailing-List: contact cloudstack-users-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cloudstack-users@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of runseb@gmail.com designates
 74.125.82.43 as permitted sender)
Content-Type: text/plain; charset=iso-8859-1
Mime-Version: 1.0 (Mac OS X Mail 6.2 \(1499\))
Subject: Re: Documentation translation
From: Sebastien Goasguen <runseb@gmail.com>
In-Reply-To: 
 <CAAphadZFMbEkBtkY+kH20zOuHty9paPaEZTiUW_7j1=3NqR3Gw@mail.gmail.com>
Date: Thu, 29 Nov 2012 08:42:18 +0100
Content-Transfer-Encoding: quoted-printable
Message-Id: <C8904004-BA7C-4594-A8F5-096B37212EBB@gmail.com>
References: <7F6470BC-9E5D-4BDB-980C-DC463D65A158@gmail.com>
 <CAAphadZFMbEkBtkY+kH20zOuHty9paPaEZTiUW_7j1=3NqR3Gw@mail.gmail.com>
To: cloudstack-users@incubator.apache.org

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=3Dpublican-adminguide.cfg --formats=3Dpdf =
--langs=3Den-US --common_content=3D./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 <tiansiyuan@gmail.com> wrote:

> Hi Sebastien,
>=20
> Nice blog!
>=20
> I have some issue with publican on docs directory in git.
>=20
> I have the updated git checkout and follow the steps in README.txt.
>=20
> I installed publican on my Ubuntu 12.10 via
>=20
>     sudo apt-get install publican
>=20
> The version installed is 2.8
>=20
> Then I try to run
>=20
>    publican build --formats test --langs en-US
>=20
> I get
>=20
> "Config file not found: publican.cfg. Perhaps you need to run =
'publican
> old2new' at /usr/bin/publican line 647"
>=20
> I try
>=20
>   publican old2new
>=20
> and get
>=20
> "Cannot open Makefile for reading: no such file or directory at
> /usr/bin/publican line 493"
>=20
> I try again with
>=20
>    publican build --config=3Dpublican-all.cfg --formats test --langs =
en-US
>=20
> I get
>=20
> "Failed to load brand file:
> /usr/share/publican/Common_Content/cloudstack/publican.cfg at
> /usr/bin/publican line 647"
>=20
> It seems the README.txt file is out of date. At the beginning of it, =
it
> says:
>=20
> "...
> 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.
> "
>=20
> Thanks,
>=20
> Tian
>=20
> On Wed, Nov 28, 2012 at 11:26 PM, Sebastien Goasguen =
<runseb@gmail.com>wrote:
>=20
>> Hi folks,
>>=20
>> I just posted a blog on how to help translate the documentation using
>> Transifex:
>>=20
>>=20
>> =
http://sebgoa.blogspot.ch/2012/11/translating-apache-cloudstack-docs-with.=
html
>>=20
>> We need tooonnnns of help !!
>>=20
>> -Sebastien