4. 目录设计

4.1 根据标题级别生成目录

def cluster_overview(self):
        """生成内容"""
        # 一级目录
        self.add_heading('项目介绍', level=1)
        # 二级目录
        self.add_heading('关于', level=2)
        self.add_paragraph(
            "$easypdf$ 是我在基于ReportLab PDF库进行修改。"
            "项目产生来源于我在工作自动化运维巡检一键生成PDF巡检报告。刚开始我也在百度、"
            "谷歌找的自动化生成PDF的资料，发现这方面的知识非常零散和知识不全面，教程基本都是用ReportLab"
            "库进行一些简单的文本和绘图操作，没有一个完整的文档功能设计。所以我决定深挖，用时接近一个月的时间，"
            "设计了一套拥有可定制的封面；自动生成的目录；可选择的样式、文本；可插入多种类型的图表和插图，这些功能使用非常便捷,"
            "只需要通过调用相应的方法，传入数据执行既可以生成。在前期消耗巨大的时间成本和人力成本情况下，我决定干脆再做个教程,"
            "精心编纂知识手册，并录制详尽的视频教程，以合理的价格分享给每一位追求进步的伙伴。",
            style=self.stylesheet[constant.STYLE_COMMENT])
        self.add_heading('easypdf 有什么优势？', level=2)
        self.add_bullet("简单易用，功能模块化：不用想着从零开始设计封面、模板")
        self.add_bullet("功能齐全完整，拥有pdf文档：满足各类复杂的文本、图表和插图操作")
        self.add_bullet("可定制化性强，可以自行重写方法满足需求")
        self.add_bullet("可移植性强，可以打包成可执行文件在linux和windows上运行")
        self.add_bullet("提高生产效率， 减少了手动重复操作的需求，如排版、格式调整多个文档等")
        self.add_bullet("符合相应的SOP标准流程规范，确保文档都遵循统一的格式和标准")
        self.add_bullet("减少错误和遗漏，自动化生成pdf流程通过减少人为干预来降低错误率")

        self.add_heading('easypdf 可以用来做什么？', level=2)
        self.add_paragraph("easypdf 自动化生成PDF可以用来快速、准确地创建标准化的电子文档，"
                           "用于各种业务场景下的信息共享、报告制作等，提高工作效率和文档一致性。",
                           style=self.stylesheet[constant.STYLE_COMMENT])
        self.add_paragraph("easypdf至少在以下业务场景下有用：",
                           style=self.stylesheet[constant.STYLE_COMMENT])
        self.add_bullet("数据分析报告")
        self.add_bullet("运维巡检报告")
        self.add_bullet("资源统计报告")
        self.add_bullet("性能测试报告")
        self.add_bullet("其它应用场景")
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.

self.add_heading 方法有3个参数：
第一个参数是目录标题文本
第二个参数是目录级别
第三个参数是目录字体设计，这里我用的是STYLE_COMMENT
self.add_bullet 方法是插入列表文本。
self.add_paragraph 方法是插入文本，下一章会讲