成为Python砖家(1): 在本地查询Python HTML文档
目的
Python3 官方文档位于 https://docs.python.org/3/ , 有时候网络无法连接,或者连接速度慢, 这对于学习 Python 时的反馈造成了负面影响。准备一份本地 Python 文档可以让反馈更加及时。
下面给出 macOS 和 Win11 下的 Python 离线文档安装和查看方式。
macOS
本地是 macOS 系统。
下载 python html 格式文档
https://docs.python.org/3/download.html
下载logo png图像
https://www.python.org/community/logos/
创建 PythonDoc.sh, 用于创建 PythonDoc.app:
#!/bin/bash# This script generates /Application/PythonDoc.app, which can be searched in launchpad
# You should have already downloaed Python HTML document from https://docs.python.org/3/download.htmlmkdir -p ~/Applications/PythonDoc.app/Contents/MacOS
mkdir -p ~/Applications/PythonDoc.app/Contents/Resourcescat <<EOF > ~/Applications/PythonDoc.app/Contents/MacOS/PythonDoc
#!/bin/bash
open /Users/zz/Documents/python-3.12.5-docs-html/index.html
EOFchmod +x ~/Applications/PythonDoc.app/Contents/MacOS/PythonDoccat <<EOF > ~/Applications/PythonDoc.app/Contents/Info.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict><key>CFBundleExecutable</key><string>PythonDoc</string><key>CFBundleIdentifier</key><string>org.python.doc</string><key>CFBundleName</key><string>PythonDoc</string><key>CFBundleVersion</key><string>1.0</string><key>CFBundlePackageType</key><string>APPL</string><key>CFBundleIconFile</key><string>Python.icns</string>
</dict>
</plist>
EOFcp python-logo-only.icns ~/Applications/PythonDoc.app/Contents/Resources/Python.icnsrm -rf /Applications/PythonDoc.app
mv ~/Applications/PythonDoc.app /Applications/
效果:
Win11
下载 Python html 格式文档: https://docs.python.org/3/download.html
解压到 D:/docs/python-3.12.5-docs-html
目录
进入 C:\ProgramData\Microsoft\Windows\Start Menu\Programs
目录, 创建 Python
目录
进入 D:/docs/python-3.12.5-docs-html
目录, 创建 index.html
的快捷方式,并剪切到 C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Python
目录, 重命名为 Python Documentation.html
文件:
进入开始菜单,输入 Python doc,可以看到创建的应用:
执行查询: