介绍reportlab里面的TableOfContents详细用法

reportlab是Python中一个非常流行的PDF生成库，TableOfContents是其中一个重要的模块，用于生成页面目录。

使用TableOfContents生成目录的主要步骤如下：

1. 导入reportlab库中的TableOfContents和Paragraph对象。

from reportlab.platypus import TableOfContents, Paragraph

2. 初始化TableOfContents对象，并指定其样式。

toc = TableOfContents()
toc.levelStyles = [
    # 一级标题的样式
    ('LEVEL1', 14, 'bold'),
    # 二级标题的样式
    ('LEVEL2', 12, 'bold'),
    # 三级标题的样式
    ('LEVEL3', 11, 'italic'),
]

3. 遍历文档中的所有标题，将其添加到TableOfContents对象中。

# 遍历文档中的所有段落
for para in paragraphs:
    # 如果该段落是标题
    if para.style.name.startswith('Heading'):
        # 获取标题级别和标题文本
        level = int(para.style.name[-1])
        text = para.text.strip()
        # 将标题添加到TableOfContents对象中
        toc.addEntry(level, text, len(page_list))

4. 在PDF文档中插入目录。

# 将TableOfContents对象添加到PDF文档中
elements.append(toc)
# 在目录之后添加文档内容
elements.extend(page_list)

完整的TableOfContents示例代码如下：

from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer
from reportlab.platypus.tableofcontents import TableOfContents
from reportlab.lib.styles import getSampleStyleSheet

# 创建PDF文档
doc = SimpleDocTemplate('example.pdf')
elements = []

# 添加标题和段落
styles = getSampleStyleSheet()
title = Paragraph('Example Document', styles['h1'])
elements.append(title)
elements.append(Spacer(1, 12))

text = 'This is a paragraph. ' * 20
para1 = Paragraph(text, styles['Normal'])
elements.append(para1)
elements.append(Spacer(1, 12))

# 初始化TableOfContents对象
toc = TableOfContents()
toc.levelStyles = [
    ('LEVEL1', 14, 'bold'),
    ('LEVEL2', 12, 'bold'),
    ('LEVEL3', 11, 'italic'),
]

# 遍历文档中的所有段落，将标题添加到TableOfContents对象中
paragraphs = [title, para1]
for para in paragraphs:
    if para.style.name.startswith('Heading'):
        level = int(para.style.name[-1])
        text = para.text.strip()
        toc.addEntry(level, text, len(elements))

# 将TableOfContents对象添加到PDF文档中
elements.append(toc)

# 在目录之后添加文档内容
para2 = Paragraph(text, styles['Normal'])
elements.append(para2)
elements.append(Spacer(1, 12))

# 生成PDF文档
doc.build(elements)

运行以上代码，将会生成一个包含目录的PDF文档。