检测 DocFx 中 table 个内容 (toc.yml) 文件中丢失的文章

Question

抱歉，如果这是一个简单的解决方案，我不知道。

假设源文件在这样的目录中...

• Docs/articles/guide-1/article-1.md
• Docs/articles/guide-1/article-2.md
• Docs/articles/guide-1/article-3.md
• Docs/articles/guide-1/article-4.md
• Docs/articles/guide-1/article-5.md
• Docs/articles/guide-1/toc.yml

...并且 toc.yml 看起来像这样：

 - name: Article 1
   href: article-1.md
 - name: Article 2
   href: article-2.md
 - name: Article 3
   href: article-3.md

有没有办法看到 article-4.md 和 article-5.md 与 toc.yml 在同一目录中，但文件中没有引用？

我知道 scripts that identify image files that are un-referenced in a directory of Markdown files。我希望用未引用的 Markdown 文件完成大致相同的事情。

谢谢你，如果有人知道如何做到这一点，或者对我可能追求的方向有什么建议。

Answer 1

我现在发现 DocFx 内置了一种方法。您可以生成属性 generatesAppendices 为 true 的 PDF。这会在输出 PDF 的目录中生成一个名为 appendices 的文档。它显示所有未链接到 TOC 的文件。添加 .pdf 扩展名。

Documentation

docfx.json中的用法示例：

    "template": [
      "pdf.default",
    ],
    "keepRawFiles": false,
    "generatesAppendices": "true",