I moved the hidden toctrees to their introductory documents instead of the main index document, and it's working great.
Example: index.rst: .. toctree:: :maxdepth: 2 :name: main intro common_tasks settings_overview common_tasks.rst: .. _common_tasks: =============== Common Tasks =============== This article gives overview information about various configuration tasks. .. toctree:: :hidden: :maxdepth: 1 :name: common_tasks_toc task1_info task2_info task3_info The "orphan" tag is still being processed as a table header or something in 1.4.8 - but I just won't use it, no big deal. Thanks. On Wednesday, October 12, 2016 at 9:10:59 PM UTC-4, Komiya Takeshi wrote: > > Ah, I understand your situation. > Sorry, :orphan: does not effect for this case. > > The warnings from included files are resolved at 1.4.x series. > Please update Sphinx to newest one. > > Thanks, > Takeshi KOMIYA > > 2016年10月13日木曜日 8時27分53秒 UTC+9 EMK: >> >> >> <https://lh3.googleusercontent.com/-_QIUNHJzVIA/V_59913blBI/AAAAAAAAABo/WMZZHkBmnk8EMTVu725h3uSnunf--ZxxACLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.16.39%2BPM.png> >> >> Once again I should confess that I am running Sphinx v1.3.2, so if there >> have been bug fixes that address this, I need to upgrade. >> >> I am only using the :orphan: tag with files that are included in other >> files. It shows up in my HTML as orphan: and is formatted similar to a >> table header. >> >> >> <https://lh3.googleusercontent.com/-2wgksnJnBeI/V_58168wo3I/AAAAAAAAABc/cwx81ySfPT0yPDdL-9pcXrKsqFdr4TgBwCLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.04.48%2BPM.png>[image: >> >> frontmatter.rst source file] >> <https://lh3.googleusercontent.com/-2wgksnJnBeI/V_58168wo3I/AAAAAAAAABc/cwx81ySfPT0yPDdL-9pcXrKsqFdr4TgBwCLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.04.48%2BPM.png>[image: >> >> include statement] >> <https://lh3.googleusercontent.com/-_QIUNHJzVIA/V_59913blBI/AAAAAAAAABo/WMZZHkBmnk8EMTVu725h3uSnunf--ZxxACLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.16.39%2BPM.png> >> >> >> [image: html result] >> <https://lh3.googleusercontent.com/-XSHpskG5hwI/V_589lGqa3I/AAAAAAAAABg/t7DTOBb7DX0Qfxq1iXewowx5A5Yut056QCLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.05.30%2BPM.png> >> >> >> On Wednesday, October 12, 2016 at 1:20:29 PM UTC-4, Komiya Takeshi wrote: >>> >>> >>> Can you give an example of how to use the orphan metadata tag? >>>> >>> >>> Here: >>> >>> :orphan: >>> >>> Title of document >>> ================== >>> >>> blah blah blah... >>> >>> >>>> >>>> - Where do I put the tag, in the file that is causing the build >>>> warning or in the TOC file? >>>> >>>> The top of each files which are not listed in toctree. >>> >>> >>>> >>>> - What syntax is used - is "orphan" meant to be the field name or >>>> field content term? >>>> >>>> >>> "orphan" is a field name. orphan field does not need any content. so >>> only `:orphan:` works well. >>> >>> >>>> >>>> - Is there another tag that goes with this syntax to hide it from >>>> the output? >>>> >>>> When I tried adding :orphan: at the top of my file, I didn't see the >>>> build warning, but the word "orphan:" also appeared on my HTML page. >>>> >>> >>> That's strange. The orphan metadata is not appeared in HTML docs. >>> Could you share your example? >>> >>> Thanks, >>> Takeshi KOMIYA >>> >>> >>>> >>>> >>>>> If you want to prevent warnings, please mark the document as :orphan:. >>>>> To use it, please refere following page: >>>>> >>>>> http://www.sphinx-doc.org/en/stable/markup/misc.html?highlight=orphan#file-wide-metadata >>>>> >>>>> Thanks, >>>>> Takeshi KOMIYA >>>>> >>>>> -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users+unsubscr...@googlegroups.com. To post to this group, send email to sphinx-users@googlegroups.com. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.