Html 页面未显示在使用 Sandcastle 帮助文件生成器构建的 .chm 中

Question

使用早期版本的 SHFB (1.9.3.0)，我可以添加“WhatsNew”html 页面内容。单个 html 文件显示在内容下

下面是.shbproj中添加html页面的标签

<ItemGroup>
    <Content Include="WhatsNew.html" />
</ItemGroup>

以下是我在使用最新 SHFB 版本运行时使用的设置。

<HelpFileFormat>HtmlHelp1</HelpFileFormat>
<SyntaxFilters>Standard</SyntaxFilters>
<PresentationStyle>VS2013</PresentationStyle>
<CleanIntermediates>True</CleanIntermediates>
<KeepLogFile>True</KeepLogFile>
<DisableCodeBlockComponent>False</DisableCodeBlockComponent>

使用最新版本的 sandcastle 帮助文件生成器构建时，我无法再在 chm 中添加 html 页面。我没有看到任何构建错误或与 html 内容相关的任何警告。知道我可能会错过什么吗？

Answer 1

我了解到从版本 1.7.0.0 开始，帮助文件生成器支持概念性内容。这本质上与附加内容类似，因为它允许您将非参考内容添加到将出现在目录中的帮助文件中。

因此，我必须添加具有包含 Microsoft 辅助标记语言 (MAML) 的主题文件的概念内容，而不是添加 HTML 文件或包含 HTML 的 .topic 文件。有一个 HtmlToMamlConverter 我用来将 html 文件转换为 MAML。我将 _ContentLayout.content（此文件是作为 htmlToMamlConverter 的输出生成的）文件添加到我的 .shfbproj 中。通过在 Sandcastle GUI 中打开 .content 文件添加主题（.aml 文件）。以下是我设置的字段