Frago View Content Generate Tips Pdf

---
name: frago-view-content-generate-tips-pdf
description: PDF 文件内容生成指南。当需要了解 `frago view` 如何预览 PDF 文件时使用此 skill。涵盖渲染特性、限制说明。
---

# PDF 文件内容生成指南

通过 `frago view` 预览 PDF 文件，基于 PDF.js 客户端渲染。

## 预览命令

```bash
frago view document.pdf
```

---

## 渲染特性

### 基于 PDF.js

- 使用 Mozilla PDF.js 库
- 客户端渲染，无需服务器支持
- 所有页面连续显示

### 支持的 PDF 特性

| 特性 | 支持状态 |
|------|---------|
| 文本内容 | 支持 |
| 图片 | 支持 |
| 矢量图形 | 支持 |
| 嵌入字体 | 支持 |
| 书签/目录 | 不支持导航 |
| 表单填写 | 不支持 |
| 注释 | 只读显示 |
| 加密 PDF | 不支持 |

---

## 显示模式

### 连续滚动

所有页面按顺序垂直排列，支持滚动浏览。

### 页面间距

页面之间有适当间距，便于区分。

### 自适应宽度

PDF 页面自动适应窗口宽度。

---

## 最佳实践

### 1. PDF 生成建议

- 使用标准字体或嵌入字体
- 避免过大的图片（建议压缩）
- 单文件大小 < 10MB

### 2. 页面布局

- 纵向布局（Portrait）效果最佳
- 横向布局（Landscape）可能需要滚动

### 3. 文件命名

- 使用英文或数字命名
- 避免特殊字符

---

## 限制说明

| 限制 | 说明 | 规避方案 |
|------|------|---------|
| 无目录导航 | 点击目录不跳转 | 手动滚动 |
| 无搜索功能 | 无法搜索文本 | 使用专业 PDF 阅读器 |
| 无缩放控制 | 固定缩放比例 | 调整窗口大小 |
| 表单不可填 | 只读显示 | 使用 Adobe Reader |
| 加密不支持 | 无法打开 | 先解密 |
| 大文件慢 | 渲染耗时 | 拆分或压缩 |

---

## 适用场景

- 快速预览 PDF 报告
- 简单文档阅读
- 幻灯片 PDF 浏览

**不适用**：
- 需要目录导航的长文档
- 需要表单填写的交互式 PDF
- 加密或受保护的 PDF

---

## 替代方案

对于复杂 PDF 需求，建议使用：
- macOS: 预览.app
- Windows: Adobe Acrobat Reader
- 跨平台: Firefox/Chrome 内置 PDF 查看器