# @eeacms/volto-pdf-block 中文文档

规范地址：https://npmcn.com/package/%40eeacms/volto-pdf-block/

版本：1\.0\.12
npm 元数据更新时间：2025-01-31T13:51:12.201Z
中文译文更新时间：2026-11-13T07:55:15.112Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40eeacms/volto-pdf-block
原文对照：https://npmcn.com/package/%40eeacms/volto-pdf-block/?lang=original
项目主页：https://github.com/eea/volto-pdf-block
源码仓库：https://github.com/eea/volto-pdf-block

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：87.6 kB，32 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2021-05-06T06:22:46.813Z
- 最新版本发布：2025-01-31T13:51:11.813Z
- 近 30 天下载量：3665（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 0 个）

## 中文简介

volto-pdf-块: Pdf 集成块

## 安装

```sh
npm install @eeacms/volto-pdf-block
```

也可以使用：`pnpm add @eeacms/volto-pdf-block`、`yarn add @eeacms/volto-pdf-block`、`bun add @eeacms/volto-pdf-block`

## README

# volto-pdf-块

[![Releases](https://img.shields.io/github/v/release/eea/volto-pdf-block)](https://github.com/eea/volto-pdf-block/releases)

[![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-pdf-block%2Fmaster&subject=master)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-pdf-block/job/master/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-master&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-master) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-master&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-master) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-master&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-master) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-master&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-master)

[![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-pdf-block%2Fdevelop&subject=develop)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-pdf-block/job/develop/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-develop&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-develop) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-develop&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-develop) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-develop&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-develop) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-pdf-block-develop&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-pdf-block-develop)

[沃尔多](https://github.com/plone/volto) 加载

## 特征

-   沃尔多的灵活PDF集成.

注:这个加词假设,如果你试图装入外部主机PDF 文件,您将使用 [@eeacms/volto-corsproxy (英语)](https://github.com/eea/volto-corsproxy)

## 开始

### 用 Docker 尝试 volto- pdf 块

```
  git clone https://github.com/eea/volto-pdf-block.git
  cd volto-pdf-block
  make
  make start
```

转到 http://localhost:3:00

### 在您的 Volto 项目中添加 volto- pdf- block

1.  确保你有 [Plone 后端](https://plone.org/download) 在http://localhost:8080/Plone上运行
    
    ```Bash
    docker compose up backend
    ```
    
2.  启动 Volto 前端
    

-   如果你已经有伏尔托项目,只需更新 `package.json`数字 :
    
    ```JSON
    "addons": [
        "@eeacms/volto-pdf-block"
    ],
    
    "dependencies": {
        "@eeacms/volto-pdf-block": "*"
    }
    ```
    
-   如果没有,请创建:
    
    ```
    npm install -g yo @plone/generator-volto
    yo @plone/volto my-volto-project --canary --addon @eeacms/volto-pdf-block
    cd my-volto-project
    ```
    

1.  安装新加载并重新启动 Volto :
    
    ```
    yarn
    yarn start
    ```
    
2.  转到 http://localhost:3:00
    
3.  剪辑愉快!
    

## PDF 库的内部使用

```JS
import config from '@plone/volto/registry';
import PDF from '@mikecousins/react-pdf';


export const PdfViwer = (props) => {

return (
  <PDF
    file={source.file || source.url}
    content={source.base64}
    binaryContent={source.binary}
    documentInitParameters={source.connection}
    page={page}
    scale={scale}
    onPageRenderSuccess={onPageRenderSuccess}
    onPageRenderFail={onPageRenderFail}
    workerSrc={config.settings.pdfWorkerSrc}
    onDocumentLoadSuccess={onDocumentComplete}
  >
    {({ pdfDocument, pdfPage, canvas }) => (
    <>
      {!pdfDocument && loaderComponent(canvas)}
      {pdfDocument && canvas}
    </>
    )}
  </PDF>
)}
```

## 工人网络

允许您为 pdf 工人指定自己的 URL . 默认由库设置为:

```
"//cdnjs.cloudflare.com/ajax/libs/pdf.js/${pdfjs.version}/pdf.worker.js"
```

对于需要将库放在不同的 CDN 上的情况,可以配置在 `config.settings.pdfWorkerSrc` 如何做到这一点 [自愿政策](https://github.com/eea/volto-ims-policy/blob/master/src/index.js) 它是一个加法,它为不同的加法提供了伏尔多的配置.

```JS
const applyConfig = (config) => {
  ...
  // PDF worker url
  config.settings.pdfWorkerSrc = '//www.eea.europa.eu/pdfjs/pdf.worker.min.js';
  return config;
};
```

## 释放

见 [发 言](https://github.com/eea/volto-pdf-block/blob/master/RELEASE.md)。 。 。 .

## 如何捐款

见 [发达国家d](https://github.com/eea/volto-pdf-block/blob/master/DEVELOP.md)。 。 。 .

## 版权和许可证

原始守则的初始所有人是欧洲环境署. 所有权利保留.

见 [利比里亚](https://github.com/eea/volto-pdf-block/blob/master/LICENSE.md) 详细情况.

## 供资

[欧洲环境署(欧盟)](http://eea.europa.eu/)

## 常见问题

### @eeacms/volto-pdf-block 是什么？

volto-pdf-块: Pdf 集成块

### 如何安装 @eeacms/volto-pdf-block？

在项目目录运行 npm install @eeacms/volto-pdf-block，或使用 pnpm add / yarn add / bun add。

### @eeacms/volto-pdf-block 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/eeacms\_\_volto-pdf-block 是否存在。

### @eeacms/volto-pdf-block 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @eeacms/volto-pdf-block 可以商用吗？

@eeacms/volto-pdf-block 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @eeacms/volto-pdf-block 的下载量有多少？

根据 npm 官方下载统计，@eeacms/volto-pdf-block 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,665 次，日均约 122 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @eeacms/volto-pdf-block 还在维护吗？

最新版本 1\.0\.12 发布于 2025/01/31（1\.8 年前）；至今共发布 12 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/05/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。