pdf

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

PDF Generator Skill

Generate professionally branded PDFs from markdown documents.

从Markdown文档生成具有专业品牌风格的PDF。

Trigger

触发方式

User runs

/pdf [file]

or asks to "generate PDF", "convert to PDF", or "create PDF".

用户运行

/pdf [file]

命令，或者提出“生成PDF”、“转换为PDF”、“创建PDF”等需求。

Usage

使用方法

bash

undefined

bash

undefined

Single file

/pdf content/case-studies/project.md

With custom output

/pdf proposal.md ~/Desktop/client-proposal.pdf

HTML (for browser printing)

/pdf --html document.md

undefined

/pdf --html document.md

undefined

Workflow

工作流程

1. Validate Input

1. 验证输入

Check file exists
Verify it's a markdown file
Check PDF generator is set up

检查文件是否存在
验证是否为Markdown文件
检查PDF生成器是否已配置完成

2. Generate PDF

2. 生成PDF

Run the generator script:

bash

./tools/pdf-generator/generate-pdf.sh [input] [output]

运行生成器脚本：

bash

./tools/pdf-generator/generate-pdf.sh [input] [output]

3. Report Results

3. 报告结果

Confirm PDF location
Open PDF (on macOS)
Report any errors

确认PDF的存储位置
在macOS上打开PDF
报告任何错误

Common Tasks

常见任务

Convert Case Study

转换案例研究

bash

./tools/pdf-generator/generate-pdf.sh content/case-studies/[name].md

Output:

tools/pdf-generator/output/[name].pdf

bash

./tools/pdf-generator/generate-pdf.sh content/case-studies/[name].md

输出：

tools/pdf-generator/output/[name].pdf

Convert Proposal

转换提案

bash

./tools/pdf-generator/generate-pdf.sh clients/[client]/proposal.md

bash

./tools/pdf-generator/generate-pdf.sh clients/[client]/proposal.md

Batch Convert

批量转换

bash

./tools/pdf-generator/generate-pdf.sh --batch content/case-studies/

bash

./tools/pdf-generator/generate-pdf.sh --batch content/case-studies/

HTML Fallback

HTML备选方案

If no PDF engine is installed:

bash

./tools/pdf-generator/generate-pdf.sh --html document.md

Then print to PDF from browser.

如果未安装PDF引擎：

bash

./tools/pdf-generator/generate-pdf.sh --html document.md

随后从浏览器打印为PDF。

Customization

自定义设置

Brand Colors

品牌颜色

Edit

tools/pdf-generator/templates/styles.css

css

:root {
  --primary: #552cd5;    /* Your brand color */
  --accent: #0ea5e9;     /* Links, highlights */
}

编辑

tools/pdf-generator/templates/styles.css

文件：

css

:root {
  --primary: #552cd5;    /* Your brand color */
  --accent: #0ea5e9;     /* Links, highlights */
}

Footer

页脚

Edit

tools/pdf-generator/templates/template.html

to add:

Company name
Website
Contact info

编辑

tools/pdf-generator/templates/template.html

以添加以下内容：

公司名称
官网地址
联系信息

Requirements

依赖要求

Pandoc:
```
brew install pandoc
```
WeasyPrint:
```
pip install weasyprint
```
(recommended)

Install with:

bash

./tools/pdf-generator/generate-pdf.sh --install

Pandoc:
```
brew install pandoc
```
WeasyPrint:
```
pip install weasyprint
```
(推荐)

安装命令：

bash

./tools/pdf-generator/generate-pdf.sh --install

Troubleshooting

故障排除

"No PDF engine found"

Install WeasyPrint:

pip install weasyprint

Or use

--html

flag and print from browser.

安装WeasyPrint：

pip install weasyprint

或者使用

--html

参数，从浏览器打印为PDF。

"pandoc not found"

Install:

brew install pandoc

安装：

brew install pandoc

Fonts not rendering

字体无法正常显示

WeasyPrint needs fonts installed locally. Use system fonts or install Google Fonts.

WeasyPrint需要本地安装字体。可使用系统字体或安装谷歌字体。