Python 导出 PDF（ReportLab ）

在 Python 中导出 PDF 文件，你可以使用多种库，其中最流行的是 ReportLab 和 FPDF。下面我将分别介绍如何使用这两个库来生成 PDF 文件。

官网：https://docs.reportlab.com/
英文手册：https://docs.reportlab.com/reportlab/userguide/ch1_intro/
中文手册：https://gitcode.com/Open-source-documentation-tutorial/d25f8/blob/main/reportlab%E4%B8%AD%E6%96%87%E6%89%8B%E5%86%8C.pdf

1. ReportLab 使用

参考：
https://www.cnblogs.com/windfic/p/17157841.html

https://dev59.com/uF7Va4cB1Zd3GeqPKod0
https://www.jb51.net/article/270782.htm
https://www.osgeo.cn/python-tutorial/pdf-reportlab.html
https://blog.51cto.com/u_14940497/12374520
https://blog.csdn.net/qq_40596572/article/details/102896520
https://www.cnblogs.com/jilingxf/p/15857940.html

1.1. 安装 ReportLab

可以通过pip安装：

pip install reportlab

1.2. 创建 PDF 文件

下面是一个简单的示例，展示如何使用 ReportLab 创建一个包含文本和图像的 PDF 文件：

from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import letter
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.pdfbase import pdfmetrics# 注册字体
song = "simsun"
pdfmetrics.registerFont(TTFont(song, "simsun.ttc"))
# pdfmetrics.registerFont(TTFont('MyFont', 'path/to/your/font.ttf'))# 创建一个PDF文件
c = canvas.Canvas("example.pdf", pagesize=letter)
c.setFont('simsun', 12)# 添加文本
# 默认情况下，(0,0)原点在页面的左下角。 此外，第一个坐标x往右走，第二个坐标y往上走，这是默认的。
c.drawString(10, 10, "Hello World!")# # 添加图像
c.drawImage('./image.jpg', 10, 60, width=500, height=500)# 保存PDF文件
c.save()

1.3. 使用文档模板 DocTemplate

Reportlab 的基础使用方式是创建内容块（Flowable），再使用文档模板（DocTemplate）创建 Pdf 文档。
关注点：
Paragraph（段落）、
Image（图像）、
Table（表格）、
VerticalBarChart（柱形图表）

from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFontfrom reportlab.lib.styles import getSampleStyleSheet
from reportlab.platypus import Paragraph, SimpleDocTemplate, Image, Table
from reportlab.platypus import Spacer
from reportlab.graphics.shapes import Drawing
from reportlab.graphics.charts.barcharts import VerticalBarChart
from reportlab.graphics.charts.legends import Legend
from reportlab.lib import  colors
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import cmdef draw_text(st, text: str):return Paragraph(text, st)def draw_img(path):img = Image(path)       # 读取指定路径下的图片img.drawWidth = 6*cm    # 设置图片的宽度img.drawHeight = 5*cm   # 设置图片的高度return imgdef draw_table(*args):col_width = 120style = [('FONTNAME', (0, 0), (-1, -1), 'song'),  # 字体('FONTSIZE', (0, 0), (-1, 0), 12),  # 第一行的字体大小('FONTSIZE', (0, 1), (-1, -1), 10),  # 第二行到最后一行的字体大小('BACKGROUND', (0, 0), (-1, 0), '#d5dae6'),  # 设置第一行背景颜色('ALIGN', (0, 0), (-1, -1), 'CENTER'),  # 第一行水平居中('ALIGN', (0, 1), (-1, -1), 'LEFT'),  # 第二行到最后一行左右左对齐('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),  # 所有表格上下居中对齐('TEXTCOLOR', (0, 0), (-1, -1), colors.darkslategray),  # 设置表格内文字颜色('GRID', (0, 0), (-1, -1), 0.5, colors.grey),  # 设置表格框线为grey色，线宽为0.5('SPAN', (0, 1), (2, 1)),  # 合并第二行一二三列]table = Table(args, colWidths=col_width, style=style)return tabledef draw_bar(bar_data: list, ax: list, items: list):drawing = Drawing(500, 200)bc = VerticalBarChart()bc.x = 45       # 整个图表的x坐标bc.y = 45      # 整个图表的y坐标bc.height = 150     # 图表的高度bc.width = 350      # 图表的宽度bc.data = bar_databc.strokeColor = colors.black       # 顶部和右边轴线的颜色bc.valueAxis.valueMin = 0           # 设置y坐标的最小值bc.valueAxis.valueMax = 20         # 设置y坐标的最大值bc.valueAxis.valueStep = 5         # 设置y坐标的步长bc.categoryAxis.labels.dx = 2bc.categoryAxis.labels.dy = -8bc.categoryAxis.labels.angle = 20bc.categoryAxis.labels.fontName = 'song'bc.categoryAxis.categoryNames = ax# 图示leg = Legend()leg.fontName = 'song'leg.alignment = 'right'leg.boxAnchor = 'ne'leg.x = 475         # 图例的x坐标leg.y = 140leg.dxTextSpace = 10leg.columnMaximum = 3leg.colorNamePairs = itemsdrawing.add(leg)drawing.add(bc)return drawingdef main(filename):pdfmetrics.registerFont(TTFont('song', 'STSONG.ttf'))style = getSampleStyleSheet()ts = style['Heading1']ts.fontName = 'song'    # 字体名ts.fontSize = 18        # 字体大小ts.leading = 30         # 行间距ts.alignment = 1        # 居中ts.bold = Truehs = style['Heading2']hs.fontName = 'song'    # 字体名hs.fontSize = 15        # 字体大小hs.leading = 20         # 行间距hs.textColor = colors.red  # 字体颜色ns = style['Normal']ns.fontName = 'song'ns.fontSize = 12ns.wordWrap = 'CJK'     # 设置自动换行ns.alignment = 0        # 左对齐ns.firstLineIndent = 32 # 第一行开头空格ns.leading = 20content = []content.append(draw_text(ts, '经典游戏盘点'))content.append(draw_img('./image.jpg'))content.append(Spacer(1, 1*cm))content.append(draw_text(ns, ' 《超级马里奥兄弟》于1985年9月13日发售，这是一款任天堂针对FC主机全力度身订造的游戏，被称为TV游戏奠基之作。这个游戏被赞誉为电子游戏的原始范本，确立了角色、游戏目的、流程分布、操作性、隐藏要素、BOSS、杂兵等以后通用至今的制作概念。《超级马里奥兄弟》成为游戏史首部真正意义上的超大作游戏，游戏日本本土销量总计681万份，海外累计更是达到了3342万份的天文数字。'))content.append(draw_text(hs, '经典游戏列表'))# 添加表格data = [('经典游戏', '发布年代', '发行商'),('TOP100',),('超级马里奥兄弟', '1985年', '任天堂'),('坦克大战', '1985年', '南梦宫'),('魂斗罗', '1987年', '科乐美'),('松鼠大战', '1990年', '卡普空'),]content.append(draw_table(*data))# 生成图表content.append(draw_text(hs, '游戏厂商统计'))b_data = [(2, 4, 6, 12, 8, 16), (12, 14, 17, 9, 12, 7)]ax_data = ['任天堂', '南梦宫', '科乐美', '卡普空', '世嘉', 'SNK']leg_items = [(colors.red, '街机'), (colors.green, '家用机')]content.append(draw_bar(b_data, ax_data, leg_items))# 生成pdf文件doc = SimpleDocTemplate(filename, pagesize=A4, topMargin=35)doc.build(content)if __name__ == '__main__':main(filename='example1.pdf')

