注意：这不要与PDF本身的版本/版别混淆。这是您自己决定的事情（也许可以将它作为YAML值设置，作为PDF字典条目的一部分，下面将提供更多信息）。

要设置版本，请查看显示对应枚举和版本号的表格。

纸张大小

支持的纸张大小列表。例如，my_pdf_instance.set_paper_size(PaperSize::A5)。如果没有设置纸张大小，则默认纸张大小为A4。

ISO 216 A系列纸张尺寸

ISO 216 B系列纸张尺寸

美国纸张尺寸

JIS纸张尺寸

纸张方向

这允许将PDF文档页面保存为横向或纵向方向。例如，my_pdf_instance.set_orientation(PaperOrientation::Landscape)。如果没有设置方向，默认为Portrait。

页面边距

边距使用的单位是毫米（mm）。如果没有设置边距，默认边距大小为10。

使用CSS缩写符号设置页面边距（上 右 下 左）。这意味着

设置一个值，然后四个边距都将获得该值。例如，my_pdf_instance.set_margins("20")将导致以下结果

• margin-top: 20,
• margin-right: 20,
• margin-bottom: 20,
• margin-left: 20

设置两个值，则上边和下边边距将获得第一个值，右边和左边边距将获得第二个值。例如，my_pdf_instance.set_margins("20 15")将导致以下结果

• margin-top: 20,
• margin-right: 15,
• margin-bottom: 20,
• 左边距：15

设置三个值后，顶部边距将获得第一个值，左右边距将获得第二个值，底部边距将获得第三个值。例如，my_pdf_instance.set_margins("20 15 30") 将得到以下结果

• margin-top: 20,
• margin-right: 15,
• 底部边距：30
• 左边距：15

设置四个值后，顶部边距将获得第一个值，右边距将获得第二个值，底部边距将获得第三个值，左边距将获得第四个值。例如，my_pdf_instance.set_margins("20 15 30 5") 将得到以下结果

• margin-top: 20,
• margin-right: 15,
• 底部边距：30
• 左边距：5

如果设置了其他值（或非整数、字母、字符等），则每个边距将使用默认值 10。

页面字体

PDF文档可以使用14种标准字体之一。这些是

例如，my_pdf_instance.set_font(FontsStandard::TimesRoman)。如果没有设置字体，则默认字体为 Helvetica。

PDF字典条目

PDF字典条目是您在PDF阅读器中选择“文档属性”时可以看到的名称和值对。字典条目区分大小写，有一些保留名称。

保留字典条目

• 标题
• 作者
• 主题
• 关键词

这些 必须 大写。 PDF Composer 自动将保留名称转换为大写。所有其他内容将保持原样。

在 PDF Composer 中，标题条目是一个特殊情况。作为PDF生成过程的一部分，YAML文档中的 title 值将自动插入到HTML模板中使用的 <title> 标签中。因此，字典条目被填充。如果没有找到YAML值，则使用源文件的文件名代替。

不允许空条目。如果没有找到相应的YAML条目，则不会将空条目添加到PDF文档中。

例如，如果您想设置一个名为 Language 的字典条目，并将其设置为YAML文档中不存在的YAML条目，则 PDF Composer 不会创建空条目。

设置字典条目的示例

PDFDocInfoEntry {
    doc_info_entry: "Subject",
    yaml_entry: "description",
}

doc_info_entry 是PDF字典条目。

yaml_entry 是将分配给字典条目的YAML值。

YAML Markdown占位符替换

在 YAML 文档的 Markdown 部分中可以进行简单的替换。这可以通过在 Markdown 部分使用 {{my_yaml_value}} 实现。

示例

---

# Front Matter (YAML)

author: "Richard"

---

The author of this document is {{author}}.

结果将是： 本文档的作者是 Richard.

如果找不到 YAML 值，则替换占位符将保留在生成的输出中。

示例

---

# Front Matter (YAML)

author: "Richard"

---

The author of this document is {{name}}.

结果将是： 本文档的作者是 {{name}}.

示例用法

假设你已经安装并运行了 Rust（测试版本 1.77+）并且已经运行了 cargo add pdf_composer 来安装 PDF Composer 包，然后你可以开始了。

use pdf_composer::{FontsStandard, PaperOrientation, PaperSize, PDFComposer, PDFDocInfoEntry, PDFVersion};

// Create a new PDFComposer instance
let mut my_pdf_instance = PDFComposer::new();

// Add some paths. Relative paths
let paths = vec![
    PathBuf::from("source_mds/file_01.md"),
    PathBuf::from("source_mds/file_02.md")
];
my_pdf_instance.add_source_files(paths);

// PDF version (not the version of the document, but the Adobe (formerly) PDF format version)
my_pdf_instance.set_pdf_version(PDFVersion::V2_0);

// Output directory for the generated PDFs
my_pdf_instance.set_output_directory("example_pdfs");

// Set the paper size
my_pdf_instance.set_paper_size(PaperSize::A5);

// Set the paper orientation
my_pdf_instance.set_orientation(PaperOrientation::Landscape);

// Set the page margins
my_pdf_instance.set_margins("20");

// Set font
my_pdf_instance.set_font(FontsStandard::TimesRoman);

// Metadata for the PDFs
let author_entry = PDFDocInfoEntry {
    doc_info_entry: "Author",
    yaml_entry: "author",
};
let keywords_entry = PDFDocInfoEntry {
    doc_info_entry: "Keywords",
    yaml_entry: "keywords",
};
let subject_entry = PDFDocInfoEntry {
    doc_info_entry: "Subject",
    yaml_entry: "description",
};
let language_entry = PDFDocInfoEntry {
    doc_info_entry: "Language",
    yaml_entry: "language",
};
my_pdf_instance.set_doc_info_entry(author_entry);
my_pdf_instance.set_doc_info_entry(keywords_entry);
my_pdf_instance.set_doc_info_entry(subject_entry);
my_pdf_instance.set_doc_info_entry(language_entry);

// Generate the PDF(s)
my_pdf_instance.generate_pdfs();