在DocFx中检测目录toc.yml文件中缺少的文章

问题描述

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

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

• 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文件完成大致相同的操作。

如果有人知道该怎么做，或者对我的追求有建议，谢谢。

解决方法

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

Documentation

docfx.json中的示例用法：

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