1.4. 使用页面模板 PageTemplate

上述的排版都是线性的，如果要有一些混排，比如列式排版，可以使用BalancedColumns，有一些页面排版比较复杂，那可以使用页面模板（PageTemplate）。
其实还可以用传统Web艺能——Table来做排版，我试了一下，只需要指定BOX，GRID为白色即可，线宽为0不行。
关注点：
PageTemplate（页面模板）
Frame（框架）

from reportlab.lib.colors import Color
from reportlab.lib.pagesizes import A4
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.lib.units import cm
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.pdfgen import canvas
from reportlab.lib import  colors
from reportlab.platypus import BaseDocTemplate, Frame, Paragraph, NextPageTemplate, PageBreak, PageTemplate, Image
from reportlab.lib.units import inchdef draw_text(st, text: str):return Paragraph(text, st)def draw_img(path):img = Image(path)       # 读取指定路径下的图片img.drawWidth = 5*cm    # 设置图片的宽度img.drawHeight = 4*cm   # 设置图片的高度return imgdef main(filename):# pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))pdfmetrics.registerFont(TTFont('simsun', "simsun.ttc"))style = getSampleStyleSheet()ts = style['Heading1']ts.fontName = 'simsun'      # 字体名ts.fontSize = 18            # 字体大小ts.leading = 30             # 行间距ts.alignment = 1            # 居中ts.bold = Truehs = style['Heading2']hs.fontName = 'simsun'      # 字体名hs.fontSize = 15            # 字体大小hs.leading = 20             # 行间距hs.textColor = colors.red   # 字体颜色ns = style['Normal']ns.fontName = 'simsun'ns.fontSize = 12ns.wordWrap = 'CJK'     # 设置自动换行ns.alignment = 0        # 左对齐ns.firstLineIndent = 32 # 第一行开头空格ns.leading = 20doc = BaseDocTemplate(filename, showBoundary=0, pagesize=A4)frameT = Frame(doc.leftMargin, doc.bottomMargin, doc.width, doc.height, id='normal')# 一分为三w = doc.width / 3# 高度等于宽度h = w# 上面一行 底部bm = doc.height - h# 上面一行 左列frame1 = Frame(doc.leftMargin,      bm, w,           h, id='col1')# 上面一行 右列frame2 = Frame(doc.leftMargin + w,  bm, doc.width-w, h, id='col2')# 下面一行frame3 = Frame(doc.leftMargin, doc.bottomMargin, doc.width , bm-doc.topMargin, id='col3')doc.addPageTemplates([PageTemplate(id='TwoCol', frames=[frame1, frame2, frame3]),PageTemplate(id='OneCol', frames=frameT),])elements = []#### 适配 PageTemplate TwoCol# 上面一行 左列elements.append(draw_img("./image.jpg"))# 上面一行 右列elements.append(draw_text(ns, '11111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111 。'))elements.append(draw_text(ns, '22222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222 。'))elements.append(draw_text(ns, '33333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333 。'))#### 适配 PageTemplate OneColelements.append(NextPageTemplate('OneCol'))# 强制换页elements.append(PageBreak())elements.append(draw_text(ns, "Frame one column, 44444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444 。"))#### 适配 PageTemplate TwoColelements.append(NextPageTemplate('TwoCol'))elements.append(PageBreak())elements.append(draw_img("./image.jpg"))elements.append(draw_text(ns, '55555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555 。'))elements.append(draw_img("./image.jpg"))elements.append(draw_text(ns, '55555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555555 。'))doc.build(elements)if __name__ == '__main__':main(filename='example2.pdf')

