开发文档 - tootal/DBLParse GitHub Wiki
DBLParse的源代码在Github上开源，可以下载代码的ZIP存档。如果希望构建历史的某个版本，推荐的方式是使用Git：
git clone [email protected]:tootal/DBLParse.git
cd DBLParse目前DBLParse对Windows平台和Ubuntu平台提供支持。
从Qt Downloads可以下载到Qt的在线安装包。此外，还可以使用下列镜像来加快下载速度：
此外，在Windows平台下还需要Visual Studio 2017或更高版本来编译DBLParse。注意Mingw版本不支持WebEngine模块。
打开Qt Creator并打开DBLParse.pro作为项目。点击菜单Build、Run即可运行（或使用快捷键Ctrl+R）。
整体架构分为前端（Web）和后端（QT），首先需要完整解析一遍dblp.xml文件，耗时约4分钟。解析部分在C++类Parser中定义，解析时显示进度的窗口使用ParseDialog类定义。解析完成后会生成若干数据文件（全部放在data文件夹下），其中保存了所有记录的哈希信息以及作者关系信息，运行时需要将部分文件加载到内存中。加载部分使用Loader类定义，加载完成后会把数据存在Finder类的成员变量中。查找时使用哈希函数定位获取到对应关键字记录所在的文件位置，再从dblp.xml文件中读取出‘记录’信息（Finder::getRecord），其中‘记录’对应的类为Record，利用Record::attr函数可以访问对应标签的内容，使用Record::toJson可以把Record转换成一个Json对象（QJsonObject）。
解析部分会在单独的线程中运行，具体来说就是先把dblp.xml文件分段读入（使用Reader类），同时按照记录分隔，同时提取出关键信息。接着使用while循环遍历所有记录，对关键信息进行处理，利用哈希函数定位到指定文件，使用Saver类进行缓存，保存到文件。
对于C++（QT）代码文件中需要翻译的字符串，使用QObject::tr函数包裹起来。例如：statusBar()->showMessage(tr("Load finished."), 3000);。
对于UI文件中的字符串，无需特殊处理。
对于HTML文件中的字符串，请在对应文本标签中加入自定义（最小化）属性tr，若无对应标签，请自行使用span标签包裹。例如：<option value="author" tr>Author</option>。
对于JS文件中的字符串，请使用全局函数tr包裹起来。例如：alertMsg('warning', tr('You can not search this title.'));。
如果需要转换JS中的字符串，请使用全局函数translate。
在Qt Creator的菜单栏中选择Tools，External，Qt语言家。首先用lupdate更新翻译文件（导出tr字符串到ts文件）。接着打开linguist（QT语言家），打开对应的ts文件，选中对应字符串进行翻译。翻译完成后，在Qt Creator中用lrelease生成qm文件。
对于HTML和JS中的字符串，在strings_开头的语言文件（js文件）中添加字符串映射即可。
后端使用Qt Creator内置的UI设计师进行界面设计。
引入前端框架Bootstrap进行布局，数据绑定部分使用Vue，图表展示使用ECharts ，使用QWebChannel与QT交互。
临时创建一个Web窗口可以使用QWebEngineView，利用load、setUrl或setHtml加载数据。若要自定义一些功能（例如拦截URL、自定义右键菜单）可以继承QWebEngineView和QWebEnginePage类。具体实现可以参考WebView和WebPage类。
若是需要JS和C++通信，可以加入QWebChannel。C++端的WebPage使用setWebChannel指定WebChannel，接着使用registerObject注册C++类（必须继承QObject），同时在希望被JS端调用的函数前加上宏定义Q_INVOKABLE；在HTML文件中引入qwebchannel.js文件（在body标签末尾加入<script src="qwebchannel.js"></script>），在脚本中引入已经注册的C++类、连接QT信号到JS函数。例如：
new QWebChannel(qt.webChannelTransport, function(channel) {
finder = channel.objects.finder;
finder.ready.connect(handleSearch);
});其中ready是C++类Finder的一个信号，handleSearch是一个JS定义的函数。此后可以在其他地方调用finder，例如执行finder.find(type, word)实质上会调用C++端的Finder::find函数。
利用JS调用C++函数（通过函数参数传递信息）以及JS端函数绑定信号（利用信号传递信息到JS函数参数中）可以实现前后端的双向交互。
注意：如果不需要动态传输数据，只需要一次性传输数据（C++传到Web）可以使用字符串替换功能处理HTML文件。
为了方便测试前端效果，在JS文件中做了特殊的处理，使得前端文件支持本地打开（利用location.href判断）。在浏览器中打开HTML文件会自动加载对应的测试文件*.test.js。
目前支持的本地测试数据记录如下：
作者名：Katja Lenz
标题：The Conjunctive Complexity of Quadratic Boolean Functions.
禁用标题：Home Page
完整的测试数据和测试命令可查看index.test.js文件。
以下是常见的测试方式：
- 直接输入测试数据。
- 在浏览器控制台中输入
test.author、test.title、test.homepage等命令，测试对应结果的样式。 - 在浏览器控制台中输入
language='en'、language='zh'测试翻译是否正确。 - 在JS文件中加入上述命令来自动执行。
详细构建过程可以参考script文件夹下的构建脚本。
在Release模式下构建，将构建好的exe文件复制到一个单独的文件夹中。
在Qt 5.14.2 (MSVC 2017 64-bit)命令行工具下进入该文件夹，执行命令windeployqt DBLParse.exe，即可。