[OpenStack-docs] Sphinx error when building in openstack-manuals

Anne Gentle annegentle at gmail.com
Mon Mar 23 13:28:04 UTC 2015


>
>
>
> Message: 2
> Date: Mon, 23 Mar 2015 19:21:56 +0900
> From: "Bernd Bausch" <berndbausch at gmail.com>
> To: <openstack-docs at lists.openstack.org>
> Subject: [OpenStack-docs] Sphinx error when building in
>         openstack-manuals
> Message-ID: <011201d06553$32f2faa0$98d8efe0$@gmail.com>
> Content-Type: text/plain;       charset="us-ascii"
>
> 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.
>
> Maven is not interested in the playground, since there is no pom.xml.
> Therefore, I run Sphinx directly.
>
> 1- add policy.rst to openstack-manuals/doc/playground-user-guide/source
> 2- add it to the table of contents in index.rst
> 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?
>
> Bernd
> OpenStack apprentice
>
>
>
I'm investigating.

When building master branch this morning, if I build anything I get a
WARNING on any of the files that are marked admin_only, even when I build
with the tag in the command line. I'll see what's up by working on it
today, look for a patch (your) overnight if we get it figured out.

Thanks for reporting -
Anne
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150323/78175ada/attachment.html>


More information about the OpenStack-docs mailing list