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