1.5. 继承 BaseDocTemplate

前两种方式都不能精确输出，依赖于模板的排版，精确输出需要Canvas接口。
如果你要在每一页上显示页眉和页脚，那么你可以继承文档模板（BaseDocTemplate）。
如果你要添加目录索引，这就是最方便的方式。
覆盖接口：
handle_documentBegin
handle_pageBegin
handle_pageEnd
handle_frameBegin
handle_frameEnd
handle_flowable
handle_nextPageTemplate
handle_currentFrame
handle_nextFrame
或者实现回调函数：
afterInit
beforeDocument
beforePage
afterPage
filterFlowables
afterFlowable
关注点：
BaseDocTemplate（文档模板）
bookmarkPage（书签）
addOutlineEntry（大纲）

from reportlab.lib.styles import ParagraphStyle
from reportlab.platypus import PageBreak
from reportlab.platypus.paragraph import Paragraph
from reportlab.platypus.doctemplate import PageTemplate, BaseDocTemplate
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.platypus.frames import Frame
from reportlab.lib.units import cmclass MyDocTemplate(BaseDocTemplate):def __init__(self, filename, **kw):self.allowSplitting = 0BaseDocTemplate.__init__(self, filename, **kw)template = PageTemplate('normal', [Frame(2.5*cm, 2.5*cm, 15*cm, 25*cm, id='F1')])self.addPageTemplates(template)self.chapter = 0self.section = 0def afterFlowable(self, flowable):if isinstance(flowable, Paragraph):text = flowable.getPlainText()style = flowable.style.nameif style == 'Title':self.chapter += 1# # 书签# self.canv.bookmarkPage(f"chapter{self.chapter}")# # 大纲# self.canv.addOutlineEntry(f"Chapter {self.chapter}", f"chapter{self.chapter}", level=0)# 书签 参数为索引（个人理解）self.canv.bookmarkPage(f"chapter{self.chapter}")# self.canv.bookmarkPage(key=)# 目录 参数为 标题、索引、层级self.canv.addOutlineEntry(text, f"chapter{self.chapter}", level=0)# self.canv.addOutlineEntry(title=, key=, level=)elif style == 'Heading1':self.section += 1self.canv.bookmarkPage(f"section{self.section}")self.canv.addOutlineEntry(f"Section {self.section}", f"section{self.section}", level=1)def main(filename):# pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))pdfmetrics.registerFont(TTFont('simsun', "simsun.ttc"))ts = ParagraphStyle(name = 'Title',fontName = 'simsun',fontSize = 22,leading = 16,alignment = 1,spaceAfter = 20)h1 = ParagraphStyle(name = 'Heading1',fontSize = 14,leading = 16)story = []story.append(Paragraph('继承BaseDocTemplate', ts))story.append(Paragraph('Section 1', h1))story.append(Paragraph('Text in Section 1.1'))# 分页story.append(PageBreak())story.append(Paragraph('Section 2', h1))story.append(Paragraph('Text in Section 1.2'))# 分页story.append(PageBreak())story.append(Paragraph('Chapter 2', ts))story.append(Paragraph('Section 1', h1))story.append(Paragraph('Text in Section 2.1'))doc = MyDocTemplate(filename)doc.build(story)if __name__ == '__main__':main(filename='example3.pdf')

1.6. 使用 SimpleDocTemplate

SimpleDocTemplate就是继承BaseDocTemplate的一种简单实现，它覆盖了接口handle_pageBegin，重载了build接口。
它把页面分成两种：首页和后续页，对应回调两个过程onFirstPage=, onLaterPages=，只需要实现这两个回调过程即可。
适用显示页眉和页脚，其它的功能就有限了。
关注点：
SimpleDocTemplate（文档模板）
QrCode（二维码）
drawOn（显示Flowable）

