Thanks, Dmitry! I just fixed that -- let's see if Jenkins can build it now.
Can anyone explain why we need separate sourcing files for PDF and HTML? I was just curious. meg On Thu, Apr 3, 2014 at 12:52 AM, Dmitry Ilyin <[email protected]> wrote: > Meg, we have found out why the doc isn't building. > > There is a reference to the removed file > ./contents/contents-install.rst: .. include:: > /pages/install-guide/networks.rst > > You have removed it from /install-guide.rst but forgot to remove it > from /contents/contents-install.rst > Files inside the contents folder are only used when building pdf. So error > is not visible when you try to build html. > > > 2014-04-03 11:15 GMT+04:00 Dmitry Ilyin <[email protected]>: > >> Hi, Meg >> >> I have built the second revision of your updates without an error. >> >> It's great that we are going to correct our fuel-docs repo, there are a >> lot of minor issues, old garbage and other stuff that should be fixed. >> If you have any problems with rst or Sphinx or just need an advice you >> can always ask me, I'll try to help you. >> And I can also participate in the doc cleanup process. >> >> >> 2014-04-03 10:45 GMT+04:00 Mike Scherbakov <[email protected]>: >> >>> 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 >>> <[email protected]>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 < >>>> [email protected]> 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 <[email protected] >>>>> > 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 >>> >>> -- >>> Mailing list: https://launchpad.net/~fuel-dev >>> Post to : [email protected] >>> Unsubscribe : https://launchpad.net/~fuel-dev >>> More help : https://help.launchpad.net/ListHelp >>> >>> >> >
-- Mailing list: https://launchpad.net/~fuel-dev Post to : [email protected] Unsubscribe : https://launchpad.net/~fuel-dev More help : https://help.launchpad.net/ListHelp
