zshelf 项目使用教程

zshelf 项目使用教程

zshelfreMarkable app: Browse and download books from Z-Library项目地址:https://gitcode.com/gh_mirrors/zs/zshelf

1. 项目的目录结构及介绍

zshelf 项目的目录结构如下：

zshelf/
├── backend/
├── fonts/
├── qml/
├── quickvirtualkeyboard/
├── .gitignore
├── LICENSE
├── README.md
├── config.json
├── dist.sh
├── grayImage.h
├── main.cpp
├── qml.qrc
├── store.cpp
├── store.h
├── worker.h
└── zshelf_pro

目录介绍

• backend/: 包含项目的后端代码。
• fonts/: 包含项目使用的字体文件。
• qml/: 包含项目的 QML 文件。
• quickvirtualkeyboard/: 包含虚拟键盘的 QML 文件。
• .gitignore: Git 忽略文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• config.json: 项目配置文件。
• dist.sh: 分发脚本。
• grayImage.h: 灰度图像处理头文件。
• main.cpp: 项目主程序文件。
• qml.qrc: QML 资源文件。
• store.cpp: 存储处理源文件。
• store.h: 存储处理头文件。
• worker.h: 工作线程头文件。
• zshelf_pro: 项目主程序文件。

2. 项目的启动文件介绍

项目的启动文件是 main.cpp。该文件负责初始化应用程序并启动主界面。以下是 main.cpp 的简要介绍：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include "store.h"
#include "worker.h"

int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;

    // 初始化存储和工作线程
    Store store;
    Worker worker;

    // 加载 QML 文件
    engine.load(QUrl(QStringLiteral("qrc:/qml/main.qml")));

    return app.exec();
}

启动文件功能

• 初始化 QGuiApplication 和 QQmlApplicationEngine。
• 初始化 Store 和 Worker 类。
• 加载主 QML 文件 main.qml。
• 启动应用程序事件循环。

3. 项目的配置文件介绍

项目的配置文件是 config.json。该文件包含了项目运行所需的配置信息。以下是 config.json 的简要介绍：

{
    "domain": "https://z-lib.org",
    "cookie": {
        "remix_userkey": "your_user_key",
        "remix_userid": "your_user_id"
    },
    "additionalBookLocation": "/path/to/additional/books"
}

配置文件字段

• domain: Z-Library 的域名。
• cookie: 包含 remix_userkey 和 remix_userid 的 Cookie 信息。
• additionalBookLocation: 额外的书籍存储路径。

配置文件使用

在启动项目之前，需要手动配置 config.json 文件中的 domain 和 cookie 信息，以便项目能够正确地从 Z-Library 下载书籍。

nano /opt/etc/zshelf/config.json

编辑完成后，保存文件并启动项目：

zshelf

以上是 zshelf 项目的使用教程，包含了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。

zshelfreMarkable app: Browse and download books from Z-Library项目地址:https://gitcode.com/gh_mirrors/zs/zshelf