关于 paper-2-web
paper-2-web 是一项将学术论文转为网站、演示视频和会议海报的技能,适用于准备展示与传播研究成果的研究人员。
主要功能
- 01生成交互式学术网站
- 02制作带旁白的演示视频
- 03生成可打印会议海报
- 04自定义布局与尺寸
- 05批量处理多篇论文
适用场景
- 01为论文创建配套网站
- 02准备会议海报
- 03制作视频摘要或报告
- 04为多篇论文生成材料
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jackspace/ claudeskillz --skill paper-2-web安装后在 Claude Code 中输入/paper-2-web确认已加载。
附带文件SKILL.json
详细介绍
Paper2All:学术论文转换流程
概述
此技能可通过 Paper2All 自主流程,将学术论文转换为多种宣传和演示格式。该系统可将研究论文(LaTeX 或 PDF)转换为三种主要输出:
- Paper2Web:具有布局感知设计、可交互探索的学术主页
- Paper2Video:专业演示视频,包含旁白、幻灯片和可选的真人出镜视频
- Paper2Poster:采用专业版式、可直接打印的学术会议海报
该流程利用大模型驱动的内容提取、设计生成和迭代优化,制作适用于学术会议、期刊、预印本存储库和学术推广的高质量内容。
何时使用此技能
以下情况可使用此技能:
- 制作会议材料:为学术会议制作海报、演示视频和配套网站
- 推广研究:将已发表论文或预印本转换为易于阅读、引人入胜的网页格式
- 准备演示:根据论文内容生成视频摘要或完整演示视频
- 传播研究成果:为社交媒体、实验室网站或机构展示制作宣传材料
- 增强预印本:为 bioRxiv、arXiv 或其他预印本投稿添加交互式主页
- 批量处理:同时为多篇论文生成宣传材料
触发短语:
- “将这篇论文转换为网站”
- “根据我的 LaTeX 论文生成学术会议海报”
- “根据这项研究制作演示视频”
- “为我的论文制作交互式主页”
- “将我的论文转换为宣传材料”
- “为我的学术会议报告生成海报和视频”
核心功能
1. Paper2Web:交互式网站生成
将论文转换为具有布局感知能力的交互式学术主页,功能远超简单的 HTML 转换。
主要功能:
- 根据论文内容调整的响应式多分区布局
- 可交互的图表、表格和引文
- 适配移动设备的设计和导航
- 自动发现徽标(使用 Google Search API)
- 美学优化和质量评估
适用场景:论文发表后的推广、增强预印本、实验室网站、长期研究成果展示
→ 详细文档请参阅 references/paper2web.md
2. Paper2Video:演示视频生成
生成专业演示视频,包含幻灯片、旁白、光标移动和可选的真人出镜视频。
主要功能:
- 根据论文结构自动生成幻灯片
- 自然流畅的语音合成
- 同步的光标移动和重点标示
- 可选的真人出镜视频(使用 Hallo2,需要 GPU)
- 支持多种语言
适用场景:视频摘要、学术会议演示、在线演讲、课程材料、YouTube 推广
→ 详细文档请参阅 references/paper2video.md
3. Paper2Poster:学术会议海报生成
制作采用专业版式和视觉设计、可直接打印的学术海报。
主要功能:
- 自定义海报尺寸(任意大小)
- 专业设计模板
- 支持机构品牌标识
- 生成链接二维码
- 高分辨率输出(300+ DPI)
适用场景:学术会议海报环节、研讨会、学术展览、线上会议
→ 详细文档请参阅 references/paper2poster.md
快速开始
前置条件
-
安装 Paper2All:
git clone https://github.com/YuhangChen1/Paper2All.git cd Paper2All conda create -n paper2all python=3.11 conda activate paper2all pip install -r requirements.txt -
配置 API 密钥(创建
.env文件):OPENAI_API_KEY=your_openai_api_key_here # Optional: GOOGLE_API_KEY and GOOGLE_CSE_ID for logo search -
安装系统依赖:
- LibreOffice(文档转换)
- Poppler 工具(PDF 处理)
- NVIDIA GPU,显存 48 GB(可选,用于真人出镜视频)
→ 完整安装指南请参阅 references/installation.md
基本用法
生成所有组件(网站 + 海报 + 视频):
python pipeline_all.py \
--input-dir "path/to/paper" \
--output-dir "path/to/output" \
--model-choice 1
仅生成网站:
python pipeline_all.py \
--input-dir "path/to/paper" \
--output-dir "path/to/output" \
--model-choice 1 \
--generate-website
生成自定义尺寸的海报:
python pipeline_all.py \
--input-dir "path/to/paper" \
--output-dir "path/to/output" \
--model-choice 1 \
--generate-poster \
--poster-width-inches 60 \
--poster-height-inches 40
生成视频(轻量级工作流):
python pipeline_light.py \
--model_name_t gpt-4.1 \
--model_name_v gpt-4.1 \
--result_dir "path/to/output" \
--paper_latex_root "path/to/paper"
→ 完整的工作流示例请参阅 references/usage_examples.md
工作流决策树
使用此决策树确定要生成哪些组件:
User needs promotional materials for paper?
│
├─ Need permanent online presence?
│ └─→ Generate Paper2Web (interactive website)
│
├─ Need physical conference materials?
│ ├─→ Poster session? → Generate Paper2Poster
│ └─→ Oral presentation? → Generate Paper2Video
│
├─ Need video content?
│ ├─→ Journal video abstract? → Generate Paper2Video (5-10 min)
│ ├─→ Conference talk? → Generate Paper2Video (15-20 min)
│ └─→ Social media? → Generate Paper2Video (1-3 min)
│
└─ Need complete package?
└─→ Generate all three components
输入要求
支持的输入格式
1. LaTeX 源文件(推荐):
paper_directory/
├── main.tex # Main paper file
├── sections/ # Optional: split sections
├── figures/ # All figure files
├── tables/ # Table files
└── bibliography.bib # References
2. PDF:
- 内嵌字体的高质量 PDF
- 可选择的文本(非扫描图像)
- 高分辨率图表(优先使用 300+ DPI)
输入组织
单篇论文:
input/
└── paper_name/
├── main.tex (or paper.pdf)
├── figures/
└── bibliography.bib
多篇论文(批量处理):
input/
├── paper1/
│ └── main.tex
├── paper2/
│ └── main.tex
└── paper3/
└── main.tex
常用参数
模型选择
--model-choice 1:GPT-4(质量与成本的最佳平衡)--model-choice 2:GPT-4.1(功能最新,成本较高)--model_name_t gpt-3.5-turbo:速度更快、成本更低(质量尚可)
组件选择
--generate-website:启用网站生成--generate-poster:启用海报生成--generate-video:启用视频生成--enable-talking-head:为视频添加虚拟讲解员(需要 GPU)
自定义
--poster-width-inches [width]:自定义海报宽度--poster-height-inches [height]:自定义海报高度--video-duration [seconds]:目标视频时长--enable-logo-search:自动查找机构徽标
输出结构
生成的输出按论文和组件组织:
output/
└── paper_name/
├── website/
│ ├── index.html
│ ├── styles.css
│ └── assets/
├── poster/
│ ├── poster_final.pdf
│ ├── poster_final.png
│ └── poster_source/
└── video/
├── final_video.mp4
├── slides/
├── audio/
└── subtitles/
最佳实践
输入准备
- 尽可能使用 LaTeX:可获得最佳的内容提取效果和结构
- 妥善组织文件:将所有资源(图表、表格、参考文献)放在论文目录中
- 使用高质量图表:采用矢量格式(PDF、SVG)或高分辨率光栅图(300+ DPI)
- 保持 LaTeX 整洁:移除编译产物,并确保源文件可以成功编译
模型选择策略
- GPT-4:适用于生产级输出、会议和出版物
- GPT-4.1:需要最新功能或尽可能高的质量时使用
- GPT-3.5-turbo:用于快速起草、测试或简单论文
组件优先级
时间紧迫时,按以下顺序生成:
- 网站(最快、用途最广,约 15-30 分钟)
- 海报(速度适中,适合印刷截止时间,约 10-20 分钟)
- 视频(最慢,可稍后生成,约 20-60 分钟)
质量保证
完成输出前:
- 网站:在多种设备上测试,确认所有链接均有效,并检查图表质量
- 海报:打印测试页,确认文字在 3-6 英尺距离外清晰可读,并检查颜色
- 视频:完整观看视频,确认音画同步,并在不同设备上测试
资源需求
处理时间
- 网站:每篇论文 15-30 分钟
- 海报:每篇论文 10-20 分钟
- 视频(无虚拟讲解员):每篇论文 20-60 分钟
- 视频(有虚拟讲解员):每篇论文 60-120 分钟
计算资源需求
- CPU:用于并行处理的多核处理器
- RAM:至少 16GB;大型论文推荐 32GB
- GPU:标准输出可选;虚拟讲解员必需(NVIDIA A6000 48GB)
- 存储空间:每篇论文 1-5GB,视组件和质量设置而定
API 费用(约)
- 网站:每篇论文 $0.50-2.00(GPT-4)
- 海报:每篇论文 $0.30-1.00(GPT-4)
- 视频:每篇论文 $1.00-3.00(GPT-4)
- 完整套件:每篇论文 $2.00-6.00(GPT-4)
故障排除
常见问题
LaTeX 解析错误:
- 确保 LaTeX 源文件可以成功编译:
pdflatex main.tex - 检查所有引用的文件是否存在
- 确认没有自定义软件包阻止解析
图表质量不佳:
- 使用矢量格式(PDF、SVG、EPS),而非栅格格式
- 确保栅格图像的分辨率达到 300 DPI 以上
- 检查图表在编译后的 PDF 中是否正确呈现
视频生成失败:
- 确认磁盘空间充足(建议至少 5GB)
- 检查是否已安装所有依赖项(LibreOffice、Poppler)
- 查看输出目录中的错误日志
海报排版问题:
- 确认海报尺寸合理(24"-72" 范围)
- 检查内容长度(篇幅很长的论文可能需要手动筛选)
- 确保图表的分辨率适合海报尺寸
API 错误:
- 确认
.env文件中的 API 密钥 - 检查 API 额度余额
- 确认未触发速率限制(等待后重试)
平台专属功能
社交媒体优化
系统会自动检测目标平台:
Twitter/X(英文、数字文件夹名称):
mkdir -p input/001_twitter/
# Generates English promotional content
小红书/小红书(中文、字母数字组合的文件夹名称):
mkdir -p input/xhs_paper/
# Generates Chinese promotional content
会议专属格式
指定会议要求:
- 标准海报尺寸(4'×3'、5'×4'、A0、A1)
- 视频摘要时长限制(通常为 3-5 分钟)
- 机构品牌要求
- 配色方案偏好
集成与部署
网站部署
将生成的网站部署到:
- GitHub Pages:免费托管并支持自定义域名
- 学术托管平台:大学 Web 服务器
- 个人服务器:AWS、DigitalOcean 等
- Netlify/Vercel:支持 CI/CD 的现代托管平台
海报打印
可用于打印的文件适用于:
- 专业海报打印服务
- 大学打印店
- 在线服务(例如 Spoonflower、VistaPrint)
- 大幅面打印机(如有)
视频分发
在以下平台分享视频:
- YouTube:公开或不公开,最大限度地扩大覆盖面
- 机构知识库:大学视频平台
- 会议平台:虚拟会议系统
- 社交媒体:Twitter、LinkedIn、ResearchGate
高级用法
批量处理
高效处理多篇论文:
# Organize papers in batch directory
for paper in paper1 paper2 paper3; do
python pipeline_all.py \
--input-dir input/$paper \
--output-dir output/$paper \
--model-choice 1 &
done
wait
自定义品牌
应用机构或实验室的品牌元素:
- 在论文目录中提供徽标文件
- 在配置中指定配色方案
- 使用自定义模板(高级)
- 匹配会议主题要求
多语言支持
生成不同语言的内容:
- 在配置中指定目标语言
- 系统会相应地翻译内容
- 为视频旁白选择合适的语音
- 根据文化调整设计惯例
参考资料
此技能包含全面的参考文档:
references/installation.md:完整的安装与配置指南references/paper2web.md:Paper2Web 详细文档,涵盖所有功能references/paper2video.md:全面的 Paper2Video 指南,包括真人出镜视频设置references/paper2poster.md:Paper2Poster 完整文档,包含设计模板references/usage_examples.md:实际案例与工作流模式
外部资源:
- GitHub 仓库:https://github.com/YuhangChen1/Paper2All
- 精选数据集:可在 Hugging Face 上获取(涵盖 13 个研究类别)
- 基准测试套件:参考网站与评估指标
评估与质量指标
Paper2All 系统包含内置的质量评估功能:
内容质量
- 完整性:对论文内容的覆盖程度
- 准确性:对研究结果的忠实呈现
- 清晰度:易于理解和获取
- 信息量:关键信息的突出程度
设计质量
- 美观度:视觉吸引力与专业性
- 布局:平衡性、层次结构与组织
- 可读性:文本易读性与图表清晰度
- 一致性:统一的样式与品牌元素
技术质量
- 性能:加载时间、响应速度
- 兼容性:跨浏览器、跨设备支持
- 无障碍性:符合 WCAG 标准,支持屏幕阅读器
- 标准:有效的 HTML/CSS、适合打印的 PDF
所有输出在生成完成前都会经过自动化质量检查。