快速开始
========

这是 ``/zh-CN/`` 文档树下的中文快速开始页。

安装与构建
----------

.. code-block:: sh

   cmake -S . -B build
   cmake --build build
   cmake --install build --prefix install

顶层构建默认启用 ``BUILD_CLI``，因此会构建 ``featherdoc_cli``。如果只需要库，
可以显式传入 ``-DBUILD_CLI=OFF``。

PDF 支持仍是实验性、显式开启的能力。只有在需要 PDF 工作流页面和 CLI 入口时，
才构建 ``FEATHERDOC_BUILD_PDF`` 和 ``FEATHERDOC_BUILD_PDF_IMPORT``。

最小 C++ 用法
-------------

.. code-block:: cpp

   #include <featherdoc.hpp>

   int main() {
       featherdoc::Document doc{"input.docx"};
       if (doc.open()) {
           return 1;
       }

       doc.paragraphs().add_run("Generated by FeatherDoc");
       return doc.save_as("output.docx") ? 1 : 0;
   }

下一步阅读
----------

* :doc:`api/document`：了解 ``Document`` 如何打开、保存、检查和修改文档。
* :doc:`word_document_workflow`：按任务阅读 Word 文档生成、填充、审阅和批量编辑流程。
* :doc:`api/paragraph_run`：查看段落与 run API。
* :doc:`api/table`：查看表格、行和单元格 API。
* :doc:`api/template_part`：查看书签、内容控件、模板槽位和 schema 校验 API。
* :doc:`api/pdf_workflow`：查看实验性 PDF 导入导出工作流。