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

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

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

Generate duplicate templates with different breadcrumbs when referenced from different toctrees

breadcrumbs

tableofcontents

python-sphinx

toctree