from reportlab.platypus import SimpleDocTemplate, Paragraph
from reportlab.platypus import PageBreak
from reportlab.lib.styles import ParagraphStyle
from reportlab.lib.colors import Color
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import mm
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.graphics.barcode import qr#首页
def myFirstPage(canvas, doc):canvas.saveState()canvas.setFillColorRGB(0, 0, 0)canvas.setFont('simsun',12)str="（内部资料）"canvas.drawCentredString(doc.width/2, 25*mm, str)myLaterPages(canvas, doc)canvas.restoreState()#页眉页脚
def myLaterPages(canvas, doc):canvas.saveState()canvas.setStrokeColorRGB(0.8, 0.8, 0.8)canvas.line(0, 32, doc.width, 32)canvas.line(0, A4[1]-45, doc.width, A4[1]-45)canvas.setFillColorRGB(0, 0, 0)canvas.setFont('simsun',10)str=f"Page {doc.page}"canvas.drawCentredString(doc.width/2, 5*mm, str)canvas.setFillColorRGB(1, 0, 0)canvas.drawCentredString(doc.width/2, A4[1]-9*mm, "XX有限公司版权所有")qr_code = qr.QrCode('https://www.cnblogs.com/windfic', width=45, height=45)canvas.setFillColorRGB(0, 0, 0)qr_code.drawOn(canvas, 0, A4[1]-45)canvas.restoreState()def main(filename):# pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))pdfmetrics.registerFont(TTFont('simsun', "simsun.ttc"))doc = SimpleDocTemplate(filename, pagesize=A4, leftMargin=10, rightMargin=10)title = ParagraphStyle(name = 'Title',fontName = 'simsun',fontSize = 22,leading = 16,alignment = 1,spaceAfter = 20)contents = []contents.append(Paragraph('使用SimpleDocTemplate', title))contents.append(Paragraph('Hello'))contents.append(PageBreak())contents.append(Paragraph('World'))contents.append(PageBreak())contents.append(Paragraph('World2'))doc.build(contents, onFirstPage=myFirstPage, onLaterPages=myLaterPages)if __name__ == '__main__':main(filename='example4.pdf')

1.7. 继承Canvas

控制Canvas的另一种方法是继承Canvas。
与继承文档模板（DocTemplate）类似，不过网上能找到的例子也就是显示页码，不是很实用。

from reportlab.platypus import SimpleDocTemplate, Image, Paragraph, PageBreak
from reportlab.pdfgen import canvas
from reportlab.lib.units import mm
from reportlab.lib.colors import Color
from reportlab.lib.pagesizes import A4
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.lib.styles import ParagraphStyleclass NumberedCanvas(canvas.Canvas):def __init__(self, *args, **kwargs):canvas.Canvas.__init__(self, *args, **kwargs)self._saved_page_states = []def showPage(self):self._saved_page_states.append(dict(self.__dict__))self._startPage()def save(self):"""add page info to each page (page x of y)"""num_pages = len(self._saved_page_states)for state in self._saved_page_states:self.__dict__.update(state)self.draw_page_number(num_pages)canvas.Canvas.showPage(self)canvas.Canvas.save(self)def draw_page_number(self, page_count):self.setFont("Helvetica", 9)self.setStrokeColor(Color(0, 0, 0, alpha=0.5))self.line(10*mm, 15*mm, A4[0] - 10*mm, 15*mm)self.setFillColor(Color(0, 0, 0, alpha=0.5))self.drawCentredString(A4[0]/2, 10*mm, "Page %d of %d" % (self._pageNumber, page_count))def main(filename):# pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))pdfmetrics.registerFont(TTFont('simsun', "simsun.ttc"))title = ParagraphStyle(name = 'Title',fontName = 'simsun',fontSize = 22,leading = 16,alignment = 1,spaceAfter = 20)image = Image("image.jpg")image.drawWidth = 160# image.drawHeight = 160*(image.imageHeight/image.imageWidth)# image.drawHeight = 160*(image.imageWidth/image.imageHeight)image.drawHeight = 160elements = [Paragraph('继承Canvas', title),Paragraph("Hello"),image,PageBreak(),Paragraph("world"),PageBreak(),image,]doc = SimpleDocTemplate(filename)doc.build(elements, canvasmaker=NumberedCanvas)if __name__ == "__main__":main(filename='example5.pdf')

1.8. 直接使用Canvas

当PDF内容非常复杂，难以用以上的方法实现，可以直接使用Canvas创建PDF
直接使用Canvas类，可以精确输出，但需要自己排版，而且它的坐标原点在左下角。
其中也可以放置Flowable，需要排版的Flowable，如Table等，调用warp函数即可自动排版。
如果是内容已经排版的格式转换程序，非常推荐使用这种方式。

from reportlab.pdfgen import canvas
from reportlab.platypus import Image, Table
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import mm
from reportlab.lib.colors import Color
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
from reportlab.lib import  colors
from reportlab.graphics.shapes import Drawing
from reportlab.graphics.charts.barcharts import VerticalBarChart
from reportlab.graphics.charts.legends import Legend
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.platypus import Paragraph
from reportlab.graphics.barcode import qrdef draw_bar(bar_data: list, ax: list, items: list):drawing = Drawing(500, 200)bc = VerticalBarChart()bc.x = 45           # 整个图表的x坐标bc.y = 45           # 整个图表的y坐标bc.height = 150     # 图表的高度bc.width = 350      # 图表的宽度bc.data = bar_databc.strokeColor = colors.black       # 顶部和右边轴线的颜色bc.valueAxis.valueMin = 0           # 设置y坐标的最小值bc.valueAxis.valueMax = 20          # 设置y坐标的最大值bc.valueAxis.valueStep = 5          # 设置y坐标的步长bc.categoryAxis.labels.dx = 2bc.categoryAxis.labels.dy = -8bc.categoryAxis.labels.angle = 20bc.categoryAxis.labels.fontName = 'simsun'bc.categoryAxis.categoryNames = ax# 图示leg = Legend()leg.fontName = 'simsun'leg.alignment = 'right'leg.boxAnchor = 'ne'leg.x = 475         # 图例的x坐标leg.y = 140leg.dxTextSpace = 10leg.columnMaximum = 3leg.colorNamePairs = itemsdrawing.add(leg)drawing.add(bc)return drawingdef draw_table(*args):col_width = 120style = [('FONTNAME', (0, 0), (-1, -1), 'simsun'),  # 字体('FONTSIZE', (0, 0), (-1, 0), 12),  # 第一行的字体大小('FONTSIZE', (0, 1), (-1, -1), 10),  # 第二行到最后一行的字体大小('BACKGROUND', (0, 0), (-1, 0), '#d5dae6'),  # 设置第一行背景颜色('ALIGN', (0, 0), (-1, -1), 'CENTER'),  # 第一行水平居中('ALIGN', (0, 1), (-1, -1), 'LEFT'),  # 第二行到最后一行左右左对齐('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),  # 所有表格上下居中对齐('TEXTCOLOR', (0, 0), (-1, -1), colors.darkslategray),  # 设置表格内文字颜色('GRID', (0, 0), (-1, -1), 0.5, colors.grey),  # 设置表格框线为grey色，线宽为0.5('SPAN', (0, 1), (2, 1)),  # 合并第二行一二三列]table = Table(args, colWidths=col_width, style=style)return tabledef draw_page_number(c, page, count):c.setFillColorRGB(1, 0, 0)c.setFont("simsun", 9)c.drawCentredString(A4[0]/2, A4[1]-9*mm, "XX有限公司版权所有")qr_code = qr.QrCode('https://www.cnblogs.com/windfic', width=45, height=45)c.setFillColorRGB(0, 0, 0)qr_code.drawOn(c, 0, A4[1]-45)c.line(10*mm, A4[1]-45, A4[0], A4[1]-45)c.setFont("simsun", 9)c.setStrokeColor(Color(0, 0, 0, alpha=0.5))c.line(10*mm, 15*mm, A4[0] - 10*mm, 15*mm)c.setFillColor(Color(0, 0, 0, alpha=0.5))c.drawCentredString(A4[0]/2, 10*mm, "Page %d of %d" % (page, count))def main(filename):# pdfmetrics.registerFont(TTFont('微软雅黑', 'msyh.ttf'))pdfmetrics.registerFont(TTFont('simsun', "simsun.ttc"))c = canvas.Canvas(filename)c.bookmarkPage("title")c.addOutlineEntry("my book", "title", level=0)c.setFont("simsun", 16)c.setFillColor(Color(0, 0, 1, alpha=0.9))c.drawString(320, A4[1] - 95, "超级马里奥兄弟")c.setFont("simsun", 12)c.setFillColor(Color(0, 0, 0, alpha=0.7))c.drawString(320, A4[1] - 125, "SUPER MARIO BROS.")c.drawString(320, A4[1] - 195, "1985年9月13日发售")img = Image("./image.jpg")img.drawWidth = 160# img.drawHeight = 160*(img.imageHeight/img.imageWidth)# img.drawHeight = int(160*(img.imageHeight/img.imageWidth))img.drawHeight = 160# print("image", img.imageHeight, img.imageWidth, (img.imageHeight/img.imageWidth), 160*(img.imageHeight/img.imageWidth), img.drawHeight)img.drawOn(c, 150, A4[1]-200)data = [('经典游戏', '发布年代', '发行商'),('TOP100',),('超级马里奥兄弟', '1985年', '任天堂'),('坦克大战', '1985年', '南梦宫'),('魂斗罗', '1987年', '科乐美'),('松鼠大战', '1990年', '卡普空'),]t = draw_table(*data)t.wrap(800, 600)t.drawOn(c, 50, A4[1] - 400)styleSheet = getSampleStyleSheet()style = styleSheet['BodyText']style.fontName = "simsun"p=Paragraph(' 《超级马里奥兄弟》于1985年9月13日发售，这是一款任天堂针对FC主机全力度身订造的游戏，被称为TV游戏奠基之作。这个游戏被赞誉为电子游戏的原始范本，确立了角色、游戏目的、流程分布、操作性、隐藏要素、BOSS、杂兵等以后通用至今的制作概念。《超级马里奥兄弟》成为游戏史首部真正意义上的超大作游戏，游戏日本本土销量总计681万份，海外累计更是达到了3342万份的天文数字。',style)p.wrap(A4[0]-100, 100)p.drawOn(c, 50, A4[1] - 280)b_data = [(2, 4, 6, 12, 8, 16), (12, 14, 17, 9, 12, 7)]ax_data = ['任天堂', '南梦宫', '科乐美', '卡普空', '世嘉', 'SNK']leg_items = [(colors.red, '街机'), (colors.green, '家用机')]d = draw_bar(b_data, ax_data, leg_items)d.drawOn(c, 50, A4[1] - 620)draw_page_number(c, 1, 2)c.bookmarkPage("section1")c.addOutlineEntry("first section", "section1", level=1)c.showPage()c.drawString(50, A4[1] - 70, "World")draw_page_number(c, 2, 2)c.bookmarkPage("section2")c.addOutlineEntry("second section", "section2", level=1)c.showPage()c.showOutline()c.save()if __name__ == "__main__":main(filename='example6.pdf')

2. 字体与编码

https://blog.csdn.net/qq_40596572/article/details/102896520
字体
https://blog.csdn.net/qtlyx/article/details/99653081

3. PLATYPUS - 页面布局和排版

3.1. 设计目标

Platypus 是"Page Layout and Typography Using Scripts"的缩写。它是一个高水平的页面布局库， 让你可以用最少的努力以编程方式创建复杂的文档。
Platypus 的设计力求将 "高层次 "的布局决定与文档内容尽可能分开 。例如，段落使用段落样式，页面使用页面模板，目的是让数百个有数千页的文件可以按照不同的样式规格重新格式化，只需在一个包含段落样式和页面布局规格的共享文件中修改几行即可。
Platypus的整体设计可以认为有几个层次，自上而下，这些是:
• DocTemplates 作为文档的最外层容器。
• PageTemplates 作为各种页面布局的规格。
• Frames 页面中可包含流动文本或图形的区域规格。
• Flowables 对应"flowed into the document"流入文档的文本或图形元素（即图像、段落和表格等内容，但不包括页脚或固定页面图形等内容）。
pdfgen.Canvas 为最终从其他图层接收文档绘画的最低层。

上面的插图形象地说明了 DocTemplate、PageTemplate 和 Flowables 的概念 。然而，它具有欺骗性，因为每一个 PageTemplate 实际上可以指定任何数量的页面的格式（而不是像从图中推断的那样只指定一个）。
DocTemplate 包含一个或多个 PageTemplate，每个 PageTemplate 包含一个或多个Frame。
Flowables 是指可以 flowed(流入) Frame的东西，例如 Paragraph 或 Table。
要使用 platypus，你需要从 DocTemplate 类中创建一个文档，并向其 build 方法传递一个 Flowables列表。document 的 build 方法知道如何将 flowable 列表处理成合理的东西。
在内部，DocTemplate 类使用各种事件来实现页面布局和格式化。每个事件都有一个对应的处理方法，称为 handle_XXX ，其中 XXX 是事件名称。一个典型的事件是 frameBegin，它发生在机械开始第一次使用一个框架的时候。
Platypus 故事由一系列基本元素组成，这些元素被称为 Flowables，它们驱动着数据驱动的 Platypus格式化引擎。为了修改引擎的行为，一种特殊的可流式元素 ActionFlowables 告诉布局引擎，例如，跳到下一列或者换成另一个 PageTemplate。

3.2. 开始

考虑以下代码序列，它为 Platypus 提供了一个非常简单的 "hello world "例子。

from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.rl_config import defaultPageSize
from reportlab.lib.units import inchPAGE_HEIGHT=defaultPageSize[1]
PAGE_WIDTH=defaultPageSize[0]styles = getSampleStyleSheet()
Title = "Hello world"
pageinfo = "platypus example"# 首页
def myFirstPage(canvas, doc):canvas.saveState()# 标题canvas.setFont('Times-Bold',16)canvas.drawCentredString(PAGE_WIDTH/2.0, PAGE_HEIGHT-108, Title)# 页脚 填充固定字符canvas.setFont('Times-Roman',9)canvas.drawString(inch, 0.75 * inch, "First Page / %s" % pageinfo)canvas.restoreState()# 非首页
def myLaterPages(canvas, doc):canvas.saveState()# 页脚 填充页码canvas.setFont('Times-Roman',9)canvas.drawString(inch, 0.75 * inch, "Page %d %s" % (doc.page, pageinfo))canvas.restoreState()def main(filename: str):doc = SimpleDocTemplate(filename)# 与标题间隔Story = [Spacer(1, 2*inch)]style = styles["Normal"]for i in range(100):bogustext = ("This is Paragraph number %s. " % i) * 5p = Paragraph(bogustext, style)Story.append(p)# 段落之间间隔Story.append(Spacer(1, 0.2*inch))# 添加doc.build(Story, onFirstPage=myFirstPage, onLaterPages=myLaterPages)if __name__ == '__main__':main(filename='example.pdf')

我们创建一个"store"并构建文档。请注意，我们在这里使用的是"canned"(罐头)文档模板，它是预建的页面模板。
我们还使用了预建的段落样式 。
我们在这里只使用了两种类型的"flowables"–Spacers和Paragraphs 。第一个Spacer确保段落跳过标题字符串。

3.3. Flowables

Flowables 是可以被绘制的东西，它有wrap, draw和可能的split方法。Flowable 是一个抽象的基类，用于绘制事物，一个实例知道它的大小，并在它自己的坐标系中绘制(这需要基 API 在调用 Flowable.draw方法时提供一个绝对坐标系)。要获得一个实例，使用 f=Flowable()。
注意： Flowable 类是一个抽象类，通常只作为基类使用.
为了说明使用 Flowables 的一般方式，我们将展示如何在画布上使用和绘制衍生类 Paragraph。

def main(filename):from reportlab.lib.styles import getSampleStyleSheetfrom reportlab.platypus import Paragraphfrom reportlab.pdfgen.canvas import CanvasstyleSheet = getSampleStyleSheet()style = styleSheet['BodyText']P=Paragraph('This is a very silly example',style)canv = Canvas(filename)aW = 460 # available width and heightaH = 800w,h = P.wrap(aW, aH) # find required spaceif w<=aW and h<=aH:P.drawOn(canv,0,aH)aH = aH - h # reduce the available heightcanv.save()else:raise ValueError("Not enough room")if __name__ == '__main__':main(filename='example.pdf')

3.3.1. Flowable.draw()

这将被调用来要求 flowable 实际渲染自己。Flowable类没有实现draw。调用代码应该确保 flowable 有一个属性canv，它pdfgen.Canvas，它应该被绘制到Canvas上，并且Canvas处于一个适当的状态(就翻译、旋转等而言)。通常这个方法只在内部被drawOn方法调用，派生类必须实现这个方法。派生类必须实现这个方法。

3.3.2. Flowable.drawOn(canvas,x,y)

这是控制引擎用来将flowable渲染到特定画布的方法。它处理转换为画布坐标(x,y)，并确保flowable有一个canv属性，这样draw方法(在基类中没有实现)就可以在一个绝对坐标框架中渲染。

3.3.3. Flowable.wrap(availWidth, availHeight)

在询问对象的大小、绘制或其他什么之前，这个函数将被包围的框架调用。它返回实际使用的尺寸。

3.3.4. Flowable.split(self, availWidth, availheight)

当wrap失败时，更复杂的框架会调用这个函数。愚蠢的flowables应该返回[],这意味着它们无法拆分。聪明的flowables应该自己拆分并返回一个flowables列表。客户端代码要确保避免重复尝试拆分。如果空间足够，拆分方法应该返回[self]。否则，flowable应该重新排列，并返回一个按顺序考虑的flowable列表[f0,…]。实现的拆分方法应该避免改变self，因为这将允许复杂的布局机制在一个可流动的列表上进行多次递。

3.4. 流动定位的准则

有两种方法，默认情况下返回零，为可流动物的垂直间距提供指导。
Flowable.getSpaceAfter(self):
Flowable.getSpaceBefore(self):
这些方法会返回flowable后面或前面应该有多少空间。这些空间不属于flowable本身，也就是说，flowable的draw方法在渲染时不应该考虑它。控制程序将使用返回的值来确定上下文中特定flowable需要多少空间。
所有的flowables都有一个hAlign属性：(‘LEFT’,‘RIGHT’,‘CENTER’或’CENTRE’)。对于占满整个框架宽度的段落，这个属性没有影响。对于小于框架宽度的表格、图像或其他对象，这决定了它们的水平位置。
下面的章节将涵盖最重要的特定类型的可流动文件，段落和表格。

3.5. Frames

Frames是活动的容器，它本身就包含在PageTemplate中，Frames有一个位置和大小，并保持一个剩余可绘制空间的概念。如：

Frame(x1, y1, width, height, leftPadding=6, bottomPadding=6, rightPadding=6, topPadding=6, id=None, showBoundary=0)

创建一个左下角坐标为(x1,y1)的Frame实例(在使用时相对于画布)，尺寸为 width x height。Padding参数是用于减少绘画空间的正量。参数id是运行时使用的标识符，例如"LeftColumn"或"RightColumn"等。如果showBoundary参数是非零，那么框架的边界将在运行时被绘制出来（这有时很有用）。
Frames可以直接与canvases和flowables一起使用来创建文档。Frame.addFromList方法为你处理wrap 和 drawOn调用。你不需要所有的Platypus引擎来获得有用的东西到PDF中。

def main(filename): from reportlab.pdfgen.canvas import Canvasfrom reportlab.lib.styles import getSampleStyleSheetfrom reportlab.lib.units import inchfrom reportlab.platypus import Paragraph, Framestyles = getSampleStyleSheet()styleN = styles['Normal']styleH = styles['Heading1']story = []#add some flowablesstory.append(Paragraph("This is a Heading",styleH))story.append(Paragraph("This is a paragraph in <i>Normal</i> style.",styleN))c = Canvas(filename)f = Frame(inch, inch, 6*inch, 9*inch, showBoundary=1)f.addFromList(story,c)c.save()if __name__ == '__main__':main(filename='example.pdf')

3.5.1. Frame.addFromList(drawlist, canvas)

消耗drawlist前面的Flowables，直到帧满为止。如果不能容纳一个对象，则引发一个异常。

3.5.2. Frame.split(flowable,canv)

要求flowable使用可用空间进行分割，并返回flowable的列表。

3.5.3. Frame.drawBoundary(canvas)

