python-sphinx - 从不同的目录树引用时生成具有不同面包屑的重复模板

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

我的 foo 和 zoo 的目录树看起来像：

.. toctree::
    :includehidden:

    ../common/shared

我想要编译 2 个不同的 shared.html 文件，一个带有面包屑看起来像breadcrumbs: home -> zoo -> shared，另一个是breadcrumbs: home -> foo -> shared. 狮身人面像有可能吗？

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

<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:: ../common/shared.rst