Sphinx 生成 Windows 帮助文件 (.chm文件)

Posted 2020-10-25 Anonymous

 

本文不介绍 Sphinx 的用法，只简要罗列 Windows 下生成 .chm 文件的步骤。

 

0. 首先检查机器是否安装了 html Help Workshop 软件，一般安装路径应该是 C:\\Program Files (x86)\\HTML Help Workshop\\hhw.exe

　如果没有安装，下载安装包 htmlhelp.exe 双击安装即可，地址为 https://msdn.microsoft.com/en-us/library/ms669985

 

1. 编译输出文件时，使用命令:  make htmlhelp

　这样就会在 ..\\build\\htmlhelp 目录下生成  HTML help project 文件 .hhp 文件，右键单击该文件，选择默认打开方式为 C:\\Program Files (x86)\\HTML Help Workshop\\hhw.exe

　如下点击编译，

　

　编译完成，即可生成 .chm 文件。

 

2. 在 Python 开发的 Help 菜单按钮上点击打开 .chm 文件的方法

import subprocess
subprocess.Popen([r\'C:\\Windows\\hh.exe\', r\'Absolute/path/to/.chm\'])

 

完。