mirror of
https://github.com/pengzhanbo/vuepress-theme-plume.git
synced 2026-04-25 11:28:13 +08:00
111 lines
1.8 KiB
Markdown
111 lines
1.8 KiB
Markdown
---
|
|
url: /guide/embed/pdf/index.md
|
|
---
|
|
## 概述
|
|
|
|
主题支持在 markdown 中嵌入 PDF 文件，它能够在页面中直接阅读 PDF 。
|
|
|
|
该功能由 [vuepress-plugin-md-power](../../config/plugins/markdown-power.md) 提供支持。
|
|
|
|
## 配置
|
|
|
|
该功能默认不启用。你需要在主题配置中开启。
|
|
|
|
```ts title=".vuepress/config.ts"
|
|
export default defineUserConfig({
|
|
theme: plumeTheme({
|
|
markdown: {
|
|
pdf: true, // [!code ++]
|
|
},
|
|
})
|
|
})
|
|
```
|
|
|
|
## 语法
|
|
|
|
最简单的语法如下：
|
|
|
|
```md
|
|
@[pdf](url)
|
|
```
|
|
|
|
当需要打开特定页面时，在 `pdf` 后面跟随一个 页数。
|
|
|
|
```md
|
|
@[pdf 2](url)
|
|
```
|
|
|
|
还可以添加更多的 选项到 `@[pdf ]` 中，更灵活的控制行为。
|
|
|
|
```md
|
|
@[pdf 2 no-toolbar width="100%" height="400px" ratio="16:9" zoom="100"](url)
|
|
```
|
|
|
|
* `no-toolbar` - 不显示工具栏
|
|
* `width` - 宽度，默认为 100%
|
|
* `height` - 高度，默认为 `auto`
|
|
* `ratio` - 宽高比, 默认为 `16:9`, 仅当未指定高度时生效
|
|
* `zoom` - 缩放比例, 百分比。
|
|
|
|
## 示例
|
|
|
|
### 默认
|
|
|
|
输入：
|
|
|
|
```md
|
|
@[pdf](https://plume.pengzhanbo.cn/files/sample-1.pdf)
|
|
```
|
|
|
|
输出：
|
|
|
|
@[pdf](/files/sample-1.pdf)
|
|
|
|
### 设置页码为 2
|
|
|
|
输入：
|
|
|
|
```md
|
|
@[pdf 2](https://plume.pengzhanbo.cn/files/sample-1.pdf)
|
|
```
|
|
|
|
输出：
|
|
|
|
@[pdf 2 zoom="95"](/files/sample-1.pdf)
|
|
|
|
### 不显示工具栏
|
|
|
|
输入：
|
|
|
|
```md
|
|
@[pdf no-toolbar](https://plume.pengzhanbo.cn/files/sample-1.pdf)
|
|
```
|
|
|
|
输出：
|
|
|
|
@[pdf no-toolbar](/files/sample-1.pdf)
|
|
|
|
### 缩放比 90%
|
|
|
|
输入：
|
|
|
|
```md
|
|
@[pdf zoom="90"](https://plume.pengzhanbo.cn/files/sample-1.pdf)
|
|
```
|
|
|
|
输出：
|
|
|
|
@[pdf zoom="90"](/files/sample-1.pdf)
|
|
|
|
### 宽高比 21:29
|
|
|
|
输入：
|
|
|
|
```md
|
|
@[pdf zoom="95" ratio="21:29"](https://plume.pengzhanbo.cn/files/sample-1.pdf)
|
|
```
|
|
|
|
输出：
|
|
|
|
@[pdf zoom="95" ratio="21:29"](/files/sample-1.pdf)
|