整体站点结构与样式参考了 PaperCache,基于 Jekyll + GitHub Pages 搭建,用于个人记录 AI / ML 论文阅读笔记。
-
确保本机已安装 Ruby(推荐 3.x):
ruby -v
-
在项目根目录安装依赖:
bundle install
-
启动本地预览:
bundle exec jekyll serve --livereload默认访问:
http://127.0.0.1:4000
在 _posts 目录下新建形如 YYYY-MM-DD-slug.md 的文件,例如:
2025-02-01-gpt4-technical-report.md推荐的 Front Matter 模板:
---
layout: post
title: "你的笔记标题(中文)"
paper_title: "论文原文标题(英文)"
paper_authors: "作者列表"
venue: "会议 / 期刊"
year: 2024
paper_url: "https://arxiv.org/abs/xxxx.xxxxx"
category_id: llm # llm / diffusion / systems / theory / others
tags:
- LLM
- Prompting
thumb: "https://你的配图地址" # 可选
---正文部分可以参考示例文章 _posts/2025-01-01-example-llm-paper.md 的结构:TL;DR → 问题与动机 → 方法拆解 → 实验 → 个人评价 → 和实际工作的连接。
- GitHub Pages:
- 将本仓库推送到 GitHub,仓库设置中开启 Pages,选择
GitHub Actions或gh-pages分支。 - 可以直接参考 PaperCache 的部署方式:
papercache.vercel.app以及shenh10.github.io/papercache的做法见其 README 说明https://github.com/shenh10/papercache。
- 将本仓库推送到 GitHub,仓库设置中开启 Pages,选择
- Vercel:
- 使用 Vercel 连接 GitHub 仓库,选择静态输出目录为
_site即可。
- 使用 Vercel 连接 GitHub 仓库,选择静态输出目录为