WARNING: undefined label :ref: tag can't generate HTML cross reference properlly for i18n documentation
I used :ref: tag but it seems that HTML cross references are not properlly generated.
- news.rst ( define .. _release-1-20 label)
- install.rst ( there is a reference to :ref:
but it seems that sphinx can't find label in Japanese documentation. It works for English documentation.
Here is the output results at that time.
pickling environment... done checking consistency... /home/kenhys/work/sphinx/sphinx-missing-xref/doc/source/news.rst:: WARNING: document isn't included in any toctree done preparing documents... done writing output... [ 33%] index writing output... [ 66%] install writing output... [100%] news /home/kenhys/work/sphinx/sphinx-missing-xref/doc/source/install.rst:23: WARNING: undefined label: release-1-20 (if the link has no caption the label must precede a section header) /home/kenhys/work/sphinx/sphinx-missing-xref/doc/source/install.rst:25: WARNING: undefined label: release-2-00 (if the link has no caption the label must precede a section header)
<em class="xref std std-ref">release-1-20</em> を参照してください。
<a class="reference internal" href="news.html#release-1-02"><em>1.20リリース - 2012/01/29</em></a>
How to reproduce
I've attached archives which reproduced this situation.
This issue is found on Mroonga (http://mroonga.org) documentation. I try to minimize from original source, the directory structure may be strange for normal sphinx user.
Here is the tree of arvhives:
- doc/source (rst text)
- doc/locale/ja/html (Japanese documentation)
- doc/locale/en/html (English documentation)