自己动手制作MySQL Internals Manual For Dash文档

摘要

1. 准备工作 1.1 下载Mysql文档用wget批量、自动下载Internals Manual及mysql 8.0 Release Notes文档。 [root@yejr.me]# cd /data/mysql

自己动手制作MySQL Internals Manual For Dash文档

用wget批量、自动下载Internals Manual及mysql 8.0 Release Notes文档。

[root@yejr.me]# cd /data/mysql-docs
[root@yejr.me]# wget -r -p -np -k --no-check-certificat "https://dev.mysql.com/doc/internals/en/index.html"
[root@yejr.me]# wget -r -p -np -k --no-check-certificat "Https://dev.mysql.com/doc/relnotes/mysql/8.0/en/"
[root@yejr.me]# ls -l dev.mysql.com
drwxr-xr-x 3 root root 16Feb2913:25 internals
drwxr-xr-x 3 root root 19Feb2922:19 relnotes

制作Dash docset文档，需要用到Python的beautifulsoup4模块，因此要先安装上。安装beautifulsoup4模块挺简单的，用Python的pip就可以了，如果不知道的话，可以先自行搜索一番。

此外，还需要sqlite数据库，如果没有的话，也先自行安装，用yum就可以了，也挺方便的。

接下来就是要编辑Info.plist文件了，这也是docset的metadata文件了，存储基本信息，以及定义一些配置等。

[root@yejr.me]# cat MySQL_Internal.docset/Contents/Info.plist
ion="1.0" encoding="UTF-8"?>
"-//Apple//DTD PLIST 1.0//EN""http://www.apple.com/DTDs/PropertyList-1.0.dtd">
"1.0">
CFBundleIdentifier
MySQLInternalManualstring>
CFBundleName
MySQLInternalManualstring>
DocSetPlatfORMFamily
MySQLInternalManualstring>
dashIndexFilePath
index.htmlstring>
isDashDocset
<true/>

Dash的文档索引采用SQLite数据库，SQLite是一个很小巧的、开源的关系型数据库，据说很可能是使用量最大的关系数据库。

先创建docset索引表：

[root@yejr.me]# sqlite3 MySQL_Internal.docset/Contents/Resources/docSet.dsidx
SQLite version 3.28.02019-04-1514:49:49
Enter".help"for usage hints.
sqlite> CREATE TABLE searchIndex(id INTEGER PRIMARY KEY, name TEXT, type TEXT, path TEXT);
sqlite> .exit
[root@yejr.me]#

然后用一个Python脚本解析所有文档页面文件，并且生成索引记录，写入到 docSet.dsidx 索引文件中。

这步的工作比较重要，因为后面我们阅读文档时，可能会搜索一些关键词，因此需要尽可能把这些关键词都写到索引文件里。

写入时，各个关键词可以分属不同的类型，常见文档中的类型几乎都支持，像CateGory、Class、Command、Constant、Function、Interface、KeyWord、Module、Namespace等，不一一列举了。

我为了图省事，写入索引时，全部都指定为Keyword了，重点是能搜索到这些关键词就好。

脚本蓝本：https://GitHub.com/drbraden/pgdash/blob/master/pgdoc2set.py

先看下解析文档的Python脚本：

[root@yejr.me]# cat dsidx.py
#!/usr/local/bin/python3
import os, re, sqlite3, sys
from bs4 importBeautifulSoup, NavigableString, Tag
try:
# 指定sqlite数据文件
db = sqlite3.connect("MySQL_Internal.docset/Contents/Resources/docSet.dsidx")
cur = db.cursor()
except:
print("Open sidx file failed, exit.")
exit
docpath = "MySQL_Internal.docset/Contents/Resources/Documents"
# 接收参数，便于逐个解析每个文件
doc = "%s"% sys.argv[1];
page = open(os.path.join(docpath, doc)).read()
soup = BeautifulSoup(page, features="html.parser")
any = re.compile(".*")
for tag in soup.find_all("a", {"href":any}):
# 删除空格及换行
name = tag.text.strip()
name = name.replace(" ","")
if len(name) > 0:
path = tag.attrs["href"].strip()
if path.split("#")[0] notin("index.html", "index.htm", "bookindex.html"):
# 插入索引记录
sql="INSERT OR IGNORE INTO searchIndex(name,type,path) VALUES ("%s","KEYWORD","%s");"%(name,path);
cur.execute(sql)
# 最后一次性批量提交
db.commit()
db.close()