certg 4.2

如何将其用作库

从pypi安装certg，然后…

>>> import certg
>>> certg.process(
    svg_source,
    result_prefix,
    result_distinct,
    replace_info,
    progress_cb=None,
    pdf_optimized=False)

…其中所有强制参数都具有相同的含义，如果您拥有它们 在yaml配置（见下文）中，progress\u cb是要调用的回调 在处理每个项目之后（有助于报告进度）。

一些用法示例

获取代码，然后运行：

bin/certg examples/certificate.yaml

项目中包含了示例证书.yaml 它使用的其他文件：example\u certificate.svg。

成功执行后，您将得到三个.pdf文件，结果是 一代人的。

下面是在输出中插入不同图像的其他示例：

bin/certg examples/carnet.yaml

最后，如果你想检查一个程序化使用certg的代码， 替换svg中的几个字段和多个图像，请参见 this real life code。

您需要安装什么

系统中的python模块yaml和inkscape。如果你想的话 优化生成的pdf，还需要安装ghostscript（gs）。

如何真正使用它，满足您的特定需要

您需要创建两个文件：配置和源svg。 这里有一个很好的解释，但是记住你可以 获取提供的示例并开始调整它们：）

源SVG是要转换为PDF的SVG，但是 在中替换文本的一些指示。这些迹象是 在花括号之间。例如，您可能有：

Thanks {{name}} for all your {{type_of_doing}}!

然后，在配置文件中有一个replace_info变量： 字典列表。每本词典都会生成一个pdf 替换的信息和字典中的键/值将是 要替换的信息。

注意，您需要在配置中提供 替换；例如：

name: Foo Bar
type_of_doing: support

此外，在配置中有一些必需的变量 填补。这些是：

• svg源代码：您创建的svg的文件名
• result_prefix：PDF文件名的前缀 生成
• result\u distinct：替换中变量的名称 用作PDF的不同字符串的属性。

例如，如果您将证书作为前缀，并将名称作为 不同的值，您将得到一个名为certs foobar.pdf的文件作为输出。

对于不同的配置，目前有一些可选变量：

• pdf优化：它将运行ghoscript（gs，您需要 安装在系统中）以优化生成的PDF。