SandCastle帮助文件生成器：搜索不起作用 [英] SandCastle Help File Builder: Search not working

问题描述

我刚刚下载了最新版本的Sancastle帮助文件生成器2017.1.28.0。
根据

我生成了一个虚拟的帮助，其中包括一些要测试的概念性主题。尝试搜索例如CHM最终得到以下结果：

（1）通过打开方式或双击打开index.html local：

• 浏览器FireFox：搜索正常


• 浏览器Microsoft Internet Explorer：搜索正常


• 浏览器Microsoft Edge ：搜索无效


• 浏览器Google Chrome：搜索无效

（2）打开上载服务器中的文件（ https://www.help-info.de/help-sandcastle）

• 所有浏览器：搜索正常

因此，搜索工作正常，但现阶段对本地存储的文件结构有所限制。

编辑：（与Eric Woodruff联系后作为 Sandcastle帮助文件生成器的创建者）

从本地文件系统打开时，额外的安全性插入，某些脚本将被阻止并且无法运行。因此，某些功能（例如搜索和可扩展目录）无法按预期工作。

如果您不想使用本地Web开发服务器或IIS Express，也可以使用将它们上传到服务器以测试网站输出。 SHFB中有一个选项可以与本地服务器一起运行。

I have just downloaded the latest version of Sancastle Help File Builder 2017.1.28.0. According to the answers and comments from this post, I expected the search to work but it doesn't. No matter what I am trying to search for, I will get a "Nothing found" message. BTW, I do not have any aspx file generated.

I tried using Google Chrome browser

Do I miss any project configuration?

How can I make the search working?

解决方案

The described behaviour seems to depend on the used browser. Following snapshots show a working and a NOT working case:

I generated a dummy help including some conceptual topics for testing. Trying a search for e.g. CHM ends up with following results:

(1) Open index.html local by "Open with" or double click:

• Browser FireFox: Search is working
• Browser Microsoft Internet Explorer: Search is working
• Browser Microsoft Edge: Search NOT working
• Browser Google Chrome: Search NOT working

(2) Open uploaded files from server (https://www.help-info.de/help-sandcastle)

• All browsers: Search is working

So, search is working but at this stage there are restrictions on locally stored file structure.

Edit: (after contacting Eric Woodruff as the creator of Sandcastle Help File Builder)

When opened from the local file system, extra security kicks in and some of the script gets blocked and can’t run. As such, certain features like search and the expandable TOC don’t work as expected.

Using the local web dev server or IIS Express also works if you don’t want to upload them to a server to test the website output. There’s an option in SHFB to run it with the local server.

这篇关于SandCastle帮助文件生成器：搜索不起作用的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！