【亲测免费】 DuckX 项目使用教程

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

DuckX 是一个用于创建和编辑 Microsoft Word (docx) 文件的 C++ 库。以下是项目的目录结构及其介绍：

DuckX/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── include/
│   └── duckx/
│       └── duckx.hpp
├── src/
│   ├── document.cpp
│   ├── paragraph.cpp
│   ├── run.cpp
│   └── ...
├── examples/
│   ├── example1.cpp
│   ├── example2.cpp
│   └── ...
└── tests/
    ├── test1.cpp
    ├── test2.cpp
    └── ...

• CMakeLists.txt: 用于构建项目的 CMake 配置文件。
• LICENSE: 项目的许可证文件，MIT 许可证。
• README.md: 项目的基本介绍和使用说明。
• include/duckx/: 包含库的头文件。
• src/: 包含库的源代码文件。
• examples/: 包含使用库的示例代码。
• tests/: 包含测试代码。

2. 项目的启动文件介绍

项目的启动文件通常是指示例代码中的 main 函数所在的文件。以下是一个示例启动文件 example1.cpp 的内容：

#include <iostream>
#include <duckx/duckx.hpp>

int main() {
    duckx::Document doc("file.docx");
    doc.open();
    for (auto p : doc.paragraphs()) {
        for (auto r : p.runs()) {
            std::cout << r.get_text() << std::endl;
        }
    }
    return 0;
}

这个示例代码打开一个名为 file.docx 的 Word 文档，并遍历其中的段落和文本运行，输出每个文本运行的内容。

3. 项目的配置文件介绍

DuckX 项目的配置文件主要是 CMakeLists.txt，它用于配置和构建项目。以下是 CMakeLists.txt 的部分内容：

cmake_minimum_required(VERSION 3.10)
project(DuckX)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

include_directories(include)

file(GLOB SRC_FILES src/*.cpp)
add_library(duckx ${SRC_FILES})

add_executable(example1 examples/example1.cpp)
target_link_libraries(example1 duckx)

• cmake_minimum_required(VERSION 3.10): 指定所需的最低 CMake 版本。
• project(DuckX): 定义项目名称。
• set(CMAKE_CXX_STANDARD 11): 设置 C++ 标准为 C++11。
• include_directories(include): 包含头文件目录。
• file(GLOB SRC_FILES src/*.cpp): 收集源文件。
• add_library(duckx ${SRC_FILES}): 创建库目标。
• add_executable(example1 examples/example1.cpp): 创建可执行文件目标。
• target_link_libraries(example1 duckx): 链接库到可执行文件。

通过这些配置，可以编译和运行示例代码，从而使用 DuckX 库来创建和编辑 Word 文档。