Open Stack

On 03/23/2015 01:08 PM, Bernd Bausch wrote:
> Thanks Andreas. Did the same with tox (tox -e docs as you suggested). Tox
> seems to succeed - except for the same error as before. Has anybody run tox
> -e docs recently? Is my system broken?

It runs in our gates without problems.

And it runs locally on my system (just checked).

But I've seen some broken systems with Sphinx recently - but never the 
error you mentioned.

Are you using recent tox and setuptools?

Andreas

> Meanwhile I will try to convert my file to DocBook and to add it to the
> config guide.
>
> Bernd
>
> -----Original Message-----
> From: Andreas Jaeger [mailto:aj at suse.com]
> Sent: Monday, March 23, 2015 8:29 PM
> To: Bernd Bausch; openstack-docs at lists.openstack.org
> Subject: Re: [OpenStack-docs] Sphinx error when building in
> openstack-manuals
>
> On 03/23/2015 11:21 AM, Bernd Bausch wrote:
>> My goal is to add a page to openstack-manuals (it describes policy.json).
>> While its best location would be the configuration guide, there is
>> only one directory with RST files, "playground-user-guide". So I put it
> there.
>
> You cannot mix RST and DocBook directly. So, a file for the configuration
> guide needs to be DocBook XML.
>
>> Maven is not interested in the playground, since there is no pom.xml.
>> Therefore, I run Sphinx directly.
>
> Or run it via tox - tox -e docs
>
>> 1- add policy.rst to
>> openstack-manuals/doc/playground-user-guide/source
>> 2- add it to the table of contents in index.rst
>
> And thus it will show only up in the New User Guide.
>
>> 3- in the source directory, "sphinx-build -b html . my-output-directory"
>>
>>
>> Sphinx throws this at me:
>>
>> File
>> "/home/bbausch/openstack/policy/openstack-manuals/doc/playground-user-
>> guide/ sphinx-ext/scope.py", line 32, in builder_inited
>>       path = os.path.join(app.env.srcdir, doc +
>> app.env.config.source_suffix)
>> TypeError: coercing to Unicode: need string or buffer, list found
>>
>> When I remove the "scope" extension from conf.py, sphinx-build
>> completes successfully. I doubt this is the solution, though.
>>
>> I guess I miss something somewhere. What could it be?
>
> Do you have all requirements installed that are mentioned in
> test-requirements.txt? tox will install them for you,
>
> Andreas
> --
>    Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>     SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>      GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
>          Graham Norton, HRB 21284 (AG Nürnberg)
>       GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>


-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
        Graham Norton, HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126