55、Python 文档资源与常见编码陷阱

Python 文档资源与常见编码陷阱

一、PyDoc 的颜色定制

在对 PyDoc 进行个性化设置时，我们可以搜索颜色值字符串并将其替换为自己偏好的颜色。在 IDLE 中，使用正则表达式 #\w{6} 进行编辑查找，能够定位到颜色字符串。这里的正则表达式会匹配 # 后面的六个字母数字字符，具体的语法可参考 Python 的 re 模块文档。

大多数带有颜色选择对话框的程序都支持 RGB 值的映射，书中还提供了一个 GUI 脚本 setcolor.py 来实现同样的功能。例如，有人将 PyDoc 中的 #ee77aa 替换为 #008080 （蓝绿色），以去除深粉色；把 #ffc8d8 替换为 #c0c0c0 （灰色），改变类文档字符串的浅粉色背景。

不过，这种修改并不轻松，因为 PyDoc 文件目前有 2600 行之多，但这也是一次很好的代码维护练习。在替换像 #ffffff （白色）和 #000000 （黑色）这样的颜色时要格外谨慎，并且一定要先备份 pydoc.py 文件，以防万一。虽然这个文件使用了一些我们还未接触过的工具，但在进行修改时可以暂时忽略其他代码。

目前，Python 社区正在努力改进 PyDoc，使其更具用户定制性。例如，Python 开发者列表上的问题 10716 就致力于让 PyDoc 支持 CSS 样式表。如果