DocFx - повторно использовать статьи в нескольких «путеводителях» и точно отражать смешанные справочники в пользовательском интерфейсе.

Question

Предполагая структуру articles/{guide}/*.md, цель состоит в том, чтобы (1) повторно использовать файлы .md в более чем одном руководстве, а (2) точно отображать «смешанные» руководства в оглавлении пользовательского интерфейса. Например:

--articles
  --Guide-1
    --toc.yml
    --topic-1a.md
    --topic-1b.md
  --Guide-2
    --toc.yml
    --topic-2a.md
    --topic-2b.md
  --Mixed-Guide
    --toc.yml
--toc.yml

... с articles/Mixed-Guide/toc.yml как:

 - name: Topic 1A
   href: ../Guide-1/topic-1a.md
 - name: Topic 2B
   href: ../Guide-2/topic-2b.md

... и toc.yml as:

 - name: Guide 1
   href: Guide-1/
 - name: Guide 2
   href: Guide-2/
 - name: Mixed Guide
   href: Mixed-Guide/

... отображается в оглавлении как:

  Guide 1
  Guide 2
  Mixed Guide

Текущее поведение

Нажатие Guide 1 или Guide 2 работает должным образом - в оглавлении показаны статьи, перечисленные в оглавлении каждого руководства. Например, TOC в пользовательском интерфейсе для Guide 1:

Topic 1A
Topic 1B

Однако, нажав Mixed Guide, вы переходите к оглавлению Руководства 1.

Желаемое поведение

Нажатие Mixed Guide направляет к оглавлению статей в articles/Mixed-Guide/toc.yml, так что оглавление:

Topic 1A
Topic 2B

... и нажатие Topic 1A делает не перенаправления к оглавлению Guide 1.

Использование href: Mixed-Guide/toc.yml (вместо href: Mixed-Guide/) представляет аналогичную проблему. Содержание:

  Guide 1
  Guide 2
+ Mixed-Guide
   Topic 1A
   Topic 2B

... но нажатие Topic 1A направляет содержимое Guide 1 и Topic 2A до Guide 2.

Общая цель

Я хотел бы собрать несколько руководств из одного пула файлов .md и отразить каждую сборку как свое собственное уникальное руководство в оглавлении. Я экспериментировал с topicHref и xref, но не нашел решения.

Спасибо за любую помощь.