<div dir="ltr">Hi.  I placed the new rst file in admin-guide-cloud-rst/source and the figure in common. There are quite a number of files from common that are included in the DocBook version of the admin guide for the objectstorage chapter as well as other chapters.  I will verify what other admin cloud chapters or books share these common files.<div>Thanks.<br><div><br></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jun 9, 2015 at 3:02 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On 06/09/2015 06:11 PM, Karen Bradshaw wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi.  I am having a build issue with an included file in common-rst.<br>
I have a file with a toc in admin-guide-cloud-rst/source<br>
and the included file in common-rst or the local linked dir of common.<br>
The RST parser complains about<br>
openstack_manuals/doc/user-guide/source/common/<myfile>. Of course this<br>
common dir links to common-rst where the file resides.  Problem sharing<br>
the contents of the common dir with user guide and admin cloud guide?  I<br>
can move the file, objectstorage_characteristics, out of the common dir.<br>
</blockquote>
<br></div></div>
What happens is that we link common-rst to each RST guide and RST hates orphaned files. So, when you add a file to common-rst and include it only from the admin-guide-cloud-rst directory, the build of user-guide, user-guide-admin, and networking-guide will fail since the file is not part of any TOC.<br>
<br>
So, there are several options:<br>
<br>
1) There are lots of files in common that are used only in one guide - so it's time to clean them up. If you have a file that is really only used in the admin-guide-cloud, don't put it into common-rst, put it into admin-guide-cloud-rst.<br>
<br>
2) You can mark a file as ":orphan:". This way it will still get build but Sphinx will not error out if it's not included in a TOC.<br>
<br>
3) Blacklist a file, using the doc/.../source/conf.py variable exclude_patterns. Just add the filename to all RST guides.<br>
<br>
If anybody has a better way, please propose and implement ;)<span class="HOEnZb"><font color="#888888"><br>
<br>
Andreas<br>
-- <br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
</font></span></blockquote></div><br></div>