fuel-dev team mailing list archive

[Mike Scherbakov <mscherbakov@xxxxxxxxxxxx>]

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