当从不同的toctrees引用时，生成不同面包屑的重复模板。

Question

我的文档结构是这样的。

├── common
│   └── shared.rst
├── foo
│   └── foo.rst
├── index.rst
└── zoo
    └── zoo.rst

生成的结构是这样的：

├── common
│   └── shared.html (breadcrumbs: home -> zoo -> shared)
├── foo
│   └── foo.html
├── index.html
└── zoo
    └── zoo.html

我的toctree的foo & zoo都是这样的:

.. toctree::
    :includehidden:

    ../common/shared

我想编译两个不同的shared.html文件 其中一个的面包屑是这样的 breadcrumbs: home -> zoo -> shared 其二 breadcrumbs: home -> foo -> shared. 用sphinx可以吗？

作为参考，这是我生成面包屑的模板代码。

<section>
  <ul class="breadcrumbs">
    <li><a href="{{ pathto(master_doc) }}">Home</a></li>
    {% for doc in parents %}
      <li><a href="{{ doc.link|e }}">{{ doc.title }}</a></li>
    {% endfor %}
    {% if title != 'LaunchKey Documentation' %}
      <li><a href="#" class="active">{{ title }}</a></li>
    {% endif %}
  </ul>
</section>

Answer 1

最后把一个 shared.rst 在两个 /foo 和 /zoo 并使用了一个include来使用共享副本。

.. include:: ../common/shared.rst