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.

Reply via email to