Hi Kathy -- Fantastic! Thank you for the detailed description -- I was missing the use of different directories to collect related-scope content. I'll give it a shot.
Thanks again, Ramon On Wednesday, March 28, 2012 9:33:55 AM UTC-7, Kathy Tolbert wrote: > > Hello again, Ramon. > > > > Here is how we approached the multi-level documentation using the include > directive. > > > > Directory structure for this test: > > > > Root product directory > > -- 01_files_cast_basic > > -- 02_files_cast_extended > > -- 03_files_cast_advanced (contains the advanced .rst file: > content_advanced.rst which is the actual documentation) > > -- manual_cast_advanced > > -- manual_cast_basic > > -- manual_cast_extended > > > > > > The ‘manual_cast_advanced’ directory contains these .rst files. > > advanced.rst > > basic.rst > > extended.rst > > index.rst > > > > > > For the ‘advanced’ documentation (which needed to include the basic and > advanced sections), the index.rst file included all 3 sections: > > > > Contents: > > > > .. toctree:: > > :maxdepth: 4 > > > > basic > > extended > > advanced > > > > Then, each of the files called above uses an include statement. Content > for the ‘advanced.rst’ file shown below: > > > > > > ADVANCED SECTION > > ------------------------------------------ > > > > .. include:: ../03_files_cast_advanced/content_advanced.rst > > > > > > > > Kathy > > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To view this discussion on the web visit https://groups.google.com/d/msg/sphinx-dev/-/FxcChY3LEuQJ. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
