从 HTML Help Workshop 生成 chm 时双引号转换为方框

Double quotes converted to box when generating chm from HTML Help Workshop

我正在通过 Sphinx 和重组文本创建文档,然后发出以下命令:

$ make html

$ make htmlhelp.

完成后,我使用 HTML Help Workshop 编译 chm 文件。

简单的 HTML 文档看起来不错,文字看起来是我想要的。
但是,当我打开 chm 文件时,所有双引号都转换为方框:

这是我重组后的文本的一部分:

Opening the FTP in Windows File Explorer
""""""""""""""""""""""""""""""""""""""""

To open the FTP in Windows File Explorer (this may need to be done through a network administrator using group policies):

- Open IE
- Go to the *Tools* menu and select *Internet Options*
- Go to the *Advanced* tab
- Check the box "*Enable ftp folder view (Outside of Internet Explorer)*"

Adding a FTP shortcut to Windows File Explorer
""""""""""""""""""""""""""""""""""""""""""""""

You may want to add a shortcut to it either on your desktop or straight under *My Computer* in Windows File Explorer. The File Explorer shortcut is useful as it only requires you to log in when you first access it during your windows session. To do so:

- Open Windows Explorer
- Right-click on "My Computer" in the navigation panel on the left
- Choose "Add new network location"
- Use the wizard to create a new network location for your FTP site
- The FTP site will now show up in My Computer as a network location. You can make shortcuts from there by right-clicking on the connection and choosing "send to" > "desktop (as shortcut)".

正在输入@quot;按字面显示为@quot;

如何修复重组后的文本,使 html 和 html 帮助格式都显示双引号?

解决方案:我的 Sphinx 使用名为 RTD (ReadTheDocs) 的主题,如果您找到主题源代码,请在任何纯文本编辑器中打开 layout.html。

在这里找到我的:C:\Python27\Lib\site-packages\sphinx_rtd_theme\layout.html

查找:

  <meta charset="utf-8">

围绕它放置条件逻辑,将在构建时忽略 utf-8 设置 html 帮助:

  {% if 'htmlhelp' not in builder %}
  <meta charset="utf-8">
  {% endif %}

制作html帮助,编译html帮助并显示,引号现在可以正确显示: