注：当前项目为 Serverless Devs 应用，由于应用中会存在需要初始化才可运行的变量（例如应用部署地区、函数名等等），所以不推荐直接 Clone 本仓库到本地进行部署或直接复制 s.yaml 使用，强烈推荐通过 s init ${模版名称} 的方法或应用中心进行初始化，详情可参考部署 & 体验 。

start-word2pdf-v3 帮助文档

本案例是将 word 转 pdf 的逻辑封装成一个python函数，快速创建并部署到阿里云函数计算 FC。

• 😺 代码

前期准备

使用该项目，您需要有开通以下服务并拥有对应权限：

服务/业务	权限	相关文档
函数计算	AliyunFCFullAccess	帮助文档 计费文档

部署 & 体验

• 🔥 通过 Serverless 应用中心 ， 该应用。

• 通过 Serverless Devs Cli 进行部署：
  • 安装 Serverless Devs Cli 开发者工具 ，并进行授权信息配置 ；
  • 初始化项目：s init start-word2pdf-v3 -d start-word2pdf-v3
  • 进入项目，并进行项目部署：cd start-word2pdf-v3 && s deploy -y

案例介绍

本案例是将 word 转 pdf 的逻辑封装成一个python函数，快速创建并部署到阿里云函数计算 FC。

运用了soffice，它是LibreOffice套件中的一个命令行工具，它允许用户启动LibreOffice的应用程序并处理文档

1. 文档处理：soffice可以用来打开、编辑、转换不同格式的文档文件，包括文字处理文档、电子表格、演示文稿等。
2. 格式转换：可以将文档从一个格式批量转换为另一个格式，例如将多个DOC文件转换为PDF。
3. 服务器模式：通过--headless选项，soffice可以在不启动图形用户界面的情况下运行，非常适合服务器和自动化脚本使用。

通过 Serverless 开发平台，您只需要几步，就可以体验 word 转 pdf，并享受 Serverless 架构带来的降本提效的技术红利。

使用流程

查看部署的案例

1、部署成功后，从资源信息栏，找到对应函数资源，点击函数名称跳转到函数计算控制台，如： 2、在代码页签，单击测试函数右侧的图标，从下拉列表中选择配置测试参数，输入如下示例测试参数，然后单击确定。

{
    "word_file": "example.docx",  
    "mark_text": "AliyunFC",  
    "pagesize": [595.275590551181, 841.8897637795275], 
    "font": "Helvetica", 
    "font_size": 30, 
    "font_color": [0, 0, 0], 
    "rotate": 30, 
    "opacity": 0.1,
    "density": [198.4251968503937, 283.46456692913387] 
}

参数	是否必填	描述
word_file	必填	pdf文件名称
mark_text	可选	水印文字， 如果给 PDF 加水印
pagesize	可选	默认是 A4 大小， (21cm, 29.7cm), 其中 1cm=28.346456692913385
font	可选	字体，默认为 Helvetica, 中文字体可选择为 zenhei 或 microhei
font_size	可选	字体的大小，默认为 30
font_color	可选	字体颜色，格式为 RGB， 默认为黑色
rotate	可选	旋转角度，默认为 0
opacity	可选	透明度，默认为 0.1， 1 表示不透明
density	可选	水印密度，水印文字间隔，默认是 [141.73228346456693, 141.73228346456693]，即（7cm, 10cm), 表示每个水印文字在横坐标和纵坐标的间隔分别是 7cm 和 10

3、单击测试函数，函数执行成功后，查看返回结果。

 upload to oss success!

如果您需要使用 SDK 调用这个函数， 可以参考 OpenAPI

也可以通过s invoke命令进行触发/测试：

# 调用
$ s invoke -e '{"word_file":"example.docx"}'

函数调用成功后，生成的 pdf 文件在和 docx 相同的 OSS 目录中，比如这个例子是在 example.pdf。

如果您想 word 转 pdf 同时再加上水印， 需要增加如下相关的参数：

比如:

$ s invoke -e '{"word_file":"example.docx", "mark_text": "AliyunFC", "rotate":30}'

# 如果是中文水印, font 为 zenhei 或者 microhei
$ s invoke -e '{"word_file":"example.docx", "mark_text": "函数计算", "rotate":30, "font": "zenhei"}'

生成带有水印的 example.pdf 示例:

layer

引入的 public layer 包含了 libreoffice 以及如下 python 第三方依赖

oss2==2.16.0
flask==2.2.2
Pillow==9.4.0
PyPDF2==3.0.1
reportlab==3.6.12
cryptography==3.4.8
urllib3==1.26.2

二次开发

您可以通过云端控制台的开发功能进行二次开发。如果您之前是在本地创建的项目案例，也可以在本地项目目录start-word2pdf-v3文件夹下，对项目进行二次开发。开发完成后，可以通过s deploy进行快速部署。

注意事项

开发者社区

您如果有关于错误的反馈或者未来的期待，您可以在 Serverless Devs repo Issues 中进行反馈和交流。如果您想要加入我们的讨论组或者了解 FC 组件的最新动态，您可以通过以下渠道进行：

微信公众号：serverless	微信小助手：xiaojiangwh	钉钉交流群：33947367