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

Question

我正在通过 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 帮助格式都显示双引号？

Answer 1

解决方案：我的 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帮助并显示，引号现在可以正确显示：

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

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

chm

restructuredtext

html-help-workshop

python-sphinx