mcpField
P
paper-2-web

paper-2-web

github.com/jackspace文档处理1641 次安装12 周前更新
代码仓库

关于 paper-2-web

paper-2-web 是一项将学术论文转为网站、演示视频和会议海报的技能,适用于准备展示与传播研究成果的研究人员。

主要功能

  1. 01生成交互式学术网站
  2. 02制作带旁白的演示视频
  3. 03生成可打印会议海报
  4. 04自定义布局与尺寸
  5. 05批量处理多篇论文

适用场景

  1. 01为论文创建配套网站
  2. 02准备会议海报
  3. 03制作视频摘要或报告
  4. 04为多篇论文生成材料

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jackspace/claudeskillz --skill paper-2-web

安装后在 Claude Code 中输入/paper-2-web确认已加载。

附带文件SKILL.json

详细介绍

Paper2All:学术论文转换流程

概述

此技能可通过 Paper2All 自主流程,将学术论文转换为多种宣传和演示格式。该系统可将研究论文(LaTeX 或 PDF)转换为三种主要输出:

  1. Paper2Web:具有布局感知设计、可交互探索的学术主页
  2. Paper2Video:专业演示视频,包含旁白、幻灯片和可选的真人出镜视频
  3. 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


快速开始

前置条件
  1. 安装 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
    
  2. 配置 API 密钥(创建 .env 文件):

    OPENAI_API_KEY=your_openai_api_key_here
    # Optional: GOOGLE_API_KEY and GOOGLE_CSE_ID for logo search
    
  3. 安装系统依赖:

    • 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/

最佳实践

输入准备
  1. 尽可能使用 LaTeX:可获得最佳的内容提取效果和结构
  2. 妥善组织文件:将所有资源(图表、表格、参考文献)放在论文目录中
  3. 使用高质量图表:采用矢量格式(PDF、SVG)或高分辨率光栅图(300+ DPI)
  4. 保持 LaTeX 整洁:移除编译产物,并确保源文件可以成功编译
模型选择策略
  • GPT-4:适用于生产级输出、会议和出版物
  • GPT-4.1:需要最新功能或尽可能高的质量时使用
  • GPT-3.5-turbo:用于快速起草、测试或简单论文
组件优先级

时间紧迫时,按以下顺序生成:

  1. 网站(最快、用途最广,约 15-30 分钟)
  2. 海报(速度适中,适合印刷截止时间,约 10-20 分钟)
  3. 视频(最慢,可稍后生成,约 20-60 分钟)
质量保证

完成输出前:

  1. 网站:在多种设备上测试,确认所有链接均有效,并检查图表质量
  2. 海报:打印测试页,确认文字在 3-6 英尺距离外清晰可读,并检查颜色
  3. 视频:完整观看视频,确认音画同步,并在不同设备上测试

资源需求

处理时间
  • 网站:每篇论文 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:实际案例与工作流模式

外部资源:

评估与质量指标

Paper2All 系统包含内置的质量评估功能:

内容质量
  • 完整性:对论文内容的覆盖程度
  • 准确性:对研究结果的忠实呈现
  • 清晰度:易于理解和获取
  • 信息量:关键信息的突出程度
设计质量
  • 美观度:视觉吸引力与专业性
  • 布局:平衡性、层次结构与组织
  • 可读性:文本易读性与图表清晰度
  • 一致性:统一的样式与品牌元素
技术质量
  • 性能:加载时间、响应速度
  • 兼容性:跨浏览器、跨设备支持
  • 无障碍性:符合 WCAG 标准,支持屏幕阅读器
  • 标准:有效的 HTML/CSS、适合打印的 PDF

所有输出在生成完成前都会经过自动化质量检查。

评论

支持 Markdown