fuel-dev team mailing list archive

[Meg McRoberts <mmcroberts@xxxxxxxxxxxx>]

Hi, all,
Thanks, Mike.  I know you are incredibly busy!

Dmitry found my problem -- I had an include file with a space at the
beginning of the line,
before the ..include...  Someday I hope to understand Sphinx well enough to
know why that
constituted a container but, for the meantime, my problems are solved.

meg


On Wed, Apr 2, 2014 at 11:45 PM, Mike Scherbakov
<mscherbakov@xxxxxxxxxxxx>wrote:

> Sorry Meg,
> I can't really help as I'm overloaded these days.
>
> fuel-dev, any volunteer to help Meg with Sphinx?
>
> Thanks!
>
>
> On Tue, Apr 1, 2014 at 11:37 AM, Meg McRoberts <mmcroberts@xxxxxxxxxxxx>wrote:
>
>> Thanks, Mike.  Yes, this is one of the documents I found.  My problem is
>> that I don't know what or where the
>> container directive is.  I read  this:
>> http://docutils.sourceforge.net/docs/ref/rst/directives.html -- it looks
>> like the
>> container directive is going to contain the "container" string -- I did a
>> grep -r on the fuel-docs repo and get no
>> hits for "container".
>>
>> Any suggestions about what I should be looking for?  This was building
>> fine before I split the files...
>>  meg
>>
>>
>> On Mon, Mar 31, 2014 at 11:47 PM, Mike Scherbakov <
>> mscherbakov@xxxxxxxxxxxx> wrote:
>>
>>> Doesn't this help:
>>> http://comments.gmane.org/gmane.text.docutils.user/5827 ?
>>>
>>>
>>> On Tue, Apr 1, 2014 at 8:09 AM, Meg McRoberts <mmcroberts@xxxxxxxxxxxx>wrote:
>>>
>>>> Hi, Mike,
>>>> I have a doc build problem that I can't figure out -- could you help or
>>>> forward this to
>>>> someone else who can help.
>>>>
>>>> As a first step in the doc reorganization (blueprints coming soon),
>>>> Dmitry wants me to
>>>> break up the existing doc source into modular files -- only one header
>>>> section per file.
>>>> Also making the source tree deeper, with more sub-directories.  I am
>>>> doing this phase
>>>> without modifying or moving any of the information.
>>>>
>>>> The Install Guide is the last one I did and I am now getting the
>>>> following build error:
>>>>
>>>> Warning, treated as error:
>>>> pages/install-guide/0070-networks/0100-understand-config-network.rst:11:
>>>> SEVERE: Unexpected section title.
>>>>
>>>>     Understanding and Configuring the Network
>>>>     =========================================
>>>>
>>>>     make: *** [html] Error 1
>>>>     megm@megm-ThinkPad-W530:~/fuel-docs$
>>>>
>>>> This happens locally and with Jenkins.
>>>>
>>>> I googled and found information that this indicates that I have a
>>>> section header inside a
>>>> container directive but I can't find the "container" string anywhere in
>>>> these docs.  I've tried
>>>> all sorts of things to get around it -- if I delete the "========="
>>>> line under this header, I get
>>>> the same message for the next heading that comes up.
>>>>
>>>> Is there something else that masquerades as a container directory?
>>>>  Anything else I should
>>>> look for.
>>>>
>>>> I committed the files despite the build error so you could see them:
>>>> https://review.openstack.org/#/c/84334/
>>>>
>>>> I'll be online past midnight
>>>> my time if you want to Skype or something.
>>>>
>>>> Thanks much!
>>>> meg
>>>>
>>>
>>>
>>>
>>> --
>>> Mike Scherbakov
>>> #mihgen
>>>
>>
>>
>
>
> --
> Mike Scherbakov
> #mihgen
>