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

 

本文不介绍 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'])

 

完。

 

来源：oschina

链接：https://my.oschina.net/u/4408992/blog/4245831