SandCastle 帮助文件生成器:搜索不起作用 [英] SandCastle Help File Builder: Search not working
问题描述
我刚刚下载了最新版本的 Sancastle Help File Builder 2017.1.28.0.根据
我生成了一个虚拟帮助，其中包含一些用于测试的概念性主题.尝试搜索例如CHM 最终得到以下结果:
(1) 通过打开方式"或双击打开 index.html 本地:
- 浏览器 FireFox:搜索功能正常
- 浏览器 Microsoft Internet Explorer:搜索正在运行
- 浏览器 Microsoft Edge:搜索不工作
- 浏览器 Google Chrome:搜索不工作
(2) 打开从服务器上传的文件 (https://www.help-info.de/help-sandcastle)
- 所有浏览器:搜索正常
因此，搜索正在运行，但在此阶段对本地存储的文件结构存在限制.
(在联系作为 Sandcastle Help File Builder)
从本地文件系统打开时，会产生额外的安全性，并且某些脚本会被阻止且无法运行.因此，搜索和可扩展目录等某些功能无法按预期工作.
如果您不想将它们上传到服务器以测试网站输出，也可以使用本地 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屋！
