完整的 shortcode 方案,分三步:
第一步:创建 shortcode 文件
在 Hugo 项目根目录新建 layouts/shortcodes/pdf.html:
<object data="{{ .Get 0 }}" type="application/pdf" width="100%" height="{{ with .Get 1 }}{{ . }}{{ else }}800px{{ end }}">
<iframe src="{{ .Get 0 }}" width="100%" height="{{ with .Get 1 }}{{ . }}{{ else }}800px{{ end }}" style="border: none;">
<p>你的浏览器不支持内嵌 PDF,请 <a href="{{ .Get 0 }}">下载查看</a>。</p>
</iframe>
</object>
这里用了 <object> 包 <iframe> 的结构:object 是标准做法,iframe 作为兜底,最内层的 <p> 是最后的 fallback。
第二步:放 PDF 文件
mkdir -p static/files
cp your-paper.pdf static/files/
构建后路径为 /files/your-paper.pdf。
第三步:页面里调用
带高度参数(第二个参数,支持 px 和 vh):
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
| 第一个 | 是 | PDF 的 URL,可以是站内路径 /files/x.pdf 或外链 https://... |
| 第二个 | 否 | 高度,默认 800px |
可选增强:移动端适配
如果担心小屏幕高度不够,可以改 shortcode 用 {{ .Get 1 }} 的同时加个 CSS 类:
<object class="pdf-embed" data="{{ .Get 0 }}" type="application/pdf" width="100%" height="{{ with .Get 1 }}{{ . }}{{ else }}800px{{ end }}">
...
</object>
在 assets/css/ 或主题自定义样式里加:
.pdf-embed {
border: 1px solid #ddd;
border-radius: 4px;
}
@media (max-width: 768px) {
.pdf-embed {
height: 60vh !important;
}
}
改完 hugo server 本地起一下,访问对应页面确认能渲染即可。