将框架边界画成一个矩形（主要用于调试）。

3.6. 文档和模板

BaseDocTemplate类
实现了文档格式化的基本机制。该类的一个实例包含了一个或多个PageTemplate的列表，这些PageTemplate可用于描述单页信息的布局。build方法可用于处理Flowables列表，以生成一个PDF文档。

from reportlab.lib.pagesizes import A4
from reportlab.platypus import BaseDocTemplate
from reportlab.lib.units import inchBaseDocTemplate(filename,pagesize=A4,pageTemplates=[],showBoundary=0,		# 控制是否绘制Frame的边界，这对于调试来说是很有用的leftMargin=inch,rightMargin=inch,topMargin=inch,bottomMargin=inch,allowSplitting=1,	# allowSplitting参数决定了内置方法是否应该尝试split单个Flowables跨越Frametitle=None,author=None,_pageBreakQuick=1,	# 参数决定了在结束页面之前，是否应该尝试结束页面上的所有框架encrypt=None		# encrypt 参数决定了是否对文档进行加密，以及如何加密)

创建一个适合创建基本文档的文档模板。它带有相当多的内部机制，但没有默认的页面模板。所需的filename可以是一个字符串，一个用于接收创建的PDF文档的文件名；也可以是一个有write方法的对象，如 BytesIO 或 file 或 socket。
showBoundary控制是否绘制Frame的边界，这对于调试来说是很有用的。
allowSplitting参数决定了内置方法是否应该尝试split单个Flowables跨越Frame。
_pageBreakQuick参数决定了在结束页面之前，是否应该尝试结束页面上的所有框架。
encrypt 参数决定了是否对文档进行加密，以及如何加密。默认情况下，文档是不加密的。如果encrypt是一个字符串对象，那么它将作为pdf的用户密码。如果encrypt是一个reportlab.lib.pdfencrypt.StandardEncryption的实例，那么这个对象就被用来加密pdf。这允许对加密设置进行更精细的控制。

PageTemplate类
是一个语义相当简单的容器类。每个实例都包含一个Frames的列表，并且有一些方法应该在每个页面的开始和结束时被调用。

PageTemplate(id=None, frames=[], onPage=_doNothing, onPageEnd=_doNothing)

用于初始化一个实例，frames参数应该是一个Frames的列表，而可选的onPage和onPageEnd参数是可调用的，它们的签名应该是 def XXX(canvas,document)，其中canvas和document是正在绘制的画布和文档。这些例程的目的是用来绘制页面的非流动（即标准）部分。
这些属性函数与纯虚拟方法 PageTemplate.beforPage 和 PageTemplate.afterPage完全平行，这两个方法的签名是 beforPage(self,canvas,document)。这些方法允许使用类派生来定义标准行为，而属性则允许改变实例。在运行时，id 参数用于执行 PageTemplate 的切换，所以 id=‘FirstPage’ 或 id='TwoColumns’是典型的。

2.6.1. BaseDocTemplate.addPageTemplates(self,pageTemplates)

此方法用于在现有文档中添加一个或一系列PageTemplate。

3.6.2. BaseDocTemplate.build(self, flowables, filename=None,canvasmaker=canvas.Canvas)

这是应用程序程序员感兴趣的主要方法。假设文档实例被正确设置，build方法将story以flowables
列表的形式接收（flowables参数），并在列表中循环，将flowables列表一次一个地强制通过格式化
机制。实际上，这使得BaseDocTemplate实例发出对实例handle_XXX方法的调用来处理各种事件。

3.6.3. BaseDocTemplate.afterInit(self)

这个方法在基类初始化后被调用；派生类可以覆盖该方法来添加默认的PageTemplates。

3.6.4. BaseDocTemplate.afterPage(self)

这是在页面处理后，紧接着当前页面模板的afterDrawPage方法被调用。一个派生类可以使用这个方
法来做一些依赖于页面信息的事情，比如字典页面上的首字和尾字。

3.6.5. BaseDocTemplate.beforeDocument(self)

在对文档进行任何处理之前，但在处理机制准备好之后，就会调用这个函数，因此它可以用来对实
例的pdfgen.canvas等进行处理。因此，它可以用来对实例的pdfgen.canvas等进行操作。

3.6.6. BaseDocTemplate.beforePage(self)

这是在页面处理开始时，在当前页面模板的beforeDrawPage方法之前调用的。它可以用来重置页面
特定的信息持有者。

3.6.7. BaseDocTemplate.filterFlowables(self,flowables)

在主 handle_flowable 方法开始时，调用这个函数来过滤flowables。在返回时，如果flowables[0]
被设置为None，则会被丢弃，主方法立即返回。

3.6.8. BaseDocTemplate.afterFlowable(self, flowable)

在flowable被渲染后调用。有兴趣的类可以使用这个钩子来收集特定页面或框架上存在的信息。

4. Paragraph（段落）

5. Table（表格）

https://www.cnblogs.com/jilingxf/p/15857940.html

6. VerticalBarChart（柱形图表）

7.1. 控制柱形图颜色

https://dev59.com/uF7Va4cB1Zd3GeqPKod0

7. 饼状图

8. Image（图像）